pr-create

name	pr-create
description	Pull Request / Merge Request を作成するときに必ず参照する。`gh pr create`/`glab mr create` で PR/MR を作る、コミット済みの作業をレビューに出す、並列・stacked 作業の各ブランチで PR を起こす、といった場面で使う。リポジトリの pull_request_template/merge_request_template を決定論スクリプトで検出して優先し、テンプレの骨組み（見出し・チェックリスト・順序）を改変せず入力箇所を埋めるだけにする（作成前に骨組み照合ゲートで機械検証）。無ければ汎用観点で本文を構成。作成前に diff-review でのセルフレビュー反復（must ゼロまで）を必須とし、証跡を hook が検査する。本文の素材は対象リポジトリの git 差分のみに限定し、他リポジトリ・他タスクの内容を混入させない。draft 既定・作成前にユーザー承認。未 push のときは AskUserQuestion で承認を取ってから push。GitHub(gh) 基本、GitLab(glab) 等にも対応。
user-invocable	true
argument-hint	[ベースブランチ名や追加指示（任意）]

PR 作成

リポジトリ固有の PR テンプレートに沿った PR を写経なしで作成する。テンプレートが無くても汎用観点で過不足ない PR を作る。モデルが PR 作成を要する場面で自動的に参照してよく、/pr-create の明示実行でも動く。

制約（厳守）

• push は無断で行わない。未 push を検出しても勝手に push せず、作成直前に AskUserQuestion で push 可否の承認を取る（要点・選択肢は本文にも記載。§7）。承認されれば push してよい。拒否ならユーザーに委ねて停止。
• 作成は draft が既定。「通常 PR で」の指示時のみ非 draft。
• 作成前に必ずタイトルと本文を提示しユーザー承認を得てから 作成コマンドを実行する。
• 対象リポジトリの取り違え・文脈混入を禁止。本文・タイトルは scripts/pr-context.sh が出すこの作業ディレクトリの git 状態（REPO IDENTITY / COMMITS / DIFF）だけを根拠にする。会話履歴に残る別リポジトリ・別タスクの内容を PR 本文へ持ち込まない。スクリプトの REPO IDENTITY（repo slug / worktree-root）が、PR を作ろうとしている対象と一致することを作成前に必ず確認する。
• テンプレートは確定フォーム。骨組みを改変しない。TEMPLATE が primary/選択 multi を返したら、見出し・チェックリスト・順序を逐語で保ち、入力箇所を埋めるだけ（§4）。独自フォーマットへの差し替え・セクションの削除/追加/並べ替え・見出しの言い換えは禁止。作成前に scripts/template-check.sh の骨組み照合ゲート（§5）を必ず通す。
• 作成前に必ずセルフレビュー反復（§1.5）を通す。diff-review の must 指摘がゼロになるまで修正→コミット→再レビューを繰り返す。骨組み照合・ユーザー承認と同列の通過必須ゲートで、未通過のままの gh pr create は hook にブロックされる。
• PR本文にセッションURLを含めない。Claude Code の既定動作は本文末尾にセッションへのリンクを付与するが、このリポジトリでは付与しない。ローカル CLI・remote-control のどちらのセッションでも同様。

ワークフロー

1. コンテキスト収集（スクリプト）

プラットフォーム判定・ベース特定・差分・push 状態は決定論的に行えるため scripts/pr-context.sh を実行する。手で git コマンドを並べ直さない。<skill-dir> はこのファイルのあるディレクトリ。

bash <skill-dir>/scripts/pr-context.sh [base-branch]

=== SECTION === 区切りの出力を読む:

