このレッスンのゴール
- PR 画面の主要タブの役割を説明できる
- レビューコメントを使って修正ループを回せる
- Checks(自動確認)の意味を過剰でも過小でもなく捉える
見る場所を固定する
GitHub の PR には、だいたい次があります。全部を一度に理解しなくて大丈夫です。役割だけ先に固定します。
- Conversation: 議論、要約、自動コメント
- Commits: 保存ポイントの並び
- Files changed: 実際の差分(最重要)
- Checks / Actions: テストやビルドなどの自動確認
Files changed の読み方
緑色は追加、赤色は削除、という見た目が多いです。文章や設定なら、そのままでも読めます。プログラムでも、『ファイル名』と『変更の量』だけでも異常検知はできます。
『このファイルを変えた理由を説明して』と Agent や作者に聞くのは、正規のレビュー行為です。
Checks が落ちたら
Checks は自動の門番です。赤だからといってあなたが悪いとは限りません。環境の問題や、もともと脆いテストの場合もあります。
取りうる行動は、『ログを Agent に読ませて修正させる』『詳しい人に共有する』『本番影響のない実験なら一旦止める』です。赤のまま強引にマージできる設定でも、慣れるまではやらないでください。
理解チェック
- PR で最初に Files changed を見る理由を言える
- Checks 失敗時の行動を2つ以上挙げられる
実践
PR を1つ選び、Conversation で要約、Files changed で意図せぬ変更、Checks で赤があれば原因調査依頼、の順にメモする。
いま身についている開発者スキル
PR レビュー実務 / CI の読み方