review-pr-holistic について
review-pr-holistic は、提供されたプルリクエストの指摘を整理し、担当者向けのコメントにまとめるスキルです。重複や根拠で否定された指摘を除き、レビュー範囲と方針を適用します。新しい指摘の生成やコメントの投稿は行いません。
主な機能
- 01重複または反証済みの指摘を除外
- 02レビュー間の同種の懸念を統合
- 03レビュー対象範囲を適用
- 04コメントのアンカー範囲を指定
- 05指定された文体にコメントを修正
- 06除外した指摘の概要を返却
活用シーン
- 01重複するレビュー指摘の整理
- 02プルリクエストレビュー用コメントの準備
- 03既存スレッドで扱われた指摘の除外
- 04判断を要する質問を担当者向けに保持
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/review-pr-holisticを入力して読み込まれたか確認します。
詳細
review-pr-holistic
大量の指摘を、慎重なレビュアーが実際に投稿するコメントにまとめます。このスキルは編集と統合を行います。新しい指摘を生成したり、それ自体でコメントを投稿したりすることはありません。
受け取るもの。 指摘の一群 — レビューの各観点から寄せられた、重大度が付与された欠陥の指摘。観点と重大度は保持され、結果への影響を確認したうえで、呼び出し元が選択した受け入れポリシーと公開ポリシーのみに基づいて指摘が絞り込まれます。ただし、正確性や安全性の問題、および破られた明示的な約束が証拠に基づいて重大度を再評価されずに Low とされた場合は、絞り込みの前に再評価されます — および、それらの指摘を含む判断評価。これは ../review-pr-judgment/SKILL.md で定義された、重大度とは異なる分類であり、すでにルートごとに1つの問いに統合されています。PR の履歴（PR 上のすべてのコメントとスレッド。過去のレビューで当方が投稿したものも含みます）、ブランチ上で作者が最近記したコミットメッセージ、PR の説明、リンクされた各 PR のバンドルコンテキスト（差分、説明、最上位の会話 — リンク先 PR のインラインレビューコメントは含みません）、存在する場合はマニフェスト、この呼び出しでレビュー対象となる範囲 — 欠陥の指摘が対象とするコード、投稿コメントの文体に関するルールを含む呼び出し元のボイスプロファイル、および呼び出し元が行った切り詰め。切り詰めは引き継ぎます。
呼び出し元が選択したポリシーに基づいて保持された Low の指摘はそのまま残します。統合によって独自の重大度基準を設けることはありません。
次の順序で処理します。
- 取り除く — 既存のスレッドですでに扱われている重複した懸念、証拠によって反証された指摘、および明示された意図的な要件だけを異議の根拠とする欠陥の指摘を取り除きます。明示された意図は対象範囲を定め、証拠は実際の動作を明らかにします。PR が
../review-pr-judgment/SKILL.md→ 懸念への回答 に従って特定の結果への影響にすでに答えていない限り、判断に関する問いは保持します。投稿するコメントがなくなった場合でも、決着した意見の相違は返される評価に残します。作者の主張だけでは、実証された不具合を反証できません。 - 重複を排除する — レビュアー間で指摘を照合し、同じ根本的な懸念を示す類似の指摘は、1つのコメントにまとめます。
- 前提への包含。 判断に関する指摘が、あるインターフェイスの必要性や存在を問う場合、同じインターフェイスに関する一群の欠陥指摘は、その前提を問う指摘に従属させます。価値の低い指摘は取り除き、残す指摘は独立した同列の項目として列挙せず、その指摘の下に組み込みます（「X を残すなら、a と b も対応してください」）。実質的な修正義務が未達の場合は、その指摘が Low として届いても保持し、証拠に基づいて重大度を修正します。ブロックしない前提への問いで、修正義務を果たしたことにはできません。呼び出し元のポリシーに照らして対象となる独立した欠陥はすべて保持します。インターフェイスの必要性を問う判断の指摘だけで、その欠陥を取り除くことはできません。
- 範囲を限定する — 表面化させる欠陥の指摘は、レビュー対象の範囲によって導入された、または顕在化した問題に限定します。ただし、レビュー対象が PR の差分全体である場合は除きます。これは初回レビューにも、未変更の最新状態に対する再レビューにも当てはまります。基準となるのはレビュー対象の範囲であり、以前にレビューしたかどうかではありません。再レビューの範囲を前回のレビューからの差分に限定すると、PR 全体を読み込んだうえで何も指摘しないことになります。レビュー対象の範囲内にある修正によって、その修正を可能にする境界や影響を受ける箇所が明らかになった場合、それらの行に変更がなくても表面化させます。無関係な後続差分によって、過去の修正を再び取り上げることはありません。判断に関する指摘は PR 全体を対象とするため、この範囲制限の対象外です。
- アンカーを設定する — 保持する各指摘に、インラインのファイル名と行番号（デフォルト）、ファイルレベル（ファイル全体に関する懸念）、PR レベル（特定のアンカーがない横断的な懸念）のいずれか1つだけを割り当てます。
- 書き直す — すべてのコメント本文と、草案として作成された返信を、指定されたボイスプロファイルに合わせます。
- デフォルトでは要約見出しを省く — コメントの一覧だけでは伝わらない全体的な見解が本当にある場合に限り、1文の短い要約を追加します。定型文は使わず、文体の要件に従います。 戻り値。 投稿するコメント（アンカーと、指定された語調に準拠した本文）、存在する場合は概要ヘッダーのテキスト、切り詰めに関する注記、主な理由を含む簡潔な除外所見数の集計、オペレーター向けに保持された判断評価です。書き換え後も、推奨事項、根拠、不確実性は維持されます。強い推奨事項は、その語調で禁止されている婉曲表現を使わず、直接的に表現できます。