| name | create-pr |
| description | GitHub Pull Request を作成するときに使う。ユーザーが PR を作りたい、PR本文やタイトルのドラフトを差分から作りたい、既存の PR テンプレートに沿って内容を埋めたいと言ったときに適用する。実行時に新規ブランチや add/commit が必要な場合もこのスキル内で行う。カレントが main または release/* または epic/* のときは、新規ブランチを作る必要があるか必ずユーザーに聞く。それ以外は普段は質問せず、必要ならブランチ作成・コミット・プッシュしてから PR を作成する。ベースブランチは origin のリモートブランチから候補を推定してユーザー確認を取る。 |
| compatibility | Requires gh CLI or GitHub MCP, git, and access to the internet. The target directory must be a git repository. コミットメッセージ生成には create-commit スキル（同一プラグイン内 skills/create-commit）を利用する。 |
| license | Apache-2.0 |
Create a GitHub Pull Request
前提条件
- GitHub CLI か GitHub MCP が使えること。
gh --version が成功したら GitHub CLI を使い、使えない場合は GitHub MCP を使用する。両方使えなければ停止する。- GitHub CLIを使う場合、認証されていることを確認するために
gh auth status を実行する。認証されていない場合はそのまま続行せず、ユーザーに gh auth login を実行するように依頼する。（そして gh auth status を再実行する）
- この skill 内で示す相対パスは
SKILL.md がある skill ディレクトリ基準で解決する。
ワークフロー
0. 事前準備（ブランチ・コミット）
PR 作成前に、必要なら新規ブランチの作成と未コミット変更のコミットを行う。
-
状態確認
git status
git branch --show-current
-
main / release/ / epic/ にいる場合**
カレントブランチが main または release/* または epic/* のときは、必ずユーザーに「新規ブランチを作成しますか？」と聞く。ユーザーへの質問ツールが使える場合は必ずそれを使う。
- Yes の場合: 変更内容（
git diff / git diff --cached）から create-branch と同様のプレフィックス規則（feat/fix/release/epic）でブランチ名を提案する。既存ブランチと重複しない場合は確認を取らず git checkout -b <ブランチ名> を実行する。重複する場合は、別名候補（例: サフィックス付き）を決め、その候補をユーザーに提示し「この名前で作成してよいですか？」と必ず確認する。ユーザーが承認した場合のみ git checkout -b <承認された名前> を実行する。重複時に別名を確認なしで自動採用して checkout してはならない。
- No の場合: そのまま次へ（main/release/epic から直接 PR する想定）。
-
未コミットの変更がある場合
普段は質問せず、create-commit スキル（plugins/scg-ai-playbook/skills/create-commit）のワークフローに従ってコミットする。
- create-commit の手順（変更把握・グループ化）:
git status / git diff / git diff --cached で変更を把握し、変更を意味的なグループに分類する（複数目的が混在する場合は複数コミットに分ける想定）。
- 安全ガード: 次のいずれかに該当する場合は、自動で
git add / git commit を行わず、ユーザー確認を必須とする。
- 複数意図の変更検出: グループ化の結果、複数グループ（2 以上）が生成された場合。
- 機微ファイルの検出: 変更に含まれるパス・ファイル名が、
secret、.env、credentials、key、password、token、.pem、.key など機微とみなせるパターンにマッチする場合。
- 該当する場合の確認プロンプトでは、どのファイル・どのグループが該当したかを明示する。続行するときは、create-commit のコミットメッセージフォーマット（prefix: 概要、why:、what:）で各コミット案を提示し、ユーザーの承認を得たうえで
git add / git commit を実行する。
- 上記のいずれにも該当しない場合（単一グループかつ機微ファイルなし）は、確認を取らずにグループごとにステージ・メッセージ生成・
git commit を実行してよい。コミットメッセージは create-commit のフォーマットに従う。ユーザーにコミットメッセージの確認を取る必要はない（依頼があれば確認する）。
-
以上のあと、ステップ 1 に進む。
1. ユーザーへの確認
作業開始時はカレントブランチとベースブランチ候補を確認し、必要事項をユーザーに確認する。ユーザーへの質問ツールが使える場合は必ずそれを使う。
git branch --show-current
git branch -a
bash <skill-dir>/scripts/estimate-base-branches.sh
2. Gitの状態を確認
以下を実行して状態を確認する。
git status
git branch --show-current
git log <base-branch>..HEAD --oneline
git diff <base-branch> --stat
git remote get-url origin
- 未コミットの変更が残っていれば、ステップ 0 に戻るか停止する（通常はステップ 0 でコミット済み）。
git log <base-branch>..HEAD --oneline が空なら停止する。git diff <base-branch> --stat が空なら停止する。origin が取得できなければ停止する。- ブランチが未 push なら
git push -u origin <branch> を実行し、失敗したら停止する。
3. PRテンプレート選択と本文生成
GitHub のサポート対象に合わせて、次の手順でPR本文のテンプレートを選び、本文を生成する。
-
以下のコマンドを実行してリポジトリ内のPRテンプレートファイルを一覧する。
git ls-files --cached --others --exclude-standard | rg -i '^((docs|\.github)/)?pull_request_template(\.[^/]+|/.+)?$' || echo "No Pull Request templates found"
-
テンプレートを選ぶ。
- リポジトリ固有のテンプレートが見つかったらそれを採用する。
- 複数テンプレート用ディレクトリしか見つからない場合は、ユーザー指定のテンプレート名を優先する。
- 複数のテンプレート候補があり、ユーザー指定も推測材料もない場合は、候補一覧を示して選択を確認してから進める。
- リポジトリ固有のテンプレートが見つからなければ
references/default-pr-template.md を使う。
-
本文を生成する。
- 選んだテンプレートの見出し、順序、HTMLコメント、チェックリストを維持する。
- テンプレート項目のうち自動推測できないものだけを追加確認する。
- PRタイトルは Conventional Commits 形式で作り、
type、scope、summary は差分とコミット履歴から総合的に決定する。単一の scope に絞れない場合は type: summary を使う。
- 本文はテンプレートの各項目を実際の差分とコミット履歴に基づいて埋め、影響範囲は
git diff <base-branch> --stat をもとに整理する。
4. プレビュー
- タイトルと本文をユーザーに提示する。
- 修正依頼があれば反映してから作成に進む。
5. PR作成
- push 済みかつ差分とコミットがある状態でのみ次に進む。
gh CLI を使う場合は gh pr create を実行する。gh が使えない場合は GitHub MCP の PR 作成機能を使う。- 作成後にPRのURLを共有する。
作業時のルール
- ステップ 0 を常に最初に実行する。新規ブランチが必要な場合・未コミットの変更がある場合もここで対応する。main / release/* / epic/* のときだけ「新規ブランチを作成しますか？」と必ず聞く。それ以外のブランチでは質問せず、未コミットがあればそのまま add/commit する。
- ユーザーへの確認が必要な時、ユーザーに質問をするためのツール（AskQuestion/AskUserQuestionなど）が使える場合は優先して使用する。ユーザーに質問をするためのツールが利用できない場合はチャットで質問する。
<skill-dir>/scripts/estimate-base-branches.sh の出力は新しい共通祖先日時順の候補一覧として扱い、上位数件だけを要約して見せる。- 推定スクリプトは
committerdate が新しいリモートブランチから順に確認する想定で、必要なら ESTIMATE_BASE_BRANCHES_MAX_CANDIDATES で確認件数を調整してよい。
