PRを出す前に、自分のgit diffをGoogle Engineering Practicesの チェックリストでセルフレビューする。実装が一段落して、commit・push・PRの 直前に使う。
create-pr
実装が一段落したら、PR本文を課題・解決策・テスト結果・レビュー観点の 形に整形して下書きし、承認を取ってからGitHubへ投稿する。「PRを作って」と 頼まれたときに使う。
含まれるファイル(1)
- SKILL.md1.7 KB
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
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レビューの自動実行は導入先の設定に依存する。設定済みの場合は結果を確認し、未設定の場合は必要な検証と別セッションのレビューを実行してから、人間のレビューへ回す。
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
機能追加や仕様変更の要件を確認し、設計・テスト・実装順を含むプランを作る。プラン作成や実装前の設計を依頼されたときに使う。
実装差分を要件・プラン・開発ルールと照合してレビューする。コードレビューや実装レビューを依頼されたときに使う。
Sentryのイシューを調査して修正する。リンク・ID・検索でイシューを 特定し、スタックトレース・ブレッドクラム・トレース・ログの全コンテキストを 取得し、根本原因を特定して修正・解決する。
テスト駆動開発で機能追加・バグ修正を実装する。テストリストから 1件ずつRed、最小のGreen、Refactorを回す。ユーザーがTDD・テスト駆動・ Red-Green-Refactorを指定したときに使う。テストの後付けだけの依頼には使わない。