AIによるコードレビューをCIに組み込む

レン

コードの変更が来るたびに、AIが自動でレビューしてくれる仕組みを作りたい！

プロクラ

できるよ。CI（コードを変更するたびに自動で走る仕組み）にAIへの問い合わせを組み込んで、変更内容を渡して気になる点を指摘させる、という形で作れる。

VPSで動かす場合の役割

• CIから変更内容を受け取り、AIに渡して結果をまとめる窓口を用意する
• 結果を、変更内容へのコメントとして返す仕組みを作る
• 常に動いている必要はなく、変更があったときだけ動けばよい

レン

AIのレビューがあれば、人がレビューしなくてもよくなる？

プロクラ

そこは誤解しないでほしいところだよ。AIは表面的な問題（書き方の癖、よくある間違い）には気づきやすいけど、『この変更が業務としてなぜ必要か』のような文脈は理解していない。人によるレビューの代わりにはならないんだ。

うまく組み込むための線引き

AIレビューは、人のレビューの手間を減らす補助として位置づけるとうまくいきます。細かい指摘をAIに任せ、人は設計や意図の妥当性に集中する、という役割分担です。AIの指摘を鵜呑みにして機械的に修正するのではなく、最終判断は人が行う前提を崩さないでください。

• AIの指摘は『提案』として扱い、そのまま自動で反映しない
• 重要な変更ほど、人によるレビューを省略しない
• AIへ渡すコードに、外部に出せない情報が含まれていないか確認する

プロクラ

自動でチェックが入ること自体は心強いよ。ただ、それに安心しきって人の目を減らしてしまうと、AIが見落とした部分を誰も見なくなる。あくまで二重のチェックとして考えてね。

レン

AIの指摘が的外れなことも多い場合、どう扱えばいい？

プロクラ

的外れな指摘が多いなら、渡している情報が足りていない可能性があるよ。変更点だけでなく、プロジェクトの規約や背景も一緒に渡すと、指摘の的確さが変わることが多い。それでも改善しないなら、指摘の対象を絞る設定を見直してみて。

プロクラ

自動化できる部分を機械に任せて、人にしかできない判断に時間を使う。AIレビューをCIに組み込む一番の意味は、そこにあるんだと思うよ。

プロクラ

小さく始めて、実際の指摘の質を見ながら調整していくのがおすすめだよ。最初から完璧な設定を目指さなくても、使いながら育てていける仕組みだからね。

指摘の対象を絞り込む

変更されたコード全体を毎回丸ごとAIに渡すと、費用がかさむだけでなく、関係の薄い指摘まで増えて読む側の負担が上がります。変更された箇所とその前後だけを渡す、対象のファイルの種類を絞る、といった工夫で、指摘の量と関連性のバランスを取ることができます。まずは狭い範囲から始めて、必要に応じて対象を広げてください。

• 変更された箇所とその前後だけを渡し、無関係な指摘を減らす
• 対象にするファイルの種類（コードのみ、設定ファイルは除くなど）を決めておく
• 指摘が多すぎる場合は、重要度の高いものだけ表示するよう絞り込む

レン

AIは気づきの補助、最終判断は人。役割をはっきりさせるんだね。