claude-review

このスキルはレビューのオーケストレーションを行うものであり、コードを編集するものではありません。

譲れないルール：

1. レビュアー用のプロンプトを作成する前に、実際の差分を読みます。
2. 必ず隔離された環境でレビューを実行します。
3. レビュアーには報告のみを行い、コードは変更しないよう指示します。
4. 2回目以降のレビューでは除外リストを引き継ぎ、修正済みの指摘が再報告されないようにします。
5. 返された指摘を確認してから対応します。

Claude Review

入力

• $request：last commit、uncommitted、auth focus、round 2 など、任意のスコープ指定

目標

次の条件を満たす、焦点を絞った Claude レビューを実施します。

• 実際の差分に基づいてスコープを決める
• レビュアーに適切な確認ポイントを提示する
• メインの作業ツリーから隔離して実行する
• コードを変更せず、対応可能な指摘を返す

ステップ 0：レビューのスコープを決定する

ユーザーが次のどのレビューを希望しているか判断します。

• ブランチ全体のレビュー
• 最後のコミットのレビュー
• 未コミットの変更のレビュー
• サブシステムまたは最近のタスクを対象としたレビュー

プロンプトを作成する前に、該当する差分の概要と変更ファイルの一覧を読みます。

レビュー対象がない場合は、ここで終了し、その旨を明示します。

成功基準：レビューのスコープが明確で、実際の差分によって裏付けられていること。

ステップ 1：焦点を絞ったレビュー概要を作成する

差分を使って、次の点を特定します。

• 変更ファイル
• 変更されたディレクトリまたはサブシステム
• 認証、シークレット、並行処理、シェル実行、マイグレーション、テストなど、想定されるリスク領域
• 以前のラウンドで修正済みで、再度報告すべきでない問題

プロンプトには、次の内容を含めます。

• レビューのベースとスコープ
• 変更ファイルの一覧
• 焦点を当てるリスク領域
• 報告のみを行うという明示的な指示
• 希望する出力形式

成功基準：レビュアー向けの指示が一般的な定型文ではなく、実際の変更内容に即した具体的なものであること。

ステップ 2：隔離されたレビュアーを起動する

Agent を次の設定で使用します。

• subagent_type: general-purpose
• isolation: "worktree"
• 次の内容を指示するプロンプト：
  • 差分全体を読む
  • 周辺ファイルのコンテキストを読む
  • 各指摘を報告する前に検証する
  • コードを変更しない
  • 指摘を次の Markdown テーブル形式で報告する： | # | Priority | File:Line | Description | Suggested Fix |
  • 優先度のレベル：P1（クラッシュ／セキュリティ）、P2（動作の誤り）、P3（軽微）
  • 重要な問題が見つからなかった場合は、その旨を明示する

レビューに時間がかかる見込みであれば、バックグラウンドで実行してもかまいません。ただし、レビュアーの焦点がぶれないよう、スコープは十分に絞ってください。

成功基準：レビューが隔離された worktree で実行され、アクティブな作業コピーを変更できないこと。

ステップ 3：指摘を整理して要約する

次の内容を報告します。

• レビューしたスコープ
• 優先度ごとに分類した指摘
• ファイルと行の参照
• 重要な指摘がなかった場合は、その旨を明示

レビュアーの出力は候補となる指摘として扱い、自動的に正しいものと見なしてはいけません。ユーザーが修正を希望する場合は、各指摘をローカルで確認してから対応します。

成功基準：ユーザーがエージェントの生の出力を解析しなくても、読みやすいレビュー概要を得られること。

ステップ 4：有用な場合に限り反復する

2回目以降のラウンドでは、次のようにします。

• 以前に修正した指摘を除外リストに含める
• 新しい領域または変更された領域にレビューの焦点を絞る
• 変更ファイルが少数の場合、ブランチ全体を対象にした一般的なレビューを再実行しない

成功基準：各ラウンドが過去の指摘を繰り返すのではなく、本当に新しい問題を探すこと。

関連スキルとの比較

スキル	ツール	最適な用途
/claude-review	Claude Code (Agent)	深いコード理解、コンテキストを踏まえたレビュー
/codex-review	OpenAI Codex CLI	独立した視点、再現スクリプト
/kiro-review	Kiro CLI	代替となる AI の視点

重要なコードでは、3つすべてを実行し、指摘を相互に照合してください。レビュアー間で指摘が重なることで、単一のツールよりも多くのバグを検出できます。

ガードレール

• context: fork を追加しないでください。このスキルはすでにエージェントのランタイムを直接使用しています。
• レビュアーにコードを編集させないでください。
• プロンプトを作成する前に差分を読む手順を省略しないでください。
• プロンプトや要約に実際のシークレット値を含めないでください。
• このスキルを先回りして実行しないでください。明示的なユーザー指示がある場合にのみ実行します。

出力仕様

次の内容を報告してください。

1. レビュー範囲
2. プロンプトで重点的に扱った変更箇所
3. 優先度別の指摘事項（file:line を記載）
4. 重大な指摘事項がなかった場合は、問題がなかったことを明記
5. 後続のレビューラウンドで、以前に修正済みの問題を除外するかどうか