create-pr reference

create-pr は PR 作成時に必ず使う入口である。 gh pr create --fill は使わず、diff とコミット履歴から reviewer が判断するための背景、判断、期待状態を本文に書いてから PR を作成する。

Entry Conditions

次の依頼では create-pr を使う。

Draft PR では --draft を付ける。通常 PR / Draft PR のどちらでも self-assignee を設定し、作成後に assignee を確認する。

PR Writing

PR 本文はファイルや commit の要約ではなく、次を短く伝える。

repo の .github/pull_request_template.md がある場合はその構造に従う。 ただし「主な変更」のような見出しでも、単なる変更ファイル一覧ではなく reviewer が判断するための文脈を書く。 GitHub に投稿する PR 本文では inline code に <code>...</code> を使い、heredoc delimiter と衝突する行を本文に入れない。

pr-writing-review

pr-writing-review=auto|codex|claude|copilot|off は PR 本文 reviewer gate の指定である。 Issue validation の agent= や multi-review の agents= とは別物として扱う。

指定 意味
auto default。現在 runtime の規則に従って本文 reviewer を選ぶ
codex / claude / copilot 指定 reviewer だけを使う
off reviewer gate を明示的に skip する

reviewer gate は生成済みタイトルと本文を検査するだけで、本文の新規作成や GitHub 投稿はしない。 判定が proceed の場合だけ PR 作成へ進む。revise は妥当な指摘を反映して再レビューし、stop や reviewer unavailable は PR 作成前に止める。

Creation Command

PR 作成は gh pr create --assignee @me --body-file - と single-quoted heredoc で行う。 --body "$(cat ...)"、未クォート heredoc、複数行 body の直接 inline 渡しは使わない。 作成後は gh pr view "$pr_url" --json assignees で viewer が assignee に含まれることを確認する。

Examples

pr=create
pr=draft

実際の実行では push、gh pr create --body-file -、PR URL 取得、assignee 検証までを一つの shell block にまとめる。