pr

za:pr — プルリクエストを作成

作業ブランチの変更を、プロジェクトのルールに沿った GitHub プルリクエスト（PR）として 作成する。狙いは、git 履歴から「何を・なぜ変えたか」を正確に拾い、レビューしやすい PR に まとめること。

PR は外部に作成されるので、作成前に内容をユーザーに提示して承認を得る（後述）。 下の手順を順番に実行する。

手順

1. ブランチと作成先を確認する

• 現在のブランチを確認する（git branch --show-current）。base となるデフォルトブランチ （main 等）を確認する（gh repo view --json defaultBranchRef -q .defaultBranchRef.name）。
• 現在ブランチが base そのものの場合は PR を作れない。その旨を伝え、作業ブランチに 切り替えるか作るよう促す。
• リモートや gh が使えず取得できない場合も、その旨を伝えて確認する（勝手に別リポジトリへ 作らない）。

2. 変更内容を git 履歴から確認する

base との差分から、PR に書く内容を把握する。

• コミット履歴: git log <base>..HEAD --oneline（各コミットの意図を読む）
• 変更ファイル: git diff <base>...HEAD --stat、必要なら本文の diff も確認
• 関連 issue を拾う: コミットメッセージ中の #番号、ブランチ名（例 feature/42-add-login の 42）。PR 本文で Closes #番号 として紐づけられるようにする。
• base より先行するコミットが無い場合は、PR にする変更が無い。その旨を報告して止まる。

3. ブランチをリモートへ push する

PR 作成にはリモートに head ブランチが必要。未 push、またはローカルが先行している場合は git push -u origin <ブランチ> で push する（既に追跡済みなら git push）。

4. PR 作成ルールを読む

docs/PR.md を読む。これはこのプロジェクトでのPR のタイトル規約・本文テンプレート・ ラベル・レビュアー指定などのルール。PR は必ずこれに従う（プロジェクトが書式の所有者で あり、こちらが我流を持ち込まない）。

• 無い場合: 「docs/PR.md が無いため標準の書式で作成します」と伝え、末尾の **「デフォルトの PR 書式」**を使う。

5. ユーザーに提示して承認を得る

作成予定の PR を提示する。最低限:

• タイトル
• base ← head（どのブランチへ取り込むか）
• 本文の要点（数行）／関連 issue
• ラベル・レビュアー（ルールにあれば）

「この内容で作成してよいか」を確認する。指摘があれば直してから次へ。 （ユーザーが事前に「確認不要、そのまま作成」と明示している場合は省いてよい。）

6. PR を作成する

承認後、gh pr create で作成する。本文は日本語・複数行を安全に渡すため、一時ファイルに 書いて --body-file で渡す（またはヒアドキュメントで --body-file -）。

gh pr create --base <base> --title "<タイトル>" --body-file <本文ファイル> \
  --label "<ラベル>" --reviewer "<handle>"   # ルールにあれば
# 下書きにしたい場合は --draft

• 既に同じブランチの PR が存在する場合、gh pr create は失敗する。その時は新規作成せず、 既存 PR（gh pr view --web 等）を案内する。

7. 完了報告

作成した PR の URL を報告する。タイトル・base←head・紐づけた issue も併せて伝える。

---

デフォルトの PR 書式

docs/PR.md が存在しない場合に使う標準テンプレート。

## 概要
{何を・なぜ変更したか}

## 変更内容
- {主な変更点を箇条書きで}

## 関連 issue
- Closes #{番号}   （関連 issue があれば。無ければこの節は省く）

## 確認事項
- [ ] {動作確認・テスト結果など}