GitHub PRレビューコメントの見方

レビューコメントは、全てを同じ扱いにせず、修正するもの、質問するもの、今回は保留するものに分けると進めやすくなります。

このページでわかること

  • コメントの対象行と意図を読む
  • 修正、質問、保留を分ける
  • resolvedにする前に差分と動作を確認する

まず確認すること

  • requested changesの範囲を確認する
  • Codexへ渡す時は対象コメントを明確にする
  • 返信文には対応内容と残した理由を書く

やってはいけないこと

  • 指摘を見落としたままcloseする
  • 無関係な大改造で返す
  • 確認せずにresolved扱いにする

安全寄りに進める手順

  1. 対象のrepo、branch、PR、Actions runを確認する。
  2. Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
  3. 必要な場合は値を停止または再発行し、影響範囲を整理する。
  4. 変更は小さなbranchとPRに分け、CIとreviewで確認する。

CodexやAI作業時の注意

AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。

公式情報で確認する領域

Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。

レビューコメントは「会話つきの差分確認」

PRのレビューコメントは、差分の特定の行に対して「ここはなぜこう変えたの?」「ここは戻してほしい」と、位置を指定して会話できる仕組みです。メールやチャットで「あのファイルのあの辺り」と説明する曖昧さがなくなり、指摘と修正の記録がPRに残るため、後から経緯を辿れます。1人運用でも、自分への申し送り(「ここは次回リファクタリング」等)を残す使い方ができます。

コメントの種類と対応の仕方

種類意味受けた時の対応
Comment質問・感想・軽い指摘返信して会話する。修正必須とは限らない
Request changes修正してほしいという明確な要求修正をcommitして返信。対応済みならResolve
Approveこの内容でmergeしてよいという承認merge に進める

コメントに対応する修正は、同じbranchに追加commitすれば自動でPRに反映されます。対応が終わった指摘は「Resolve conversation」で畳むと、残っている論点が一目で分かります。CodexやClaude CodeのPRに人間がレビューコメントを付け、AIに「レビューコメントに対応して」と指示する使い方も実務的で、この場合もResolveの操作で人間が「対応完了」を判定する形にすると、確認の主導権を保てます。

関連ページ

修正・質問・保留で迷った時の読み分け方

レビューコメントを読んでも対応を決められない時は、対象行、求められていること、今回のPRの範囲を順に照らし合わせます。コメントの文面だけで判断せず、その行をどう変えたかも見直してください。変更理由を尋ねているのか、元に戻すよう求めているのかで、次の対応が変わります。意図が読み取れない場合は不明として扱い、推測で修正を広げずに質問します。

修正するか、先に質問するか

修正してほしい内容と対象が明確なら、その指摘に対応する変更を進めます。Request changesでは、要求されている範囲を確認し、無関係な変更を混ぜないようにします。一方、Commentは修正の要求とは限りません。理由を聞かれているなら変更の意図を返信し、判断に必要な説明が足りなければ、どの部分を確認したいのか質問します。「何を直せばよいか」が不明なまま、想像で大きく書き換えることは避けます。

今回は保留する時に残す説明

今回のPRで扱う範囲と指摘を比べ、保留する場合は、その理由を返信に残します。対応した内容と、残した内容を分けて書くと、後から経緯を読み返しやすくなります。保留と決めただけで対応完了とは扱わず、会話に残っている論点を確認してください。Codexへ渡す場合も「コメントに対応して」だけで済ませず、対象コメント、対象ファイル、触らないファイル、確認項目を明記します。質問中の内容まで修正対象として渡さないよう整理します。

resolvedにする前の見直し

修正後は、コメントの対象だった箇所と追加した差分を見比べ、求められた内容に対応しているか、動作は確認できたかを見ます。CIの結果も確認し、返信には実際の対応内容を書きます。差分やログに秘密情報が混ざった疑いがあれば、commitやpushを急がず、対象ファイルと公開範囲、履歴への混入有無を確認します。resolvedの操作は、修正を入れたという理由だけで進めず、人間側で対応内容を確かめてから判断します。