Claudeはレビューを行うと同時に受けもします。組織のポリシーに照らして受信したPRをレビューし、自身のPRに対するレビューコメントに対応します。これにより、エンジニアはPRレビューにおける振る舞いに集中できるようになり、それは結局のところ意図とリスクを判断することに帰着します。
何が変わるのか
| 従来型 | AIネイティブ |
|---|---|
| レビューのキャパシティは人間のアウトプットを前提に計画されます。PRはレビュアーがすべてを読むのを待ち、レビューの質はレビュアーの負荷によって変動し、バックログが増える中で作成者は催促を続けます。 | すべてのPRが同一のレビューパスを受け、検出事項は重要度でランク付けされます。人間の注意は一段上のレベル、すなわちその変更が計画の意図どおりであるか、リスクが許容範囲かどうかに移ります。 |
はじめに
- 前提条件: ステージ3: 構築で更新された
CLAUDE.mdファイル、レビューパスで成文化されたポリシーを強制する場合はSkills、そして定義済みのサブエージェント。 - インフラ: Claude連携がインストールされたリポジトリ。Claude組織のオーナーが有効化したマネージド型のCode Review(新しいタブで開きます)サービス、または自前のCIで動作するclaude-code-actionのいずれかで、必要に応じてAmazon Bedrock、Google CloudのVertex AI、Microsoft Foundryを通じたモデル呼び出しを行います(デプロイオプションについてはCI/CDのプレイを参照してください)。コードオーナーの承認を必須とするブランチ保護ポリシーも有用です。
実行方法
- マネージド型のCode Reviewサービスが最も手早く始められます。Claude組織のオーナーがこれを有効化し、対象リポジトリを選択します。パイプラインを自分で制御したい場合や、API呼び出しを自社のクラウド契約経由でルーティングしたい場合は、自前のCIでclaude-code-actionを使ってレビューを実行します(その配線についてはCI/CDのプレイを参照してください)。
- テックリードはレビューポリシーをリポジトリのルートに
REVIEW.mdとして記述し、組織が重視するパスごとに分けます。バグと論理エラー、セキュリティと脆弱性、仕様(要件定義のプレイからのspec.md)・実装計画(プランモードのプレイからのplan.md)・設計原則への準拠です。REVIEW.mdはまた、何がNitではなくImportantに該当するか、そして何をスキップすべきかも定義します。 - テックリードは人間の判断が必要となる閾値を設定します。検出事項はそれ単独でPRを承認したりブロックしたりすることはなく、ブランチ保護は依然としてコードオーナーの承認を要求します。検出事項に基づいてマージをゲートしたいプラットフォームエンジニアは、チェックランが公開する機械可読な重要度別件数を参照できます。
- レビュアーまたは作成者がレビューコメントで
@claudeをタグ付けすると、Claudeはそのコメントに対応し、修正をプッシュします。PRスレッドには依頼内容と変更内容の両方が記録されます。この修正ループはclaude-code-actionを通じて実行されます。マネージドサービスでは、@claude reviewとコメントすると代わりに新しいレビューが依頼されます。Claudeが開いたPRについては、さらに踏み込んでClaudeにPRをマージまで見守らせることもできます。チームはこのループをカスタムのスラッシュコマンドにまとめ、PR上の未解決のレビューコメントと失敗しているチェックを一掃し、対応して修正をプッシュし、PRがグリーンになってコードオーナーの承認待ちだけになるまで繰り返します。 - レビューの検出事項は
CLAUDE.mdにフィードバックされます。レビューが同じ誤りを2回目に指摘した場合、その修正はそのレビューの一部としてCLAUDE.mdに反映され、レビューはCLAUDE.mdを読むため、次のPR以降はその誤りが検出されるようになります。レビューはまた、変更によってCLAUDE.mdが古くなった場合にもそれを指摘します。 - 月に一度、テックリードは検出事項を評価してレビュアーを改善させ、
REVIEW.mdでNitの件数に上限を設けることでセットアップを調整します。生成されたパスや、CIがすでに強制しているものは除外されます。
実際の様子
REVIEW.md:
markdown
# Review instructions
## Passes
Run three passes and tag each finding with its pass:
- Bugs: logic errors, broken edge cases, subtle regressions
- Security: injection risks, authentication gaps, PII in logs
- Compliance: the change matches spec.md, plan.md and our design principles
## What Important means here
Reserve Important for findings that would break behavior, leak data
or breach a policy. Style and naming are nits.
## Cap the nits
Report at most five nits per review; summarize the rest as a count.
## Do not report
Generated files under src/gen/ and anything CI already enforces.以下の例は、保険会社の顧客ポータルにクレームステータスパネルを追加するプルリクエストに対してチェックランが列挙する内容です。ここでclaims-coreはポータルのバックエンドの背後にある、より古い社内システムです。
| 重要度 | ファイル:行 | 問題 |
|---|---|---|
| Important | portal/src/claims/StatusPanel.tsx:22 | コンプライアンス: パネルがレンダリングのたびにフェッチしている。plan.mdには、claims-coreが1秒あたり50リクエストしか許可していないため、キャッシュしなければならないと記載されている |
| Important | claims-api/routes/status.py:31 | セキュリティ: エラーパスがclaims-coreのレスポンス全体をログに記録しており、そこにはpolicy_holder_nameが含まれている |
| Nit | claims-api/tests/test_status.py:8 | バグ: 期待される日付がないpaidクレームをカバーするテストがない |
最初の検出事項は、コンプライアンスパスがコミット済みのplan.mdを読むからこそ存在するものであり、差分だけを見ているレビュアーにはこのファイルは開かれていないでしょう。
ガバナンス上の考慮事項
職務分掌は維持されます。なぜなら、コードを書いたエージェントにはそれを承認する手段がないからです。REVIEW.mdのレビューポリシーはすべてのPRに適用され、検出事項、修正、評価、承認はPR履歴に記録されるため、PRそのものが監査記録となります。承認は検出事項に基づいて、ブランチ保護を通じて人間から与えられます。
測定方法
- 先行指標: 最初のレビューまでの時間。これは数分まで短縮されるはずです。また、人間がブランチに触れることなく解決されたレビューコメントの割合で、データはGitに直接保存されます。
- 遅行指標: マージ前に検出された欠陥や脆弱性と、本番環境に漏れ出たものとの比較で、PR履歴とインシデントトラッカーから得られます。