第6章 PR 與評審——合併之前再看一遍
必讀 想跟著這個階段學下去,一定要讀這一章。一句話總結:PR(Pull Request)是提議把我分支上的改動合併進
main。它為合併之前的討論和審查,留出了一個位置。 一個人做也要評審。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章裡會用到 Issue(GitHub 上用來記下待辦事項或 bug 的記錄)。如果是解決某個 Issue 的 PR,就在 PR 說明裡用 fixes #編號 這樣規定的詞寫上這個 Issue,把它們關聯起來。這樣 PR 合併時,那個 Issue 就會自動關閉。[3:1] 現在只要知道有這種關聯就行了。
小的 PR 更容易評審,合併也更安全。 在請別人評審之前,先自己檢查。讀一遍改動的內容,看有沒有不小心改動的地方,確認構建和測試是否執行過了。[4]
也可以請 Claude Code 幫你建立 PR。官方文件建議,提交之前先審查 Claude 建立的 PR,並請它指出有風險的地方。[5]
用 first-board 分支建立 PR。提交之前,先指出這次改動裡可能有風險的地方。理解檢查
關於 PR(Pull Request),哪種說法是對的?
一個人也要評審
GitHub 教程說,即使一個人工作,在合併之前有意識地做評審,這個習慣會讓專案保持健康,也會讓以後的協作更容易。[6]
評審以三種決定之一結束。[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 評審有明確的侷限。
詳細說明(點選展開)
如果你在第3階段學過"寫的人和確認的人分開",那麼即使是同一個 Claude,也最好讓它在新會話裡評審。因為這樣它不會被製作時那段對話的上下文牽著走。
理解檢查
在 AI 評審中沒有發現問題時,該怎麼看待?
合併並收尾
評審完畢、確認手段也通過了,就把 PR 合併(Merge)。GitHub flow 的最後一步是刪除分支。就算刪了分支,PR 和提交記錄也不會被刪除,所以不用擔心。[17]
以後人多了,可以設定"必須有批准才能合併"這樣的保護規則。[18] 現在一個人練習,不用管它。
理解檢查
合併 PR 之後把分支刪掉,會怎樣?
動手試試
- 確認
first-board分支已經上傳到 GitHub(第4章)。在倉庫首頁點 Pull requests → New pull request,選first-board作為要比較的分支,然後點 Create pull request。[19] 在標題和說明裡寫清楚改了什麼、為什麼改。 - 建立之前,請 Claude 指出有風險的地方。
- 在新會話裡,對照 SPEC.md 獲得評審。只修改正確性問題。
- 再讓
/code-review評審一次,就算沒有發現,也親自瀏覽一遍 Files changed 標籤頁。 - 確認手段通過後,合併 PR,並整理分支。
連續任務:第7章裡,我們會把合併好的待辦看板,用 GitHub Pages 釋出到網際網路上。
總結
- PR 是合併之前討論和審查的地方。做小一點,寫明改了什麼、為什麼改,並先自己審查。
- 一個人也要評審。標準是 SPEC.md,只修改正確性缺口,跳過風格。
/code-review在任何方案裡都能用。沒有發現不等於安全,合不合並由人來決定。- 合併之後就算刪了分支,PR 和提交記錄也還在。
術語整理
| 術語 | 中文名稱 | 一句話解釋 |
|---|---|---|
| Pull Request(PR) | 拉取請求 | 提議合併分支改動的請求 |
| Review | 評審 | 合併之前審查改動 |
| Merge | 合併 | 把分支的改動合併進來 |
/code-review | 程式碼評審 | Claude Code 的評審命令 |
這一章讀完了嗎?
學習記錄只儲存在這個瀏覽器中。整體進度可以在 全部目錄中檢視。
下一章:第7章. 釋出
參考資料(19 則)
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) ↩︎
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) ↩︎
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) ↩︎
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) ↩︎
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) ↩︎
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) ↩︎
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) ↩︎
官方示例是把這次評審交給子代理(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) ↩︎
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) ↩︎
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) ↩︎
Claude Code 官方文件,「Code Review」。 "Plans: Team and Enterprise" / "Run
/code-reviewin your Claude Code session on any plan, or compare all the options." code.claude.com (確認日期 2026-11-01) ↩︎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) ↩︎
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) ↩︎
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) ↩︎
Claude Code 官方文件,「Desktop application」。 "To have Claude review your changes before you commit, enter
/code-reviewin the prompt box." code.claude.com (確認日期 2026-11-01) ↩︎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) ↩︎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) ↩︎
保護規則預設會禁止強制覆蓋(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) ↩︎
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) ↩︎