本文へスキップ

AIによるコードレビューは役に立つのか?

公開日

開発生産性
AIによるコードレビューは役に立つのか?
•••

近年のソフトウェア開発では、GitHub CopilotやCursorなどのAIエージェントがプルリクエスト(PR)に対して自動でコードレビューコメントを生成する運用が普及しつつあります。しかし、こうしたAIによる指摘を開発者が実際にどのように受け止め、修正(解決)へ至らせているのかについての詳細な調査は限られていました。

本記事では、カナダのサスカチュワン大学やシンガポールマネジメント大学などの研究チームが発表した論文「“Go Home Copilot, You’re Drunk”: Understanding Developer Responses to Agent-Generated Code Review Comments」をもとに、AIによる効果的なレビューの特徴を解説します。

調査の概要:341リポジトリ・5万件超のAIレビューコメントを分析

この研究では、AIエージェントが自動生成したコードレビューコメントに対して、開発者がどのように反応しているかを定量・定性の両面から調査しています。

対象となったのは、GitHubで公開されている一定規模以上(1,000スター以上、1,000PR以上、50名以上のコントリビューターなど)のオープンソースプロジェクトです。

分析対象として選定された主なAIエージェントと、収集されたコメント数は次の通りです。データ件数が極めて少なかったエージェント(Devin: 50件、Claude: 28件)を比較から除外し、最終的に3つのエージェントによる54,713件のコメントが分析に使用されました。

  • GitHub Copilot
  • Cursor
  • OpenAI Codex

研究チームは、これらのコメントを機能バグや設計、ドキュメントなど15種類のカテゴリに分類し、LLM(LLaMA-3.1-70B)を用いた自動分類と人間による手動検証を組み合わせて分析を行いました。

エージェントごとに異なる解決率と指摘カテゴリの偏り

調査の結果、AIエージェントによって開発者に指摘が解決(採択)される割合や、得意とする指摘の範囲に明確な差が見られました。

表1:エージェントごとのコメント数と解決率

エージェント分析コメント数解決されたコメント数解決率
Copilot45,66833,26572.9%
Cursor6,7784,55467.2%
Codex2,2671,24254.8%

全体としてCopilotが最も多く利用されており、解決率も72.9%と高水準でした。また、Copilotが解決されたコメントのカテゴリ割合を見ると、代替実装の提案(21.8%)、ドキュメント改善(19.8%)、機能バグ(18.1%)などにバランスよく分散していました。

一方で、CursorおよびCodexでは、解決されたコメントの大部分(いずれも約88%)が「機能バグ」に関するものでした。その他のカテゴリ(リソース管理やロジックエラーなど)に関する指摘は数パーセントにとどまっており、エージェントごとの運用目的や検出機能の特性が反映されていると考えられます。

図1:エージェントごとの解決されたコメントのタイプ別割合 図1:エージェントごとの解決されたコメントのタイプ別割合

開発者の経験度合いによるAIレビューへの対処と未解決の理由

研究チームは、PR作者のプロジェクトにおける過去の貢献量(作成およびレビューしたPR数)を基準に、上位20%をコア開発者(Core)、残りを周辺開発者(Peripheral)に分類し、どちらのグループがAIの指摘を解決しているかを比較しました。

経験豊富な開発者ほど設計・構造の指摘に対応

分析の結果、解決されたコメントの過半数はコア開発者によって対処されていることがわかりました。特にCopilotによる指摘では、解決されたコメントの78.1%がコア開発者によるものでした。

カテゴリ別に見ると、コードの構造化、命名規則、設計に関する議論、代替実装の提案といった、プロジェクト全体の構造やルールへの理解が必要な指摘ほど、コア開発者が解決する割合が高くなっていました。一方で、機能バグに関する指摘では、周辺開発者の寄与率が約30%まで上昇していました。

図2:開発者の役割別の解決されたコメント割合 図2:開発者の役割別の解決されたコメント割合

コメントが未解決のまま残る理由

開発者がAIの指摘を受け入れず、スレッドが未解決のまま終了したケース(サンプル470件)に対してカードソーティングを行ったところ、開発者が返信で示した拒否理由として主に以下のパターンが特定されました。

  1. 意図的な設計判断:プロジェクト固有の制約やパフォーマンス上の理由、既存の設計方針に基づいて現状のコードを維持したケース。コア開発者による拒否理由の約72%(112件中81件)を占めました。
  2. 誤った指摘・事実誤認:AIがコードの文脈を正しく理解できず、存在しないバグを指摘したり、誤ったロジックを提案したりしたケース(67件)。
  3. AIの指摘への疑問:指摘の必要性や根拠に対して開発者が疑問を呈し、AIに再確認を求めたり懐疑的な返信をしたりしたケース(39件)。

特に、Cursorの返信スレッドでは「意図的な設計判断」による拒否が32%を占め、Codexでは「誤った指摘」による拒否が20.6%と高めでした。AIエージェントがプロジェクト全体のコンテキストを十分に把握しきれていないことが、指摘が受け入れられない主要な原因となっています。

