AI に書かせる PR 説明は「要約・根拠・取り込む危険度」の3節に固定する（mattpocock の /pr）
mattpocock/skills v1.3 の /pr は、PR 本文を Summary・Evidence・Merge Danger の3節で書かせる。要約は文章でなく「その変更を一番小さく見せる図や疑似コード」、根拠は Before/After、危険度は「引き返せるか」と「影響範囲」で書く。
どんな時に使う？
- エージェントが書く PR 説明が長いだけで、レビューする人が何を見ればいいか分からない
- 「動いた」の根拠が書かれず、レビュー側が手元で再現している
- 戻せない変更（スキーマ変更・公開 API・データ削除）が、ほかの PR と同じ温度で出てくる
手順
- Claude Code なら
claude plugin install mattpocock-skills@claude-plugins-officialで入れて/pr。自分で作るなら下の型をスキルやテンプレートに書く - Summary: 変更点を一番小さく伝わる形で見せる。疑似コード、呼び出しの木、コンポーネントの木、ファイルの木、Mermaid 図、短い diff のうち1つを選ばせる。用語はリポジトリの GLOSSARY.md（旧 CONTEXT.md）の言葉に揃える
- Evidence: 変更前と変更後の挙動（テスト結果、スクリーンショット、コマンドの出力）を並べる
- Merge Danger:
- Door: one-way（取り込んだら戻せない）か two-way（revert で戻せる）か
- Blast Radius: 壊れたときの影響範囲を一語で（必要なら起こりうる影響を一言足す）
- 前置きは省き、文章は短く
- 作者の例: github.com （本人が「要約・根拠・危険度が的確」と紹介）
注意点
- Summary 節の図の選び方は Humanlayer（Dex Horthy）の show-me スキルからほぼそのまま持ってきたと CREDITS.md に書かれている
- one-way の変更は PR 自体を分けておくと説明も短くなる: 戻せない変更の PR は「戻せる PR」と「戻せない一歩だけの PR」に分けさせる
- 同じ v1.3 の
/retroは 終わったセッションを7つの観点で振り返り、リポジトリ側を直す（mattpocock の /retro）
出典
- @mattpocockuk · 2026-10-28
- @sumika45379 2026-10-28（v1.3 の変更まとめ）: @sumika45379 · 2026-10-28
- リポジトリ: github.com/mattpocock/skills