本文へスキップ
hdknr blog

必須コードレビューの代替

全件必須のコードレビューをやめるとき、レビューが担っていた 8 つの役割をテスト・CI・静的解析・本番の安全網・人の仕組みに割り振り、高リスクな変更だけ人が見る形を必須ステータスチェックで強制する

概要

AI がコードを書く速度に人間のレビューが追いつかず、レビューは多くのエンジニアにとってボトルネックかつ苦痛になっている。XP の原則でいえば Mutual Benefit(相互利益)の問題である(エクストリーム・プログラミング)。

ただしレビューは複数の役割の束なので、廃止するなら役割を分解して、それぞれに代替手段を割り当てる必要がある。欠陥・規約・セキュリティは自動化でかなり補えるが、設計の一貫性・知識共有・育成は自動化しにくく、人の仕組みを別枠で用意する。現実的な落とし所は全廃ではなく「高リスクな変更だけ人がレビューする」形である。

詳細

レビューの価値はバグ取りだけではない

Microsoft Research の調査(Bacchelli & Bird, ICSE 2013)では、開発者がレビューに期待する一番の役割は欠陥の発見だったが、実際に得られていたのは知識共有・チーム内の状況把握・別解の発見が中心だった。バグ取りだけを見ると、廃止したときに何が抜けるかが見えない。

8 つの役割と代替手段

#役割主な代替手段XP の対応
1欠陥の発見テストを先に書く、CI で全テスト、ミューテーションテストで質を確認Test-First、CI、Ten-Minute Build
2規約・スタイルlinter / formatter を CI で強制、pre-commit—
3セキュリティ・危険な変更SAST、依存関係スキャン、シークレット検出、危険なパスだけ人が必須Redundancy
4設計の一貫性ADR、アーキテクチャテスト、AI 向けルールファイルIncremental Design
5知識共有・属人化防止ペアプロ・モブプロ、マージ後に読み合う会、変更要約の共有Pair Programming、Shared Code
6若手の育成ペアプロ、レビューとは別のメンタリング時間Pair Programming、Humanity
7本番障害の防止フィーチャーフラグ、カナリア、監視、即時ロールバックDaily / Incremental Deployment
8責任の所在作者がマージの責任を負い、障害は根本原因分析で仕組みにAccepted Responsibility、Root-Cause Analysis

1〜3 と 7 は機械やデプロイの仕組みに移しやすく、2 はそもそも人が見る必要がない。4〜6 は人の仕組みでしか補えず、8 はチームの約束事である。XP の Redundancy のとおり、外した穴を 1 つの手段で埋めず複数を重ねる。

人が見ていたことを CI に移す

人が見ていたこと機械の検証例
書き方の規約linter / formatterESLint、Ruff、Prettier
型の整合型チェックtsc、mypy
層の依存ルールアーキテクチャテストArchUnit、dependency-cruiser、import-linter
脆弱性静的解析・依存スキャンCodeQL、Semgrep、Dependabot
秘密情報シークレット検出gitleaks、Secret scanning
テストが効いているかミューテーションテストStryker、mutmut、PIT

最後の行が AI 時代には特に重要。LLM はテストを通すためにテスト側を書き換えることがあるので、「緑」だけでは品質の担保にならない(ミューテーションテスト)。「テストも書いて」ではなく「テスト駆動で実装して」と指示するのも効く。

全件必須から「リスクに応じて必須」へ

この振り分けを人の判断に任せないのが要点。「今回は小さいから不要」と作者が決められると抜け道になる。

GitHub の標準設定では作りにくい。「Require review from Code Owners」は承認数と組み合わせて働き、承認数を 1 以上にすると CODEOWNERS 対象外の PR にも承認が要り、0 にするとコードオーナーのレビューが強制されなかったという報告がある。そこで振り分けを必須ステータスチェックとして実装する。

  1. Actions で PR の変更ファイルを取得する
  2. 高リスクなパスに触れていなければ成功させる
  3. 触れていれば担当チームの承認を API で確かめ、無ければ失敗させる(pull_request_review でも起動して再評価)
  4. ルールセットは承認数 0 のまま、このチェックを必須にする

チームの所属確認には組織のチーム情報を読む権限が要り、既定の GITHUB_TOKEN では足りない可能性が高い(GitHub App か権限を絞ったトークン)。フォークや Dependabot の PR ではトークンが読み取り専用でシークレットも渡らないので、その場合の振る舞いも決めておく。CODEOWNERS はレビュー依頼の自動化用に残せる。設定の組み合わせで挙動が変わりうるので、テスト用リポジトリで「低リスクは承認なしでマージでき、高リスクは止まる」を実際に確かめてから入れる。

AI レビューを入れるときの注意

別系統の AI レビューを重ねる(CodeRabbit)

CodeRabbit は、GitHub や GitLab の PR に自動でレビューコメントを付ける AI レビューサービスである。cc-sdd を軸にした開発フローの事例では、エージェント内部のレビュアーが仕様・設計に沿っているかを作業の途中で確かめ、PR として出てきた差分を CodeRabbit が外側からもう一度見る。実装したエージェントとは別の仕組みでレビューさせることで見落としの重なりを減らす狙いで、「人が指摘しなくても AI が全部指摘してくれるようになれば人のレビューは要らなくなる」という方向につながる。

その事例の原則は、人間のゲートを実装後ではなく計画(仕様と設計)の段階に寄せる、書く役と見る役を分けて別系統のレビューを重ねる、機械的に検出できる問題(悪性パッケージ・規約違反・アーキテクチャの逸脱)はツールとエージェントのループで潰して人間はリリース判断に集中する、の 3 つ。悪性パッケージの側は Takumi Guard のようにインストール経路に関所を置く。

外部 bot のコメントを自分のループに取り込むなら、関門には格上げせず信頼できない入力の 1 つとして指摘の採否表に載せるのが安全である(要求仕様書作成ループ)。

いちばん失われやすいのは知識共有

廃止すると「チームの誰もそのコードを読んでいない」状態が生まれる。レビューをマージを止める関門と知識を共有する場に分け、前者は自動化と振り分けで軽くし、後者は別枠で残す。

必須レビューをやめることは品質への要求を下げることではなく、人の注意という限られた資源を、本当に人が見るべき変更とチームの知識を育てることに振り向け直すことである。

関連ページ

ソース記事