| name | create-pr |
| description | 現在のブランチから GitHub CLI (gh) で Pull Request を作成する。デフォルトは Draft PR。ユーザーが「PR 作成して」「create-pr」などと言ったら起動する。現在のブランチがベースブランチ（e.g., main/master）なら、PR作成用のブランチを選択/作成してから進める。 |
| allowed-tools | Bash(git:*) Bash(gh:*) |
Create PR（汎用版 / Draft デフォルト）
概要
現在のブランチの変更内容をもとに、Draft PR をデフォルトとして gh pr create で Pull Request を作成する。
PR タイトルは差分・コミットから推定し、PR 本文は ** PR Template が存在する場合はそれを優先**して生成する。
- Draft PR:
gh pr create --draft
- ラベル付与:
gh pr create --label ...（作成と同時に付与）
ワークフロー
0) 前提確認（gh / git）
gh と git が利用できる前提で進める。gh 認証が必要な場合は gh auth login を案内して中断する。
1) ベースブランチ（既定ブランチ）と現在ブランチの確認
- 現在ブランチを取得:
git rev-parse --abbrev-ref HEAD
- ベースブランチ（既定ブランチ）を推定（優先順）:
gh repo view --json defaultBranchRef -q .defaultBranchRef.name- 失敗したら
origin/HEAD:
git symbolic-ref refs/remotes/origin/HEAD（末尾ブランチ名を使用）
- それも無理なら
main を仮定（仮定した旨を明示）
- 現在ブランチがベースブランチと同一なら、PR 作成用ブランチをユーザーに確認（ここだけ質問可）:
- 既存ブランチへ移動、または
- ベースブランチから新規ブランチを作成（コミットが存在してから続行）
2) 変更内容の収集（タイトル/本文の根拠）
- コミット・差分を確認（例）:
git log --oneline --decorate -n 30- 追加文脈が必要なら:
git log --format=fuller -n 30
- 変更ファイル一覧:
git diff --name-only origin/<base>...HEAD（失敗時は <base>...HEAD）
- 主要な変更（dominant change）を抽出し、簡潔な PR タイトルを推定する。
3) 未コミット変更の確認
git status --short を確認。- 未コミット変更がある場合:
- ユーザーに「この未コミット変更をコミットして PR に含めるか」を確認する。
- コミットする場合:
git add → git commit -m "<message>" を行って続行。
- コミットしない場合: コミット済み差分のみで PR を作る。
- 最終確認で「未コミット変更は含まれない」ことを明示。
- 無ければ続行。
4) PR 本文テンプレート生成
- テンプレート探索（優先順）:
.github/pull_request_template.md.github/PULL_REQUEST_TEMPLATE.mdPULL_REQUEST_TEMPLATE.md
- 見つかったテンプレートは、その構造を保ったまま、差分・コミットから具体的に埋める。
- 見つからない場合は、以下のシンプルな汎用テンプレートを使用する。
汎用テンプレート
## Description
### What
<!-- どのような変更を行ったかを記載する -->
### Why
<!-- なぜこの変更が必要かを記載する -->
### How
<!-- [Optional] どのように実装したかを記載する -->
## Reference
<!-- [Optional] 関連資料（設計書・仕様・リンクなど）があれば記載する -->
方針:
- 不明な箇所は空欄のまま残し、ユーザー修正で埋められる状態にする
- 任意セクションは削らず残す（空でもOK）
5) ラベル指定（任意）を組み込む
- PR に付与したいラベルが 明示されている場合のみ採用する。
- 明示が無い場合は ラベル無し（=
--label を付けない）で進める。
6) 最終ドラフト提示（実行前）
- 次をユーザーに提示:
- ベースブランチ:
<base>
- head ブランチ:
<branch>
- Draft で作成する（固定）
- 付与ラベル（あれば）
- PR タイトル（推定）
- PR 本文（全文）
- 未コミット変更の扱い（あれば）
- 番号選択のみで確認:
1. この内容で実行する（Draft PR を作成）2. タイトル/本文/ラベルを修正する
2 の場合は修正指示を受けて更新し、再度 1/2 で確認。1 まで gh pr create は実行しない。
7) Draft PR の作成（gh）
- 同一 head ブランチの open PR が既にあるか確認:
gh pr list --head <branch> --state open
- 既に存在する場合:
- 新規作成せず、既存 PR URL を提示して終了。
- 存在しない場合:
- 本文を一時ファイルへ書き出し（崩れ防止）。
- 実行（Draft 固定）:
gh pr create --draft -B <base> -H <branch> -t "<title>" -F <body_file> [--label "<labels>"]
- 作成された PR URL を提示する。
gh pr create が「No commits between base and head」等で失敗した場合:
git push -u origin <branch> を案内または実行し、再度 gh pr create を試行する。- pre-push hook で失敗した場合は「差分確認 -> add/commit -> push 再試行」をガイドする。
注意事項
- ベースとの差分が無い（コミットが無い）場合は PR 作成不可なので中断してコミットを促す。
--label で指定したラベルがリポジトリに存在しない場合、エラーになり得る（その場合は既存ラベルの一覧確認や作成が必要）。--fill を使う運用にしたい場合、コミットメッセージにカンマがあるとタイトル/本文が意図せず分割される報告があるため注意。
