Create a GitHub Pull Request Skill

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

<skill-dir>/scripts/estimate-base-branches.sh が存在する場合は必ず実行し、出力された上位候補をベースブランチ確認の材料にする。
推定結果は参考情報として扱い、ベースブランチはユーザーに最終確認する。
ベースブランチ: PRのマージ先ブランチ
- 上位候補を優先して提示する。
- 候補が弱い場合だけ main を既定候補として提示する。必要なら git branch -a や推定結果の詳細は内部判断に使う。
- 候補が得られた場合は、表示可能な件数の範囲で上位候補をブランチ名だけ見せる。
チケットIDまたは関連リンク

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 で確認件数を調整してよい。

Agent Skills: Create a GitHub Pull Request

Install this agent skill to your local

Skill Files