修正 PR
讀取審查評論,實作修正,推送變更,回覆討論串。
喚起
/fix-pr # 修正目前的 PR
/fix-pr 42 # 修正 PR #42
流程
1. 識別並檢出 PR
gh pr view <PR> --json number,title,headRefName,state
若 PR 已關閉或合併,則拒絕執行。
如果目前分支並非 PR 分支(/developer 管線會在全新的工作樹中執行此流程),請先檢出該分支:
gh pr checkout <PR>
絕不執行 git checkout main —— 在連結的工作樹中這樣做會失敗,因為 main 已在主要工作樹中被檢出。
2. 讀取所有回饋
# 頂層評論
gh pr view <PR> --comments
# 審查討論串(行內)
gh api repos/{owner}/{repo}/pulls/<PR>/comments \
--jq '[.[] | {id, path, line, body, in_reply_to_id}]'
# 審查摘要
gh api repos/{owner}/{repo}/pulls/<PR>/reviews \
--jq '[.[] | select(.body != "") | {id, state, body}]'
收集:未解決的行內討論串、審查摘要評論、PR 頂層評論。
若無任何可處理的回饋,則拒絕執行。
3. 實作修正
- 解決每一條未解決的評論
- 保持變更最小化 —— 只處理回饋要求的內容
- 不要重構不相關的程式碼
- 套用所有修正後:執行專案的檢查(參見
AGENTS.md/CLAUDE.md取得確切指令),通常是:
pnpm typecheck
pnpm test
在提交前修復失敗。
4. 提交並推送
git add <你修改的檔案> # 按路徑暫存 —— 絕不執行 `git add -p`(互動式)或 `git add -A`
git commit -m "fix(pr): address review comments on #<PR>"
git push origin <分支>
5. 回覆討論串
針對每個已處理的討論串進行回覆:
gh api repos/{owner}/{repo}/pulls/<PR>/comments/<COMMENT_ID>/replies \
--method POST \
--field body="Fixed in <commit-sha>: <變更的一行說明>。"
6. 報告
列出每個已處理的評論以及對應的修改。標記任何跳過的評論及其原因。
規則
- 所有修正放在一個 commit 中(不是每條評論一個)
- 回覆每一個你處理過的討論串
- 如果評論不明確:做出最合理的詮釋,實作它,並在討論串回覆中說明你的詮釋(無人值守 —— 沒有人可以詢問)。如果評論有誤,則在回覆中說明理由,而非實作它
- 如果修正會導致測試失敗:回報情況,不要推送會破壞的程式碼
- 不要手動解析討論串 —— GitHub 會在推送時自動解析