コードを書き終えても、その意図をレビュアーに伝える依頼文や、後で読む人のためのドキュメントを書く作業が残ります。実装の集中が切れた後だと、この文章づくりは意外と億劫です。変更の要点さえ渡せば、依頼文やドキュメントの下書きはAIに任せられます。開発者は、技術的な正確さの確認に集中する。この分担で、レビューが回りやすくなり、記録も残しやすくなります。
手順1: 変更の要点をメモにする
まず、今回の変更で何を・なぜ変えたのかを短く書き出します。変更の目的、主な差分や実装のポイント、レビュアーに特に見てほしい観点をまとめます。ここが具体的なほど、依頼文が読み手に伝わるものになります。
手順2: チャットAIに依頼文の下書きを頼む
お使いのチャットAI（ChatGPT・Claude・Geminiなど）に、変更の要点を渡してレビュー依頼文の下書きを頼みます。読み手が確認しやすい構成を指定します。
以下のメモをもとに、コードレビュー依頼文（プルリクエストの説明）の下書きを作ってください。構成は次の順で。
1. 変更の背景・目的（なぜこの変更が必要か）
2. 主な変更点（箇条書き）
3. レビューで特に見てほしい点
4. 動作確認の内容（実施したテストなど）
メモにない実装の詳細は推測で補わず、「要記入」としてください。断定的な表現は避けてください。手順3: 技術的な正確さを開発者が確認する
出てきた下書きを、実際の変更内容と照らし合わせます。説明とコードが食い違っていないか、「要記入」の箇所を埋めながら確認します。AIがコード例や設定値を補っている場合は、そのまま信じず、実際に動くかを検証します。
手順4: ドキュメントにも展開する
依頼文が固まったら、同じ要点を使って、変更の記録や利用手順などのドキュメントの下書きも作れます。レビューで確定した内容を反映してから残すと、後で読む人の助けになります。
失敗しやすいポイント
生成AIは、実装の詳細を推測で補い、実際とは違う説明を自然な文章で書くことがあります。依頼文の説明とコードがずれていると、レビュアーを混乱させます。説明が実際の変更と一致しているかは、開発者が必ず確認してください。AIが出したコード例や設定値も、もっともらしく見えて動かないことがあるため、そのまま採用せず検証が必要です。加えて、APIキーや認証情報、社外秘のコードをそのままプロンプトに貼らないよう注意しましょう。外部のAIツールで社内コードを扱ってよいかは、社内ルールで確認してから進めるのが安全です。