3行まとめ
AIは初回スクリーニングに寄せます。
merge可否は人間が持ちます。
見落としと誤検知を記録します。
AIレビューは置き換えではなく、レビュー前処理として設計します。
- AIコードレビューは、人間レビューの代替ではなく、PRの初回スクリーニング、規約違反候補、例外ケース、テスト不足候補を拾うための前処理として置くと運用しやすくなります。
- Claude Code ReviewやGitHub Copilot Code Reviewを入れても、仕様判断、merge可否、リスク受容、CODEOWNERSの承認は人間が持つべきです。
- 導入初週は、コメント数ではなく、採用された指摘、誤検知、見落とし、レビュー時間の変化を記録し、AIコメントをそのまま修正命令にしない運用を作ります。
本文の事実確認には、Claude Code Reviewの公式Docs、GitHub Copilot Code Reviewの公式Docs、GitHubのPull Requestレビュー、custom instructions、CODEOWNERS関連Docsを使っています。Xで伸びているAI reviewerやコードレビュー自動化の投稿は需要シグナルとして扱い、本文の根拠にはしていません。
この記事でわかること
AIと人間の担当を分けます。
バグ、規約、テスト、仕様判断を分けます。
AIが見やすい差分サイズにします。
誤検知と見落としを測ります。
ツール選定より先に、レビューの責任分担を決めます。
- AIコードレビューに任せること、任せないこと
- Claude Code ReviewとGitHub Copilot Code Reviewを見るときの観点
- PRサイズとレビュー観点を先に揃える理由
- AIコメントを修正命令ではなく判断材料として扱う方法
- 人間レビューとCODEOWNERSで残す責任範囲
- 導入後に見るべき採用率、誤検知、見落とし、レビュー時間
AIレビューを入れる目的は、レビューを雑に速くすることではありません。レビュー前に見落とし候補を増やし、人間が本当に見るべき判断へ集中できる状態を作ることです。
もしAIレビューを「承認者を減らす仕組み」として入れると、最初は楽に見えても、重要な仕様判断やリスク受容が曖昧になります。この記事では、ツールの勝敗ではなく、PRレビューの責任分担を崩さない導入手順を扱います。
前提知識
| 項目 | 内容 | 見方 |
|---|---|---|
| Claude Code Review | PRへinline findingsを出す機能を確認します。 | |
| Copilot Code Review | GitHub上のCopilotレビュー機能を確認します。 | |
| GitHub PR review | 人間のreview、approval、changes requestedを確認します。 | |
| CODEOWNERS | 責任者レビューの仕組みを確認します。 |
AIレビューはGitHubの既存レビュー機構と合わせて運用します。
Claude Code Reviewの公式Docsでは、GitHub Pull Requestを解析し、見つけた問題を対象行へのinline commentとして投稿する機能が説明されています。手動でレビューを依頼する方法や、組織設定で有効化する流れも案内されています。
GitHub Copilot Code Reviewの公式Docsでは、GitHub上のPull Requestや開発環境からCopilot reviewを依頼する方法が説明されています。GitHubにはrepository-levelやpath-specificのcustom instructionsもあり、Copilotへプロジェクト固有の規約を伝える仕組みがあります。
一方、GitHubの通常のPull Request reviewでは、reviewerがcomment、approve、request changesを行います。CODEOWNERSを使うと、特定pathの責任者レビューを自動的に要求できます。AIレビューを入れる場合も、この既存のレビュー責任を消さないことが重要です。
AIレビューはレビュー状態を変えるものではない
AIレビューがinline commentを出しても、それだけで人間の承認や責任者レビューが終わるわけではありません。AIの指摘は、レビュー材料の1つです。merge可否を決めるのは、repository rule、branch protection、CODEOWNERS、担当者の判断です。
条件
最初は、AIレビューを必須approvalの代わりにしません。AIレビューは「PRを開いた後に追加で見る視点」として置き、人間reviewerが最後に判断します。
注意点
AIレビューは便利ですが、コメントが増えるほど重要な指摘が埋もれることがあります。導入時は、コメントの数ではなく、有用だった指摘の割合を見ます。
AIレビューに任せることと任せないこと
| 項目 | 内容 | 見方 |
|---|---|---|
| 任せる | 差分の初回確認、例外ケース、規約違反候補、テスト不足候補。 | |
| 任せない | 仕様判断、優先順位、リスク受容、merge可否、責任者承認。 | |
| 共同 | セキュリティ懸念、破壊的変更、互換性影響。 | |
| 記録 | 誤検知、見落とし、採用した指摘を残します。 |
AIコメントを増やすより、判断の所在を明確にします。
AIコードレビューに任せやすいのは、差分から機械的に見つけやすい問題です。たとえば、未処理の例外、nullやundefinedの扱い、テスト不足、規約違反、不要な複雑化、明らかなセキュリティ懸念候補などです。
一方で、人間が持つべき判断も残ります。仕様としてその挙動でよいか、今そのリスクを受け入れるか、顧客影響をどう見るか、互換性を壊してよいか、リリース順序をどうするか、といった判断です。
| 領域 | AIレビュー向き | 人間レビューで残すこと |
|---|---|---|
| バグ候補 | 例外、境界値、未定義動作 | 実際に問題か、仕様かを判断する |
| スタイル | 命名、規約、重複 | チーム規約との優先順位を決める |
| テスト | 不足候補、ケース漏れ | どのテストを必須にするか決める |
| セキュリティ | 入力検証、権限、secret疑い | リスク受容と対応期限を決める |
| 仕様 | 矛盾候補の指摘 | 仕様そのものを決める |
AIレビューは「一次スクリーニング」に寄せる
AIレビューの良い使い方は、最初に広く見てもらうことです。人間が差分を読む前に、AIが気になる点を拾います。そのあと人間が、指摘の重要度、再現性、修正するかどうかを判断します。
AIに承認責任を持たせない
AIが「問題なし」と言っても、それは承認ではありません。大きいPR、権限変更、認証、課金、DB migration、顧客データ、CI/CD、外部通信を含むPRでは、人間レビューを残します。
この線引きは、法人導入前のAIコーディング権限設計で扱った人間承認フローとも同じです。AIが見たことと、組織として承認したことは分けます。
Claude Code ReviewとCopilot Code Reviewの見方
自動、手動、コメント起動の違いを見ます。
diffだけかrepo文脈も見るか確認します。
repo指示やcoding standardの扱いを確認します。
inline comment、summary、severityを見ます。
同じAIレビューでも、起動方法と出力形式で運用が変わります。
Claude Code ReviewとGitHub Copilot Code Reviewは、どちらもPRレビューを助ける機能として見られます。ただし、比較するときは「どちらが賢いか」だけで決めないほうがよいです。
見るべきなのは、起動方法、出力形式、repo文脈の扱い、custom instructions、管理設定、コメントの粒度、誤検知の扱いやすさです。
| 観点 | 確認すること |
|---|---|
| trigger | PR作成時、自動、手動、コメント起動のどれか |
| context | diffだけか、repository文脈や既存規約をどう見るか |
| instruction | repository instructionsやpath-specific instructionsを使えるか |
| output | inline comment、summary、severity、再レビュー依頼の形 |
| management | 組織設定、対象repo、対象branchを制御できるか |
| workflow | 人間reviewer、CODEOWNERS、branch protectionと並べられるか |
Claude Code Reviewを見る観点
Claude Code Reviewは、PR上にfindingをinline commentとして出す形が中心です。公式Docsでは、fresh reviewを依頼するコメント操作なども案内されています。チーム導入では、自動起動にするか、手動起動にするか、対象repoをどう絞るかを確認します。
Copilot Code Reviewを見る観点
GitHub Copilot Code Reviewは、GitHubのPR画面や開発環境からレビューを依頼できます。GitHubのcustom instructionsを使う場合は、repository-levelの指示とpath-specificの指示が、レビューでどの程度効くかを小さなPRで確認します。
注意点
どちらのツールでも、AIレビューの出力をそのまま修正指示として扱わないほうが安全です。誤検知もあれば、チームの設計意図と合わない指摘もあります。
PRサイズとレビュー観点を先に揃える
- 1目的
PRの目的を1つに絞ります。
- 2範囲
対象pathと非対象pathを分けます。
- 3確認
テスト、スクショ、移行手順を添えます。
- 4依頼
AIと人間へ見る観点を渡します。
PRが大きすぎると、AIも人間も見落としやすくなります。
AIレビューを入れる前に、PRそのものをレビューしやすくします。巨大なPRにAIレビューをかけても、コメントは増えますが、判断が楽になるとは限りません。
PRは、目的、対象範囲、テスト、リスク、見てほしい観点を明確にします。AIにも人間にも、同じ前提を渡します。
PR本文に入れるとよい項目
| 項目 | 内容 |
|---|---|
| 目的 | 何を変えたPRか |
| 対象外 | 今回あえて触らない範囲 |
| 影響範囲 | UI、API、DB、認証、課金、CIなど |
| テスト | 実行したコマンド、結果、未実行理由 |
| レビュー依頼 | 特に見てほしい観点 |
| リスク | 互換性、移行、rollback、feature flag |
AIレビュー向けに観点を渡す
AIレビューに「全部見て」だけを渡すより、観点を絞ったほうが使いやすくなります。
- 例外ケースを中心に見る
- セキュリティ境界を中心に見る
- テスト不足を中心に見る
- 既存設計とのズレを見る
- public APIの互換性を見る
大きいPRは分ける
AIレビューで大量にコメントが出るPRは、人間にも読みにくいPRであることが多いです。AIを使う前に、リファクタ、仕様変更、テスト追加、移行処理を分けられないか見ます。
AIコメントをそのまま修正指示にしない
- 1分類
bug、style、test、questionに分けます。
- 2確認
再現性と影響範囲を人間が見ます。
- 3採用
修正するものだけIssueやtaskへ落とします。
- 4却下
誤検知理由を残します。
AIコメントは命令ではなく、レビュー材料として扱います。
AIレビューのコメントは、修正命令ではありません。人間reviewerが見る材料です。特に、セキュリティ、権限、仕様、パフォーマンス、互換性の指摘は、正しいかどうかを確認してから扱います。
コメントを分類する
AIコメントは、次のように分類します。
| 分類 | 扱い |
|---|---|
| bug | 再現性を確認し、修正するか決める |
| security | 影響範囲と悪用可能性を確認する |
| test | 必要なテストか、過剰かを判断する |
| style | チーム規約に照らして採用/却下する |
| question | PR authorが回答する |
| false positive | 却下理由を残す |
採用/却下の理由を残す
導入初期は、AI指摘に対して「修正した」「別Issueにした」「却下した」を記録します。これを残すと、AIレビューが本当に役に立っているか見えます。
条件
重要度が高い指摘だけを残したい場合は、AIコメントをすべて必須対応にしません。人間reviewerがtriageし、対応が必要なものだけPR上で追います。
注意点
AIコメントが多すぎると、reviewerが読まなくなります。ノイズが増えてきたら、対象PR、対象path、指示、起動条件を絞ります。
人間レビューで残す判断
その挙動でよいかを判断します。
互換性、運用、顧客影響を受け入れるか決めます。
CODEOWNERSや担当者が承認します。
今直すか、別Issueへ送るか決めます。
AIが見つけた指摘をどう扱うかは、人間レビューの仕事です。
AIレビューを入れても、人間レビューで残す判断があります。
仕様判断
実装が仕様に合っているか、仕様自体が正しいかは、人間が判断します。AIは矛盾候補を見つけられても、プロダクト判断までは引き受けられません。
リスク受容
互換性を壊す、migrationを入れる、権限を変える、課金処理に触る、外部通信を増やす、といったPRでは、リスクを受け入れる判断が必要です。
CODEOWNERSの承認
CODEOWNERSは、pathごとの責任者レビューを要求する仕組みです。AIレビューが入っても、owner reviewを省略しないほうが安全です。特に、認証、セキュリティ、インフラ、DB、課金、モバイルリリースまわりは責任者レビューを残します。
優先順位の判断
AIが「直すべき」と指摘しても、今直すか、別Issueにするか、今回は受け入れるかは人間が判断します。すべてをPR内で直すと、PRが大きくなり、別のリスクを生むことがあります。
レビュー品質を測るログ
| 項目 | 内容 | 見方 |
|---|---|---|
| 採用率 | AI指摘のうち実際に修正した割合。 | |
| 誤検知率 | 却下した指摘の割合と理由。 | |
| 見落とし | merge後に人間が見つけた問題。 | |
| 時間 | レビュー開始からmergeまでの変化。 |
コメント数ではなく、採用された有用指摘で見ます。
AIレビュー導入後は、コメント数ではなく、レビュー品質の変化を見ます。
| 指標 | 見方 |
|---|---|
| 採用率 | AI指摘のうち実際に修正した割合 |
| 誤検知率 | 却下された指摘の割合と理由 |
| 見落とし | AIも人間も見逃したmerge後の問題 |
| レビュー時間 | PR作成から初回レビュー、mergeまでの時間 |
| 重大指摘 | security、data loss、互換性破壊の検出 |
| ノイズ | styleだけ、好みだけ、重複コメントの量 |
週次で見る
1PRごとに一喜一憂するより、週次でまとめて見ます。AI指摘が多いのに採用率が低いなら、指示や対象PRを見直します。採用率が高くても、見落としが減っていないなら、レビュー観点がずれている可能性があります。
人間レビューの時間も見る
AIレビューの目的は、人間reviewerを消すことではありません。人間が仕様やリスクに集中できるようになったかを見ます。コメント処理に時間を取られすぎるなら、AIレビューは逆効果です。
導入初週の進め方
- 1日目
read-onlyの手動レビューから始めます。
- 2日目
指摘分類ラベルを決めます。
- 3日目
小さいPRでAIレビューを試します。
- 5日目
人間レビューとの差分を記録します。
- 7日目
自動起動する条件を決めます。
最初は便利さより、誤検知と見落としの把握を優先します。
AIレビューは、いきなり全PRへ自動適用しないほうが扱いやすいです。最初の1週間は、対象を小さくして、誤検知と見落としを測ります。
1日目: 手動レビューから始める
小さいPRを選び、手動でClaude Code ReviewやCopilot Code Reviewを試します。人間reviewerの前にAIレビューを走らせ、出たコメントを分類します。
2日目: 指摘分類を決める
bug、security、test、style、question、false positiveのように分類を決めます。PR templateやreview checklistに、AI指摘の扱い方を追記します。
3日目: 小さいPRで複数回試す
UI変更、API変更、test修正、refactorなど、小さなPRで試します。大規模PRや緊急hotfixは最初の対象から外します。
5日目: 人間レビューとの差分を見る
AIが見つけたが人間が見落としたもの、人間が見つけたがAIが見落としたもの、AIの誤検知を記録します。
7日目: 自動起動の条件を決める
有用だったPRタイプだけ、自動起動にします。対象branch、対象path、PRサイズ、label、reviewer、CODEOWNERSとの関係を決めます。
この導入順は、Claude CodeをGitHub Actionsで動かす前にで扱ったtriggerやpermissionsの分離とも相性がよいです。最初は手動、次に限定自動化、最後に対象拡大という順にします。
失敗時に見直す条件
style指摘ばかりで重要指摘が埋もれる。
AIが見たからOKという空気になる。
大きい差分をAI任せにする。
ログやコメントにsecret疑いが出る。
レビューが楽になるより先に、品質が落ちていないかを見ます。
AIレビューを入れたあと、次の状態が出たら設定を見直します。
| サイン | 何が起きているか | 見直すこと |
|---|---|---|
| ノイズが多い | 重要指摘が埋もれる | 指示、対象path、起動条件を絞る |
| 誤検知が多い | チーム文脈を読めていない | custom instructionsや規約文書を整える |
| 見落としが多い | 観点がずれている | セキュリティ、テスト、仕様観点を分ける |
| レビュー責任が曖昧 | AIが見たからOKになる | CODEOWNERSとapprovalを残す |
| PRが大きくなる | AI任せで差分分割が遅れる | PRサイズ制限を入れる |
| 機密が混ざる | ログやコメントへsecret疑いが出る | 対象PRと入力ログを制限する |
AIレビューが弱いのではなくPRが大きすぎる場合もある
AIレビューの品質が低く見えるとき、原因がAIではなくPRの大きさにあることがあります。仕様変更、リファクタ、テスト追加、migrationが混ざっているPRでは、人間もAIも難しくなります。
custom instructionsを増やしすぎない
規約をAIへ伝えることは大事ですが、長すぎる指示は運用しにくくなります。まずは、禁止事項、重要な設計原則、テスト方針、セキュリティ境界のように、レビュー品質に効くものから置きます。
実務で使うなら
| 項目 | 内容 | 見方 |
|---|---|---|
| 対象PR | 小規模、テスト付き、owner明確なPRから始めます。 | |
| 除外PR | 緊急hotfix、secret、顧客ログ、大規模移行は除外します。 | |
| 必須レビュー | CODEOWNERSや責任者approvalは残します。 | |
| 記録 | AI指摘の採用/却下理由を残します。 |
AIレビューは、既存のレビュー責任を補強する位置に置きます。
チームでAIレビューを使うなら、導入前に次の表を埋めると迷いにくくなります。
| 項目 | 初期設定の例 |
|---|---|
| 対象PR | 500行未満、テスト付き、ownerが明確なPR |
| 除外PR | 緊急hotfix、secret、顧客ログ、大規模migration |
| AIに見る観点 | bug、例外ケース、test不足、security候補 |
| 人間が見る観点 | 仕様、risk、互換性、優先順位、merge可否 |
| 必須承認 | CODEOWNERS、security owner、release owner |
| ログ | 採用/却下、誤検知、見落とし、レビュー時間 |
レビューコメントの扱いを決める
AIコメントに全部返信するのか、重要コメントだけ対応するのか、誤検知はどう閉じるのかを決めます。決めていないと、PR authorがAIコメント処理に追われます。
AIレビューをレビュー教育に使う
AIレビューは、若手reviewerの補助にも使えます。AIが出した指摘をそのまま信じるのではなく、「なぜ採用するか」「なぜ却下するか」を人間reviewerが説明すると、チームのレビュー基準が揃いやすくなります。
FAQ
AIレビューをapproval代わりにしません。
最初は対象を絞ります。
分割を優先します。
採用/却下を人間が判断します。
迷ったら、レビュー責任が曖昧になっていないかを見ます。
AIレビューが通ったら人間レビューを省略してよいですか
省略しないほうが安全です。AIレビューはレビュー材料であり、merge可否や仕様判断の承認ではありません。CODEOWNERSや責任者approvalは残します。
全PRで自動起動してよいですか
最初は対象を絞ります。小さいPR、テスト付きPR、ownerが明確なPRから始め、採用率と誤検知を見て広げます。
Claude Code ReviewとCopilot Code Reviewはどちらを使うべきですか
チームのGitHub運用、既存のCopilot契約、Claude利用範囲、custom instructions、管理設定、出力の読みやすさで決めます。勝敗より、レビュー責任を壊さず運用できるかを見ます。
AIコメントが多すぎるときはどうしますか
対象PR、対象path、レビュー観点、style指摘の扱いを絞ります。コメント数を増やすより、採用される指摘を増やす設定にします。
セキュリティレビューもAIに任せられますか
候補の洗い出しには使えますが、リスク受容や修正優先度は人間が判断します。認証、権限、secret、顧客データ、外部通信を含むPRでは、人間のsecurity reviewを残します。
参照した主な情報源
- https://code.claude.com/docs/en/code-review
- https://docs.github.com/en/copilot/how-tos/agents/copilot-code-review/using-copilot-code-review
- https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions
- https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests
- https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
次に読むなら
更新履歴
- 2026年5月31日
Claude Code Review、GitHub Copilot Code Review、GitHub PR review / CODEOWNERS公式Docsを確認して初版を作成しました。
導入時には最新Docsと組織設定を再確認してください。
- 2026年5月31日: Claude Code Review、GitHub Copilot Code Review、GitHub PR review / CODEOWNERS公式Docsを確認し、初版を作成しました。
