Skip to main content
リポジトリに指示をコミットすることで、Code Review がそのリポジトリで指摘する内容を変更できます。これにより、nit の量を減らしたり、生成されたファイルへのコメントを止めたり、チームが重視するルールを追加したりできます。指示は次の 2 つのファイルのいずれかに記述します。
  • CLAUDE.md：Claude Code がレビューを含むすべてのタスクで読み込むプロジェクト指示です。Code Review はこれをプロジェクトのコンテキストとして読み込み、これに違反する変更を指摘します。
  • REVIEW.md：レビュー専用の指示です。チームが何を指摘してほしいか、どの重大度で指摘するか、何をスキップするかを記述するために使用します。
リポジトリのルートに REVIEW.md を追加してマージします。その後、デフォルトブランチを保護します。
レビューの徹底度や実行タイミングを変更するには、Owner にレビューレベルまたは Review runs 設定の変更を依頼してください。

​
プロジェクト全体のルールには CLAUDE.md を使用する

Code Review は、リポジトリの CLAUDE.md ファイルをプロジェクトのコンテキストとして読み込みます。そのルールのいずれかに違反する変更は、問題に応じた重大度レベルの検出結果になります。 レビューでは、リポジトリのルートにある CLAUDE.md と、変更された各ファイルの親ディレクトリにある CLAUDE.md ファイルが読み込まれます。サブディレクトリの CLAUDE.md は、プルリクエストがそのパス配下のファイルを変更した場合に読み込まれます。

​
レビュー専用のルールには REVIEW.md を使用する

REVIEW.md は、Code Review をリポジトリに合わせて調整するための、リポジトリのルートに置くファイルです。サブディレクトリに REVIEW.md を追加して、ルートのファイルに加えて、そのパス配下の変更に対するチェックを追加することもできます。 問題を検出するエージェントと、それを検証するエージェントは、Code Review のデフォルトのレビューガイダンスとともに、このファイルの内容をリポジトリのレビュー指示として受け取ります。最終的なレビューを書き出すステップでは、重大度を確定してサマリーを書く前にこのファイルを参照します。 次のレイアウト例には、ルートのファイルとサブディレクトリのファイルが 1 つずつあります。
サブディレクトリのファイルに頼る前に、デフォルトブランチを保護し、ブランチ構成に応じてレビューが何を読み込むかを確認してください。
Code Review サービスとローカルの /code-review コマンドは別々のツールであり、読み込むファイルが異なります。サービスは CLAUDE.md と REVIEW.md の両方を読み込みます。自分のマシン上の Claude Code セッション内で実行する /code-review コマンドは、CLAUDE.md ファイルを読み込みますが、REVIEW.md は読み込みません。両方で適用したいガイダンスは CLAUDE.md に記述し、REVIEW.md はプルリクエストのレビューに固有のルールのために使用してください。

​
REVIEW.md の例

この REVIEW.md は、バックエンドサービス向けに重大度を再調整し、nit の数に上限を設け、生成されたファイルをスキップし、リポジトリ固有のチェックを追加します。

​
REVIEW.md に何を書くかを決める

REVIEW.md は自由形式の Markdown で、レビューが何を検出して報告するかを変更します。レビューの形式は変更しません。発生している問題を見つけ、示されているような指示を追加してください。例では最初の 4 つを使用しています。
  • 間違ったものが Important としてマークされる：リポジトリにおける 🔴 Important の意味を再定義します。デフォルトの調整は本番コードを対象としており、ドキュメントリポジトリ、設定リポジトリ、プロトタイプではもっと狭い定義が望ましい場合があります。どの種類の検出結果が Important で、どれがせいぜい Nit なのかを明記してください。重大度を引き上げることもでき、たとえば CLAUDE.md への違反をすべて Important として扱うこともできます。
  • nit が多すぎる：1 回のレビューで投稿される 🟡 Nit コメントの数に上限を設けます。「nit は最大 5 件まで報告する」のような上限により、レビューを対応可能な内容に保てます。
  • 生成されたファイルや CI がすでにチェックしている内容へのコメント：Claude が検出結果をスキップすべきパスと検出結果のカテゴリを列挙します。よくある候補は、生成コード、ロックファイル、vendor された依存関係、そして lint やスペルチェックなど CI がすでに強制しているものです。ある程度のレビューを必要とするものの、徹底的な精査までは不要なパスについては、代わりに基準を引き上げます。たとえば「scripts/ では、ほぼ確実かつ重大な場合にのみ報告する」とします。
  • チームのルールがチェックされていない：「新しい API ルートには統合テストが必要」のように、すべてのプルリクエストで指摘してほしいルールを追加します。
  • 誤っていることが判明する検出結果：ある種類の検出結果を投稿する前に根拠を求めます。たとえば「動作に関する主張には、命名からの推測ではなく、ソース内の file:line の引用が必要」とすることで、作成者に余計なやり取りを強いる誤検出を減らせます。
これらの指示の一部は、保護されたデフォルトブランチ上のルートファイルを必要とします。 REVIEW.md にはレビューの動作を変える指示だけを記述し、一般的なプロジェクトのコンテキストは CLAUDE.md に残してください。

​
REVIEW.md がどのブランチから読み込まれるか

Code Review は、REVIEW.md をプルリクエストのベースブランチまたはデフォルトブランチから読み込み、プルリクエスト自体の変更から読み込むことはありません。レビューの動作を変更するには、まず REVIEW.md の変更をマージしてください。 REVIEW.md はデフォルトブランチに置き、そのブランチを保護してください。レビューが保護されたデフォルトブランチ上のコピー（下の表の 1 行目）を読み込む場合、ルートファイルにある次の指示が適用されます。
  • 検出結果の重大度を下げる
  • パス、ファイル、または問題の種類を除外する
  • nit コメントの数に上限を設ける

​
ブランチ保護とみなされるもの

Code Review は、次の設定を保護とみなします。
  • デフォルトブランチ：クラシックなブランチ保護ルールまたはルールセット
  • その他のブランチ：ルールセットのみ
ルールセットは、更新を制限している場合、または少なくとも 1 件の承認を伴うプルリクエストを必須にしている場合に保護とみなされます。プルリクエストを必須にしている場合は、新しいプッシュ時にその承認を取り消すか、最後のプッシュ以降の承認を必須にする必要もあります。

​
ブランチ構成ごとにレビューが読み込むもの

下の表の 1 列目から、リポジトリの状況に該当するものを見つけてください。 チェック実行で REVIEW.md について言及されている場合は、The check run mentions REVIEW.md を参照してください。