目次

AIが生成したコードを明確な品質基準に照らしてレビューし、影響が大きい変更、複雑な変更、不確実性の高い変更に人の注意を集中させましょう。実装やレビューを自動化しても、結果に対する責任が移るわけではありません。

要点#

  • 変更を説明し、根拠を評価し、問題が起きたときに対応できる人を責任者にする。
  • 繰り返し確認できる要件には自動チェックを使い、重大な判断や曖昧な判断には人が踏み込んでレビューする。
  • 読みやすい差分だけで十分な根拠とせず、権限や障害時の処理も含め、ユーザーに提供される動作をレビューする。
  • インシデント、製品の変更、外部要件によって不足が明らかになったら、品質基準を更新する。

まず責任者を決める#

古川陽介氏は、10月28日のQiita Conference 2026 Autumnでの講演で、コードレビューは今も重要だと述べる一方、すべての行に同じだけ人の注意を向ける必要があるのかと問いかけています。実務上の重要な区別は、チェックを自動化することと、責任を引き受けることの違いです。

チームはAIでコードを書き、レビューしながら、結果に対する責任を人に持たせることができます。その人が実装の細部をすべて覚える必要はありません。ただし、根拠を評価し、不確実性を認識し、修正を調整できるだけの理解は必要です。

マージ前に、責任者を1人決めましょう。その人に2つの問いへの回答を求めます。この変更が要件を満たすと示す根拠は何か。その根拠が不十分だと分かったら、どうするのか。「AIが生成したから」は、どちらの答えにもなりません。

リスクに応じてレビューの深さを決める#

すべての変更を同じ密度で読むのは、注意の配分として非効率です。文言の修正とアカウント復旧の変更に、同じレビュープロセスを適用すべきではありません。必要な人のレビューの程度を決める前に、変更を分類しましょう。

次の4つを問いかけます。

  • 影響: 不具合によって、データの漏えい、資金の移動、アクセス権の喪失、重要なサービスの停止が起こり得るか?
  • 複雑さ: 複数のサービスにまたがるか、並行処理を導入するか、永続化されたデータを変更するか?
  • 曖昧さ: 期待する動作と受け入れ基準は、テストできるほど明確か?
  • 復旧: チームは不具合をすぐに検知し、変更を安全に元に戻せるか?

要件が明確で、元に戻せる小さな変更なら、チームで合意した方針に基づき、自動チェックだけで済ませられる場合もあります。決済の変更や不明確な権限ルールは、人が直接レビューすべきです。大きなアーキテクチャ上の判断では、生成されたコードが整って見えても、その前提と影響をレビューする必要があります。

基準に照らして動作を確認する#

「妥当に見える」は、リリース基準として不十分です。AIに変更の実装や評価を依頼する前に、観測可能な要件を定義しましょう。同じ曖昧な指示から、誤った実装と、それを自信満々に承認するレビューの両方が生まれる可能性があります。

パスワードリセット機能なら、最低限のチェックリストとして、次の4つの要件が考えられます。

1. リセット用トークンは、製品で定めた時間が経過すると失効する。 2. 使用に成功したトークンは再利用できない。 3. あるアカウント向けに発行されたトークンで、別のアカウントをリセットできない。 4. 応答から、そのメールアドレスに対応するアカウントの有無が分からない。

これらの要件は、自動テストと人による確認の指針になります。メール配信事業者が利用できない場合、リクエストが中断された場合、トークンが同時に送信された場合など、失敗時の処理も確認しましょう。テストの成功はリリース判断を支えますが、要件自体に漏れがないことまでは証明しません。

自動化で判断の根拠を示す#

フォーマット、型チェック、依存関係の既知の脆弱性、受け入れ基準に対応したテストなど、合格条件が明確なチェックを自動化しましょう。AIレビューは追加の懸念を見つけられますが、その承認だけを証拠にすべきではありません。

意図する動作、影響を受けるコンポーネント、チェック結果、未解決の疑問を、簡潔な資料としてレビュアーに渡しましょう。重大な変更では、復旧手順と、それを実行する判断の目安も含めます。これにより、差分から目的を読み解き直さなくても、変更を評価できます。

不具合を見逃したら、コードとともに検証プロセスも改善しましょう。不足していたテストを追加する、要件を明確にする、エージェントのツールや制約を調整する、といった対応です。そうしなければ、次に生成される変更でも同じ間違いを繰り返す可能性があります。

基準を最新に保つ#

品質基準は、継続的に見直すべき製品上の判断です。新たに公表された脆弱性、顧客層の変化、アクセシビリティ要件によって、それまで受け入れられていた動作が不十分になることがあります。既存のコードにもレビューが必要かもしれません。

古川氏の講演は、この基準の変化を強調しています。ただし、発表に登場する具体的な脆弱性の名称や悪用に関する主張は、チームが緊急度の判断に使う前に、一次情報であるセキュリティアドバイザリと照合する必要があります。影響を受けるバージョン、外部からの露出状況、利用可能な緩和策、悪用の証拠に基づいて対応を決めましょう。

関連する変化の監視と、インシデントや製品の大きな変更後のチェックリスト見直しについて、責任者を決めましょう。昨日のチェックが今日のユーザーを今も守れているかを判断するには、人の判断が引き続き必要です。

次の一歩#

次のプルリクエストでは、マージ前に4行のレビューメモを追加しましょう。人の責任者、期待する動作、検証の根拠、復旧時の対応を記載します。

出典: https://speakerdeck.com/yosuke_furukawa/ai-ga-kodo-o-kai-te-kureru-jidai-wareware-ha-nani-o-tashikameru-no-ka

目次