AIへのレビュー依頼文例集:観点指定で精度を上げる
「このコードをレビューして」とだけ頼むと、AIは当たり障りのないコメントしか返さないことがあります。見てほしい観点を具体的に指定することで、レビューの精度は大きく変わります。実践的な依頼文例を紹介します。
最終更新: 2026-07-23・読了目安 約3分
「見て」だけでは精度が上がらない理由
AIコーディングエージェントに「このコードを見て」とだけ頼むと、命名や軽微な書き方など、無難で当たり障りのない指摘に留まりがちです。AIは何を重視すべきかの手がかりがないと、可もなく不可もない一般的な観点でコメントを作るためです。
これはAIが書いたコードのテストとレビューで触れた「鵜呑みにしない」姿勢の一歩先にある工夫で、レビューを依頼する側が観点を絞ることで、AIの注意をこちらが本当に不安な部分に向けさせることができます。観点を絞ってから頼む発想は、実装を頼むときのコーディング向けプロンプト実践で扱った「期待出力を具体的に書く」考え方とも共通しています。
観点を明示したレビューを重視する姿勢は、AI活用に限った話ではありません。Googleが公開しているコードレビューの実務ガイドでも、レビュアーが確認すべき観点を明確にすることの重要性が繰り返し説明されています(出典:Google Engineering Practices「The Code Reviewer's Guide」)。
観点別の依頼文例
目的別に依頼文の型を用意しておくと、そのつど言葉を考えずに済みます。
- 不具合の有無:「このコードにロジック上のバグがないか確認してください。特に、入力が空文字や未定義のときの挙動を重点的に見てください。」
- セキュリティ観点:「ユーザー入力を受け取る箇所で、想定外の値が渡されたときに問題が起きないか確認してください。」
- 可読性・保守性:「半年後に自分が読んでも意図がわかるか、という観点でコメントしてください。関数が長すぎる場合は分割案も提案してください。」
- パフォーマンス:「データ量が増えたときに遅くなりそうな処理がないか確認してください。」
- テスト観点:「このコードに対して、どんなテストケースが不足していそうか列挙してください。」
「重要度」も一緒に伝える
観点を指定した上でさらに一歩進めるなら、指摘の重要度を区別させる指示も有効です。「見つけた問題を、致命的(動作しない・データが壊れる)・注意(意図しない挙動の可能性)・提案(あった方が良い)の3段階に分けて報告してください」のように伝えると、優先順位をつけて確認しやすくなります。
すべての指摘を同じ重みで扱うと、軽微な指摘に気を取られて重大な問題を見落とすことがあります。重要度を分けさせることは、限られた確認時間を有効に使うための工夫です。
差分だけを対象にレビューさせる
ファイル全体ではなく、直近の変更差分だけをレビューしてほしい場合は、その範囲を明示することが重要です。「今回のコミットで変更した部分だけを対象に、既存の動作を壊していないかを確認してください」のように範囲を限定すると、無関係な既存コードへの指摘に脱線せず、変更点に集中したレビューが得られます。レビューで見つかった不具合の直し方はエラーをAIに直させる手順も参考になります。
よくある失敗パターン
- 観点を指定しない:「良い感じにレビューして」では、AIも人も何を重視すべきか分からない。
- 指摘を全部同じ重みで受け取る:軽微な提案まで全部直そうとして、時間ばかりかかる。
- レビュー結果を鵜呑みにする:AIの指摘が常に正しいとは限りません。指摘の理由を確認し、納得してから直すことが大切です。
- 対象範囲を伝えない:無関係なコードまでレビュー対象になり、本当に見てほしい部分の指摘が埋もれる。
よくある質問
Q1. AIにレビューを頼むとき、観点はいくつ指定すればよいですか?
一度に1〜2個に絞るのがおすすめです。不具合・セキュリティ・可読性・パフォーマンス・テストのすべてを同時に頼むと、指摘が総花的になり優先順位がつけにくくなります。今いちばん不安な観点から順に依頼すると、実用的な指摘が得られます。
Q2. AIのレビュー指摘はそのまま信じてよいですか?
信じきらず、指摘の理由を確認してから直すことが大切です。AIの指摘が常に正しいとは限らず、文脈を誤解した的外れな指摘が混じることもあります。納得できない指摘は「なぜそう考えたか」を聞き返すと精度が上がります。
Q3. 差分だけをレビューさせるにはどう伝えればよいですか?
「今回のコミットで変更した部分だけを対象に」のように対象範囲を明示します。範囲を伝えないと、無関係な既存コードへの指摘に脱線し、本当に見てほしい変更点への指摘が埋もれてしまいます。