mcpField
R
review-pr-comments

review-pr-comments

github.com/hcaianoテスト・品質52 回インストール
リポジトリ

review-pr-comments について

既存の PR に寄せられたレビュー意見を扱うコーディングエージェント向けスキルです。指摘の分類、まとめての修正、CI 検証を案内し、無断で判断せず 2 ラウンドでプッシュを止めます。

主な機能

  1. 01レビュー、スレッド、失敗したチェックの収集
  2. 02修正・返信・エスカレーションへの分類
  3. 03検証、コミット、プッシュ、CI 確認
  4. 042 ラウンド後にプッシュを停止

活用シーン

  1. 01PR の正確性やセキュリティに関する指摘への対応
  2. 02コミットせずにスタイル上の指摘へ返信
  3. 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 が成功):

  1. 未解決のフィードバックをすべて収集します。人間によるレビュー、ボットのコメント、未解決および古くなったスレッド、失敗したチェックが対象です。
  2. 各指摘をコードに照らしてトリアージします。
    • まとめて修正: 実際の正確性、セキュリティ、データ整合性の問題、および人間のレビュアーが明示的に求めた内容。
    • 返信してプッシュしない: スタイル上の細かな指摘、すでに成り立っている不変条件への防御的な強化、重大度を誇張した指摘や重複した指摘。スレッドに返信して解決し、次に進みます。細かな指摘を理由にプッシュしてはいけません。
    • ユーザーに提示: プロダクトやアーキテクチャ上の判断、スコープの拡大、レビュアー間で相反する指針。
  3. 変更全体(元の変更と修正を含む)を検証し、コミットして一度だけプッシュします。その後、必須 CI の成功を待ちます(60~120 秒間隔で確認し、短い間隔でのポーリングはしないでください)。

2 ラウンドを終えたら、プッシュを停止します。残っている項目について、トリアージ結果と推奨対応を報告します。最後のプッシュ後に届いたフィードバックによって、プロセスを再開してはいけません。完了条件は、最終ヘッドで必須チェックが成功し、人間から求められた変更が対応済みで、すべての未解決スレッドが修正または回答済みであり、GitHub 上で PR がマージ可能と表示されていることです。ボットによる再レビューは、完了条件ではありません。

マージ、強制プッシュ、main の変更、後続 PR の作成(細かな修正のみを目的とした後続 PR は明示的に禁止)、または許可なくプロダクトやアーキテクチャ上の判断をしてはいけません。

コメント