• REPO IDENTITY = 対象リポジトリの repo slug と worktree-root。本文を起こす前にここを確認し、いま PR を作ろうとしている対象と一致することを担保する（制約「対象リポジトリの取り違え禁止」）。
• PLATFORM = remote URL から判定したプラットフォームと使用 CLI・導入有無。github→gh、gitlab→glab、unknown/installed: no → 本文を提示して手動作成を案内。コマンド詳細は references/platforms.md。
• TEMPLATE = リポジトリルートから決定論検出したテンプレ。primary: が出たらそれを使う（独自フォーマット禁止）。multi: は複数テンプレなので候補提示して選んでもらう。(テンプレートなし) のときだけ §4 の汎用構成。ここで primary が出ているのに自前の見出しで書くのは規約違反。
• BASE BRANCH = リモート既定ブランチではなく、作業ブランチの分岐元をローカル探索した結果。(特定できませんでした) や誤検出が疑わしいときは引数 base-branch を渡して再実行、またはユーザーに確認。
• COMMITS / COMMIT MESSAGES = 本文の主素材。
• DIFF STAT / CHANGED FILES = 変更範囲。完全差分が要れば末尾の git diff <base>...HEAD を別途実行。
• CI WORKFLOWS = CI workflow ファイルの一覧と、差分に含まれるファイル拡張子の集合。ローカルで回した検証ゲートは CI 全 workflow の部分集合でしかない(ローカルの主要ゲートが全緑のまま、別 workflow の fmt/lint/docs ジョブが赤で本流を割るのが定番の事故)。差分のファイル種別に反応する workflow を突き合わせ、ローカル未実行のジョブがあれば PR 前に実行するか、実行できない理由と「未検証」の旨を本文に明記する。CI がツールのバージョンを pin している場合(lockfile・setup アクションの version 指定)、ローカル版とのバージョン照合もここで行う — フォーマッタ等の skew は「ローカル緑・CI 赤」の典型原因で、pin と違う版の整形差分をコミットすると CI が全拒否する。
• UPSTREAM / PUSH STATUS に WARNING（未 push／未 push コミットあり）が出たら記録しておき、§7 の作成直前に AskUserQuestion で push 可否の承認を取る（承認されれば push、拒否なら停止）。ここで自動 push はしない。

1.5 セルフレビュー反復（作成前ゲート）

本文を書く前に、差分そのものを diff-review スキルでセルフレビューし、must 指摘ゼロの状態にする。

1. 未コミットの差分があれば先に確定（コミット）してから始める。レビュー対象はコミット済み差分。
2. diff-review スキルを実行する。レンズは既定（design, test）に加えて spec・fresh-eyes を必須で含め、差分の性質に応じて security / ops / compat / performance / concurrency を追加する。
3. must 指摘が出たら: 修正 → コミット → diff-review 再実行。must がゼロになるまで反復する。1 周で終えてよいのは初回から must ゼロの場合のみ。should は対応するか見送るか判断し、見送るものは PR 本文に理由を書ける状態にしておく。
4. 各周のレンズと must 件数を控えておく（§4 の本文に証跡として記載する）。

証跡の形式は diff-review スキルの証跡出力節を正とする（tasks/diff-review/evidence.md）。

gh pr create は PreToolUse hook（hooks/pr-review-gate.sh）により、このファイルが「存在 && commit==現 HEAD && must==0」でなければブロックされる。レビュー後に追加コミットすると HEAD が変わるため、再レビューを通すまで作成はブロックされる。

2. テンプレート確認

テンプレ検出は §1 の pr-context.sh が TEMPLATE セクションで決定論的に済ませている。手で find を打ち直さない（打ち忘れ・スキップの元）。

• primary: があり multi: が無い → そのファイルを読んで使う。
• multi: がある → 候補をユーザーに提示し、選ばれたものを使う。
• (テンプレートなし) → §4 の汎用構成へ。

配置の網羅一覧やプラットフォーム別の細部は references/platforms.md。スクリプトの検出漏れが疑わしいとき（独自配置のテンプレ等）だけ手動探索を補助に使う。

3. 言語判定

本文の言語は次の優先順で決める。①テンプレートがある → テンプレートの見出し・コメントの言語に合わせる。②無い → 直近コミットや README の言語。③不明 → ユーザーに確認。

4. 本文生成

大原則: 本文の素材は §1 スクリプトが出したこの作業ディレクトリの COMMITS / DIFF / CHANGED FILES だけ。会話に残る別リポジトリ・別タスクの記憶を素材にしない。

テンプレートあり（TEMPLATE に primary/選択した multi）: **テンプレは「確定した入力フォーム」**として扱う。テンプレ作成者が「何をどこに書くか」を既に決めているので、文脈を読んで構成を作り直す作業ではなく、決められた入力箇所を埋めるだけ。

