第3章 · Lesson 11 / 17

読む現場の言葉を身につける

Pull Request を読み解く

Conversation / Files / Checks を使いこなす

  • 目安 14 分
  • 進捗 11/17

このレッスンのゴール

  • 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 の読み方