Community研究与数据分析github.com

sgomez/developer-skills

为 Claude Code 提供无人值守的 PR 交付能力

developer-skills 是什么?

该技能允许 AI 助手(如 Claude Code)自动处理代码审查反馈:读取 PR 上的评论,实现修复,推送代码,并在线程中回复。它适用于 GitHub 上的任何 PR 工作流,特别适合需要无人值守修复常见审查意见的场景。技能通过 gh CLI 与 GitHub API 交互,按六个步骤执行:检查 PR 状态、收集所有未解决的反馈、实施最小化修改、运行项目检查(如 pnpm typecheck 和 pnpm test)、提交推送、并回复每个已处理的线程。它内置了安全规则:拒绝已关闭的 PR,不重构无关代码,不强制推送破坏性变更,并在不清楚的注释上做出合理假设并说明。该技能对节省开发者手动处理琐碎审查意见的时间非常有用。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add sgomez/developer-skills

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

修复 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 会在推送时自动解析

相关技能