Skip to content

このページは韓国語の原文をAIで翻訳したものです。誤りが含まれる場合があります。

第6章 PRとレビュー — マージする前にもう一度見る ​

必須 この段階を進めるなら、必ず読んでください。

一言まとめ: PR(Pull Request)は、自分のブランチの変更を main に取り込もうと提案するものです。取り込む前に、話し合ったり確認したりする場になります。 1人で作っていても、レビューはします。AIレビュー(/code-review)も受けますが、「問題なし」は安全という意味ではなく、マージするかどうかは自分で決めます。

この章は、2026年11月1日に確認したGitHubとClaude Codeの公式ドキュメントをもとに書きました。

PRとは ​

PRは、あるブランチの変更を別のブランチに取り込もうと提案するものです。プロジェクトに入る前に、話し合って確認する場を作ってくれます。[1]

PRの画面には、次のようなタブがあります。[2]

タブ表示されるもの
Conversation説明・コメント・レビュー
Commitsブランチが変わってきた経過
Checks自動テスト・ビルドの結果(第5章)
Files changedレビューする人がコメントを付ける、変更内容

出典: GitHub公式ドキュメント(一部のみ抜粋)[2:1]

PRを作るときは、何を変えたのか、どんな問題を解決するのかを書きます。[3]

あとの第8章では、イシュー(やることやバグを書き留めておく、GitHubの記録)を使います。イシューを解決するPRなら、PRの説明に fixes #番号 のような決まった言葉でイシューを書いて、つなげてください。そうすると、PRがマージされたときに、そのイシューが自動で閉じられます。[3:1] 今は、こうしたつながりがあることだけ知っておけば十分です。

小さなPRのほうが、レビューしやすく、マージしても安全です。 他の人にレビューをお願いする前に、まず自分で確認します。変更内容を読み、うっかり変えたところがないかを見て、ビルドとテストが動いたかを確かめます。[4]

Claude CodeにPRを作ってもらうこともできます。公式ドキュメントは、提出する前にClaudeが作ったPRを確認し、危ない点を挙げてもらうようにすすめています。[5]

first-boardブランチでPRを作って。提出する前に、この変更で危なそうな点を先に挙げて。

理解度チェック

PR(Pull Request)の説明として正しいものはどれでしょうか?

1人でもレビューする ​

GitHubのチュートリアルは、1人で作業していても、マージする前に意識してレビューする習慣がプロジェクトを健全に保ち、あとの共同作業を楽にしてくれると言っています。[6]

レビューは、3つの決定のどれかで終わります。[7]

決定意味
Comment意見だけを残す
Approveマージする準備ができた
Request changesマージする前に直す必要がある

出典: GitHub公式ドキュメント[7:1]

レビューの基準は、第3章のSPEC.mdです。Claude Codeの公式ベストプラクティスの文書は、作り終えたあとに次のようにレビューする例を挙げています。[8]

  • SPEC.mdと照らし合わせて、すべての要求が実装されたかを見る。
  • 正確さに影響する抜けだけを報告する。
  • 文字の見た目や名前の付け方のようなスタイルは飛ばす。

なぜスタイルを飛ばすのでしょうか。問題を探すように頼むと、レビューする側はいつも何かを見つけてきます。[9] それを全部直していくと、余計な飾りが増えてしまいます。正確さだけを見てもらえば、本当に直すべきものだけが残ります。

新しいセッションで、いまのブランチの変更をSPEC.mdと照らし合わせてレビューして。要求がすべて実装されているか、確認基準ごとに検査があるかを見て、正確さに影響する抜けだけを教えて。スタイルは飛ばして。

理解度チェック

SPEC.md と照らし合わせてレビューをもらうとき、公式ドキュメントが「スタイルは省くように」と言う理由は何でしょうか?

AIにレビューしてもらう ​

Claude Codeには、レビュー用のコマンド /code-review があります。作業中のセッションで入力すると、自分のブランチの変更を読み、正確さの問題を探して、会話で知らせてくれます。[10] どのプランでも使えます。[11]

たとえば最初の画面を作り終えたら、入力欄に /code-review とだけ入力すればよいです。説明を付けなくても、いまのブランチの変更を見てくれます。

