review-pr-comments について
既存の PR に寄せられたレビュー意見を扱うコーディングエージェント向けスキルです。指摘の分類、まとめての修正、CI 検証を案内し、無断で判断せず 2 ラウンドでプッシュを止めます。
主な機能
- 01レビュー、スレッド、失敗したチェックの収集
- 02修正・返信・エスカレーションへの分類
- 03検証、コミット、プッシュ、CI 確認
- 042 ラウンド後にプッシュを停止
活用シーン
- 01PR の正確性やセキュリティに関する指摘への対応
- 02コミットせずにスタイル上の指摘へ返信
- 03意見の衝突やスコープ判断のエスカレーション
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ hcaiano/ skills --skill review-pr-commentsインストール後、Claude Code で/review-pr-commentsを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
PR のレビューコメントへの対応
既存の PR に対する実際のレビュー指摘に対応します。これは必要に応じて行う例外的なプロセスです。クラウドでの自動レビューは無効になっており、重いレビューはすでにローカルで完了している(ship-it のリリースゲート)ため、ほとんどの PR にはコメントがありません。ボットによるレビュー(@codex review、@coderabbitai review)を依頼してはいけません。また、ボットからの返答がないからといって、待ち続けてはいけません。
プロセスは最大 2 ラウンドまでです(1 ラウンド = 指摘の収集 → トリアージ → まとめて 1 回のコミット → プッシュ → 新しいヘッドで必須 CI が成功):
- 未解決のフィードバックをすべて収集します。人間によるレビュー、ボットのコメント、未解決および古くなったスレッド、失敗したチェックが対象です。
- 各指摘をコードに照らしてトリアージします。
- まとめて修正: 実際の正確性、セキュリティ、データ整合性の問題、および人間のレビュアーが明示的に求めた内容。
- 返信してプッシュしない: スタイル上の細かな指摘、すでに成り立っている不変条件への防御的な強化、重大度を誇張した指摘や重複した指摘。スレッドに返信して解決し、次に進みます。細かな指摘を理由にプッシュしてはいけません。
- ユーザーに提示: プロダクトやアーキテクチャ上の判断、スコープの拡大、レビュアー間で相反する指針。
- 変更全体(元の変更と修正を含む)を検証し、コミットして一度だけプッシュします。その後、必須 CI の成功を待ちます(60~120 秒間隔で確認し、短い間隔でのポーリングはしないでください)。
2 ラウンドを終えたら、プッシュを停止します。残っている項目について、トリアージ結果と推奨対応を報告します。最後のプッシュ後に届いたフィードバックによって、プロセスを再開してはいけません。完了条件は、最終ヘッドで必須チェックが成功し、人間から求められた変更が対応済みで、すべての未解決スレッドが修正または回答済みであり、GitHub 上で PR がマージ可能と表示されていることです。ボットによる再レビューは、完了条件ではありません。
マージ、強制プッシュ、main の変更、後続 PR の作成(細かな修正のみを目的とした後続 PR は明示的に禁止)、または許可なくプロダクトやアーキテクチャ上の判断をしてはいけません。