AIにコードを書かせて分かった、人間がレビューすべき7つのこと

AIコーディングエージェントが生成したコードを人間がレビューする際に注目すべき7つの点を解説する記事。生成速度の向上によりレビューが難化している現状を踏まえ、要件との差異や潜在的リスクを見抜くための確認ポイントを示す。

• AIによるコード生成では、人間によるレビューが不可欠であり、特に要件解釈、変更範囲の妥当性、権限・データ境界、失敗時の振る舞い、テストの正確性などを確認する必要がある。
• AIは曖昧な指示からでも推測してコードを生成するため、生成されたコードの前に「この変更を一文で説明して」とAIに問い、Issueの目的と比較することが方向違いの早期発見に役立つ。
• AIが機能追加と同時に周辺コードの整理や依存関係の更新を行う場合、レビュー対象と障害時の切り戻し範囲が広がるため、機能追加とリファクタリングは別タスクとして任せる方が安全である。
• AIが生成したコードは正常系では動くことが多いが、APIタイムアウト、再実行、プロセス中断、不正入力などの失敗時の振る舞いが設計されているかを確認することが重要である。
• AIが生成したテストコードは、実装の誤解を共有している場合、テストがすべて通っても要件を満たさない可能性があるため、テスト名、入出力検証、境界値・異常系の網羅性、意図的なバグでのテスト失敗確認が重要となる。