| name | create-pr |
| description | 現在の branch から GitHub pull request を作成し、公開に必要な最小限の `git` と `gh` 操作だけに作業範囲を限定すべきときに使う。 |
Create PR
概要
現在の branch を、範囲を絞った GitHub pull request にする。git と gh だけを使い、branch を公開するために必要な作業だけを行う。完了までの許可された経路は git add、git commit、git push、gh pr create とする。
ガードレール
git と gh だけを使う。- タスク範囲を PR 作成に限定する。tests、refactors、formatting passes、dependency changes、無関係な cleanup は実行しない。
- PR 公開に必要な場合は、
git add、git commit、git push を許可する。
- ユーザーが明示的に依頼しない限り、既存履歴の書き換え、branch の restack、無関係なローカル作業の整理はしない。
- ローカル変更の扱いが曖昧な場合は、気を利かせようとせず、止まって確認する。
ワークフロー
- 現在の Git context を読む。
- branch 名と tracking branch
- staged、unstaged、untracked 変更
- remote の有無と
gh の有無
- base branch を決める。
- まず
git config branch.<current-branch>.base を確認し、設定されている場合は優先する。
main、master、develop などの有力候補を比較する。- merge-base と fork-point の証拠を優先する。
- upstream と最近の branch context は補助的な signal としてだけ使う。
- 強い候補が 1 つに絞れない場合だけユーザーに確認する。
- 未コミット変更を確認する。
- この PR に明らかに属する作業だけを含める。
- 無関係なローカル変更は触らず残す。
- 境界が曖昧な場合は止まってユーザーに確認する。
- 必要な commit を作る。
- この PR に明らかに属する変更にだけ
git add を使う。
- 既存履歴を保つ。
- branch 公開に必要な新規 commit だけを追加する。
- commit cleanup より、必要最小限の commit 作業を優先する。
base...HEAD を要約し、branch の主目的を特定する。- PR metadata を生成する。
- repository の PR template があれば合わせる。
- なければ
## Summary と ## Testing を持つ簡潔な body にする。
- 必要なら upstream を設定しつつ、現在の branch を push する。
gh pr create を実行する。- 選択した base branch、新規 commit の有無、PR title、PR URL を含む簡潔な結果 summary を返す。
判断ルール
Base Branch
git config branch.<current-branch>.base が存在する場合は優先する。- 一般的な integration branch との merge-base と fork-point 関係を優先する。
- 設定済み upstream や remote default branch は、その証拠が commit graph と一致する場合だけ使う。
- 最近の branch history や naming は primary proof ではなく tie-breaker として扱う。
- 複数候補が同程度に妥当なまま残る場合はユーザーに確認する。
未コミット変更
- 何かを commit する前に、staged、unstaged、untracked 変更を確認する。
- ファイル状態だけでなく、branch の目的に基づいて判断する。
- PR に明らかに属する変更を含める。
- 無関係な変更は working tree に残す。
- ある変更がこの PR に属する可能性も別 follow-up に属する可能性もある場合は、ユーザーに確認する。
Commit 作成
- この PR に明らかに属する変更だけを
git add する。
- 現在の branch history を保つ。
- PR-ready な履歴に必要な新規 commit だけを追加する。
- 実用的な commit message を生成し、不要な commit 分割は避ける。
- ユーザーが別途 history cleanup を依頼しない限り、過去 commit を書き換えない。
Scope Discipline
- Git state を確認し、関連変更を add し、必要なら commit し、push して PR を作成する狭い経路に留まる。
- 役に立ちそうというだけで追加の repository maintenance をしない。
- タスクを validation、cleanup、follow-up implementation work に広げない。
停止条件
次のいずれかに該当する場合は停止し、blocker を説明する。
- detached
HEAD
- push に適した remote がない
gh が利用できない- 権限、認証、remote state により push が失敗する
- base branch の推定が曖昧なまま残る
- ローカル変更に、安全に推定できない曖昧な scope が含まれている
title と body を生成した後に PR 作成が失敗した場合は、選択した base branch、生成した title、生成した body、次に手動で実行する command を返す。