• 骨組みは逐語で不変。見出しのテキスト・階層・順序、チェックリスト項目のラベル、HTML コメントの指示は変えない・消さない・並べ替えない・言い換えない。編集してよいのは入力箇所だけ（見出し下の空行やプレースホルダを埋める、- [ ]→- [x]）。
• 該当しないセクションも削らない。「今回は関係ない」と判断しても見出しは残し、中身に「該当なし」等と正直に書く。掃除・簡潔化を目的にセクションを落とさない。レビュアーはそのフォームの型で読む前提なので、型を崩すとレビュー観点が抜け落ちる。
• テンプレに無いセクションを勝手に足さない（どうしても補足が要るならテンプレ末尾に最小限）。
• <!-- ... --> は指示として読み、埋めた後の扱い（残す/消す）はテンプレ慣習・既存 PR に倣う。
• チェックリスト - [ ] は差分から確実に満たすものだけ - [x]。不明は未チェックで残し、全部チェックしない。
• 推測で事実を捏造しない。差分から読めない背景は埋めず、ユーザーに補完を促す。

生成した本文は、作成前に §5 の骨組み照合ゲートを必ず通す。

テンプレートなし: 下記の汎用構成（言語は §3 準拠、不要セクションは省く）。

## 概要
<!-- この PR で何をするか 1〜2 行 -->
## 変更内容
<!-- 主な変更点を箇条書き -->
## 変更の背景・理由
<!-- なぜ必要か。関連課題・経緯 -->
## 動作確認
<!-- どう確認したか。テスト・検証手順 -->
## 影響範囲・注意点
<!-- 影響箇所・レビュー注意点・未対応事項 -->
## 関連 Issue / リンク
<!-- Closes #xxx など -->

「動作確認」には、テスト・検証手順に加えて §1.5 のセルフレビュー証跡（実施レンズ・周回数・最終 must 0）を記載する。テンプレートがあるリポジトリでは骨組みを壊さず、該当セクション（動作確認・チェックリスト等）の入力箇所に同じ内容を書く。

5. 骨組み照合（テンプレートがある場合の作成前ゲート）

テンプレ遵守を目視に委ねると、無意識にセクションを落としたり見出しを言い換えたりしやすい。決定論スクリプトで機械的に照合し、drift があれば提示前に潰す。

1. 生成した本文を一時ファイルに書き出す（セッションの scratchpad 等、リポジトリ外の一時領域）。

2. テンプレ本体と照合する:

   bash <skill-dir>/scripts/template-check.sh <テンプレのパス> <本文下書きのパス>
   

   • RESULT: OK → 骨組み一致。§7 の提示へ進む。
   • RESULT: DRIFT DETECTED → MISSING（削った見出し/項目）・EXTRA（勝手に足した見出し）・REORDER（並べ替え）を確認し、下書きをテンプレ構造に戻して再チェック。OK になるまで提示に進まない。骨組みを守った上で入力箇所を埋め直す（勝手にセクションを消して辻褄を合わせない）。

テンプレが無い（§4 の汎用構成）ときはこのゲートは不要。

6. タイトル

Conventional Commits 形式（<type>(<scope>): <subject>、commit-flow スキル準拠）を基本。単一コミットはそのメッセージを流用、複数は全体を要約。既存 PR にタイトル規約があればそれを優先。

7. 承認 →（未 push なら push 承認）→ 作成

1. タイトルと本文をチャットに提示 → ユーザー承認。
2. §1 の PUSH STATUS が WARNING（未 push／未 push コミットあり）なら、AskUserQuestion で push 可否の承認を取る（要点と選択肢は本文にも記載する）。
   • 承認 → push する。SSH 認証（publickey）で弾かれる非対話環境では、push コマンドを提示してユーザーに実行を委ねる。
   • 拒否 → push せず、ユーザーが push してから作成する旨を伝えて停止。
   • 既に push 済み（WARNING なし）ならこの手順は不要。
3. draft 作成（コマンドは references/platforms.md）→ PR の URL を報告。

参照

• scripts/pr-context.sh — リポジトリ同定（REPO IDENTITY）・プラットフォーム判定・テンプレ決定論検出（TEMPLATE）・ベース特定〜差分・push 状態を出す read-only スクリプト（§1）。
• scripts/template-check.sh — テンプレ本体と本文下書きの骨組み（見出し＋チェックリストのラベル）を照合し、削り・勝手追加・並べ替えを検出する作成前ゲート（§5）。
• references/platforms.md — プラットフォーム別 CLI コマンド・テンプレ配置・手動作成フォールバック。