修复 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): 解决 PR #<PR> 的审查评论"
git push origin <分支>
5. 回复线程
对于每个已处理的线程,回复:
gh api repos/{owner}/{repo}/pulls/<PR>/comments/<COMMENT_ID>/replies \
--method POST \
--field body="已在 <commit-sha> 中修复:<描述所做更改的单行说明>。"
6. 报告
列出每个已处理的评论以及做了什么。标记任何跳过的评论及其原因。
规则
- 所有修复用一个提交(不是每个评论一个提交)
- 回复你处理的每个线程
- 如果评论不明确:做出最合理的解释,实施它,并在线程回复中说明你的解释(无人值守 —— 没有可询问的人)。如果评论是错误的,在回复中说明原因,而不是实施它
- 如果修复会导致测试失败:报告情况,不要强制推送损坏的代码
- 不要解析线程 —— GitHub 会在推送时自动解析