開発者に受け入れられるAIレビューコメントの特徴

どのようなコメントが開発者にとって有用であり、解決に至りやすいのかを調べるため、研究チームはロジスティック回帰分析を実施しました。依存変数を「解決されたかどうか(有用性)」とし、コメントの各種特徴を独立変数として分析しています。

表2:有用なコメントの予測因子に関するロジスティック回帰分析

予測因子(変数)係数(Coef.)オッズ比(OR)p値概要
インラインコード提案の有無0.4811.617<0.001直接適用可能なコードブロックが含まれる
コメント長(対数)-0.0770.926<0.001文字数が長いほど解決率がやや低下
説明の有無-0.5220.593<0.001単に説明文が存在するだけでは負の影響
規則(Rule)に基づく説明0.1341.144<0.001規約やガイドラインを引用した説明
メリット(Benefit)の説明0.0841.0870.0001変更による効果やメリットを記述
例示(Example)による説明0.0771.0800.0126参考例や類似パターンを提示

分析結果から、次の傾向が確認されました。

インラインコード提案が最も強力な要素

最も強力な正の予測因子は、GitHubの suggestion 構文を用いたインラインコード提案の存在でした(オッズ比 1.617)。直接適用可能なコードが提示されている場合、開発者がその提案を採用して解決する確率は大幅に高まります。この傾向は、機能バグと構造改善のどちらのカテゴリでも共通して確認されました。

冗長な文章よりも具体的な根拠

コメントの長さは解決に対してわずかに負の影響を与えており(オッズ比 0.926)、特に機能バグの指摘において文章が長すぎると受け入れられにくくなる傾向が見られました(オッズ比 0.855)。

また、単に文章で説明を添えるだけでは解決率の向上に結びつきにくいものの、説明の「質や形式」が適切な場合には効果を発揮することが分かりました。特に「規約やルールに基づく説明」「変更のメリットの説明」「具体例の提示」が含まれているコメントは、解決される確率を高める要素となっています。

開発チームでAIレビューツールを活用する際のポイント

本研究のデータから、開発チームがAIレビューツールを運用・導入する際に参考となる考え方が導き出されます。

1. 修正コード(suggestion)の提示を優先する設計

AI生成コメントの有用性を高める最も有効な手段は、テキストによる解説だけでなく、ワンクリックで適用可能なコード差分を提示することです。AIツールのプロンプト設定やカスタムエージェントの構築を行う際は、可能な限りインラインコード提案を出力形式に含める設定が推奨されます。

2. プロジェクト固有のコンテキスト共有の重要性

開発者がAIの指摘を拒否する最大の理由は「プロジェクト固有の意図的な設計判断」でした。広範なリポジトリ構造や過去の議論経緯をAIに読み込ませるコンテキスト拡張や、プロジェクトのアーキテクチャ方針をプロンプトや設定ファイル(CONTRIBUTING.md.github/ 配下の規約ファイルなど)で明示することが、誤った指摘(ノイズ)の削減に役立ちます。

3. 開発者の役割に応じたAIのサポート

コア開発者は設計やアーキテクチャの一貫性を重視する一方、周辺開発者はバグ修正などの機能的指摘をAIの助けを借りながら解決する傾向が示されました。経験の浅いメンバーや新規コントリビューターに対しては、具体例や修正コードを提示するAIレビューが補助ツールとして機能しやすくなります。

ただし、本調査はGitHub上のオープンソースを対象としており、社内開発や別言語の環境へそのまま当てはまらない可能性がある点や、解決ステータスが必ずしもコード品質の直接的な向上を意味しない点には留意が必要です。

まとめ

本論文では、341リポジトリ・5万件以上のデータからAI生成コードレビューコメントに対する開発者の反応を分析しました。主なポイントは以下の通りです。

  • エージェントごとの特徴:Copilotは高解決率(72.9%)で幅広い領域をカバーし、CursorやCodexは機能バグの指摘に特化する傾向が見られました。
  • 開発者の経験度による役割:コア開発者は設計・構造面のAIレビューを多く解決し、不適切な指摘も設計意図に基づいて正しく却下していました。
  • 有用性を高める要素:インラインコード提案の付与が最も効果的であり、説明を加える場合は長文を避けて「ルール・メリット・具体例」に絞ることが推奨されます。

AIレビューツールをチームへ導入・カスタマイズする際は、単に指摘を自動生成させるのではなく、開発者が素早く判断・適用できる形式で提示されているかを意識することが有効です。


開発生産性やチームビルディングにお困りですか? 弊社のサービス は、開発チームが抱える課題を解決し、生産性と幸福度を向上させるためのさまざまなソリューションを提供しています。ぜひお気軽にご相談ください!

参考資料:

執筆・編集: vonxai編集部

Google Scholarで開発生産性やチーム開発に関する論文を読むことが趣味の中の人が、面白かった論文やレポートを記事として紹介しています。