AIレビューには、はっきりした限界があります。

  • AIレビューは、バグやセキュリティの問題を見逃すことがあります。指摘がないからといって、エラーがない、または安全だという意味ではありません。[12]
  • GitHubのPRに自動でレビューを付ける管理型レビューも、PRを承認したりブロックしたりしません。マージするかどうかは、人が決めます。[13]
詳しく(クリックして開く)
  • 使用量: レビューも自分のセッションの中で動くので、セッションのほかの部分とまったく同じように、自分のプランの使用量として計算されます。[14]
  • デスクトップアプリ: コミットする前に入力欄へ /code-review と入力して、レビューを受けられます。[15] PRを開いたあとは、セッション情報パネルで、PRと自動チェックの状態を見られます。この機能には、GitHub CLI(gh、GitHubをコマンドで操作するプログラム)がインストールされ、ログインしている必要があります。[16]
  • 管理型レビュー: GitHubのPRに自動でレビューを付ける機能は、TeamとEnterpriseのプラン向けです。個人はどのプランでも /code-review を使えます。[11:1]

ステップ3で「作った人と確認する人を分ける」ことを学んだなら、同じClaudeでも新しいセッションでレビューさせるほうがよいです。作ったときの会話の流れに引っ張られないからです。

理解度チェック

AI のレビューで、見つかった問題がなかったとき、どう受け止めればよいでしょうか?

マージして片付ける ​

レビューを終えて確認の仕組みが通ったら、PRをマージします(Merge)。GitHub flowの最後は、ブランチを削除することです。ブランチを削除しても、PRとコミットの記録は消えないので、心配はいりません。[17]

あとで人が増えたら、「承認がないとマージできない」といった保護ルールを設定できます。[18] 1人で練習している今は、知らなくても大丈夫です。

理解度チェック

PR を統合したあとにブランチを削除すると、どうなるでしょうか?

自分でやってみよう ​

  1. first-board ブランチがGitHubに上がっているか確認する(第4章)。リポジトリのトップ画面で Pull requests → New pull request を押し、比較するブランチに first-board を選んで Create pull request を押す。[19] タイトルと説明に、何をなぜ変えたのかを書く。
  2. 作る前に、Claudeに危ない点を挙げてもらう。
  3. 新しいセッションで、SPEC.mdと照らし合わせたレビューを受ける。正確さの問題だけを直す。
  4. /code-review をもう一度受け、指摘がなくても、自分でFiles changedタブに目を通す。
  5. 確認の仕組みが通ったらPRをマージし、ブランチを片付ける。

続きの課題: 第7章では、マージしたやることボードをGitHub Pagesでインターネットに公開します。

まとめ ​

  • PRは、マージする前に話し合って確認する場。小さく作り、何をなぜ変えたかを書き、まず自分で確認する。
  • 1人でもレビューする。基準はSPEC.md。正確さの抜けだけを直し、スタイルは飛ばす。
  • /code-review はどのプランでも使える。指摘がなくても安全とは限らず、マージするかどうかは人が決める。
  • マージしたあとにブランチを削除しても、PRとコミットの記録は残る。

用語まとめ ​

用語読み方一言でいうと
Pull Request(PR)プル・リクエストブランチの変更を取り込もうという提案
Reviewレビューマージする前に変更を確認すること
Mergeマージブランチの変更を取り込んで1つにすること
/code-reviewコード・レビューClaude Codeのレビュー用コマンド

この章は読み終わりましたか?

学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。

次の章: 第7章 デプロイ

