create-pr(PR本文を構造化して投稿する)

1. 差分と経緯を集める

• git diff main...HEAD で変更の全体を把握する
• 対応するプラン（agents/plans/）と、実装後のAIレビュー結果を読む

比較元のブランチは導入先に合わせる。このコマンドはコミット済みの差分を対象とする。未コミット変更がある場合はgit diff HEADと未追跡ファイルも確認する。PRの本文と検証結果は、実際に投稿するコミットに合わせる。

2. 本文を下書きする

次の見出しで、レビューアーが上から読めば理解できる順に書く。

• 課題: 何を解決するPRか（背景と、対応するissue・プラン）
• 解決策: どう変えたか。設計判断とトレードオフを1〜2行で
• テスト: 追加・変更したテストと、手元での実行結果
• レビュー観点: とくに見てほしい箇所、影響範囲、未対応事項

下書きはdocs/pr/へ保存する。保存先がなければ作成し、投稿前に人間の承認を取る。

3. 投稿する

承認後、gh pr create --body-file <下書きファイル>で作成する。CIとAIレビューの自動実行は導入先の設定に依存する。設定済みの場合は結果を確認し、未設定の場合は必要な検証と別セッションのレビューを実行してから、人間のレビューへ回す。