参考資料(19件)
  1. GitHub 公式ドキュメント、「About pull requests」。"A pull request proposes merging code changes from one branch into another. As a collaborative feature, pull requests give you a place to discuss and review work before it becomes part of a project." docs.github.com (確認日 2026-11-01) ↩︎

  2. GitHub 公式ドキュメント、「About pull requests」。"Checks shows the results of automated tests, builds, and other validations." / "Files changed shows the diff that reviewers comment on." docs.github.com (確認日 2026-11-01) ↩︎

  3. GitHub 公式ドキュメント、「GitHub flow」。"When you create a pull request, include a summary of the changes and what problem they solve." / "If you link with a keyword, the issue will close automatically when the pull request merges." docs.github.com (確認日 2026-11-01) ↩︎

  4. GitHub 公式ドキュメント、「Helping others review your changes」。"Small, focused pull requests are easier to review and safer to merge." / "A self-review can include reading the diff, checking for accidental changes, and making sure relevant builds or tests have run." docs.github.com (確認日 2026-11-01) ↩︎

  5. Claude Code 公式ドキュメント、「Common workflows」。"Review Claude's generated PR before submitting and ask Claude to highlight potential risks or considerations." code.claude.com (確認日 2026-11-01) ↩︎

  6. GitHub 公式ドキュメント、「Reviewing your proposed changes」。"Even when you work alone, a deliberate review builds a habit that keeps your software projects healthy and makes collaboration easier later." docs.github.com (確認日 2026-11-01) ↩︎

  7. GitHub 公式ドキュメント、「Quickstart for reviewing pull requests」。"Approve signals that the changes are ready to merge." / "Request changes flags feedback the author must address before merging." docs.github.com (確認日 2026-11-01) ↩︎

  8. 公式の例ではこのレビューをサブエージェント(subagent、Claudeが仕事を切り分けて任せる別のClaude)に任せていますが、このガイドでは新しいセッションに置き換えて書いています。Claude Code 公式ドキュメント、「Best practices for Claude Code」。"use a subagent to review the rate limiter diff against SPEC.md, check every requirement is implemented and the listed edge cases have tests, report gaps that affect correctness and skip style" code.claude.com (確認日 2026-11-01) ↩︎

  9. Claude Code 公式ドキュメント、「Best practices for Claude Code」。"A reviewer that's asked to find problems will always find something." code.claude.com (確認日 2026-11-01) ↩︎

  10. Claude Code 公式ドキュメント、「Review locally with /code-review」。"Claude reviews the changes on your branch, looks for correctness bugs, and reports what it found in your conversation." code.claude.com (確認日 2026-11-01) ↩︎

  11. Claude Code 公式ドキュメント、「Code Review」。"Plans: Team and Enterprise" / "Run /code-review in your Claude Code session on any plan, or compare all the options." code.claude.com (確認日 2026-11-01) ↩︎

  12. Claude Code 公式ドキュメント、「Code Review」。"Code Review uses AI to review code and may miss bugs, security vulnerabilities, or other issues. A review with no findings doesn't mean your code is error-free or secure." code.claude.com (確認日 2026-11-01) ↩︎

  13. Claude Code 公式ドキュメント、「Code Review」。"A review never approves or blocks the pull request, so the decision to merge stays with your team." code.claude.com (確認日 2026-11-01) ↩︎

  14. Claude Code 公式ドキュメント、「Review locally with /code-review」。"The review runs in your own session, so it counts toward your plan's usage or API billing the same way the rest of the session does." code.claude.com (確認日 2026-11-01) ↩︎

  15. Claude Code 公式ドキュメント、「Desktop application」。"To have Claude review your changes before you commit, enter /code-review in the prompt box." code.claude.com (確認日 2026-11-01) ↩︎

  16. Claude Code 公式ドキュメント、「Desktop application」。"After you open a pull request, it appears in the Changes card of the session details panel with the status of its CI checks." / "PR monitoring requires the GitHub CLI (gh) to be installed and authenticated on your machine." code.claude.com (確認日 2026-11-01) ↩︎

  17. GitHub 公式ドキュメント、「GitHub flow」。"Don't worry about losing information. Your pull request and commit history will not be deleted." docs.github.com (確認日 2026-11-01) ↩︎

  18. 保護ルールは、デフォルトで強制上書き(force push、記録を無理やり上書きしてアップロードすること)とブランチの削除を防ぎます。GitHub 公式ドキュメント、「About protected branches」。"By default, each branch protection rule disables force pushes to the matching branches and prevents the matching branches from being deleted." docs.github.com (確認日 2026-11-01) ↩︎

  19. GitHub 公式ドキュメント、「Quickstart for pull requests」。"then click New pull request." / "For the compare branch, select the branch that contains your changes." / "Click Create pull request." docs.github.com (確認日 2026-11-01) ↩︎