Communitygithub.com

metyatech/skill-pr-review-workflow

处理 PR 评审反馈循环、重新请求评审以及管理 GitHub 通知的智能体技能

skill-pr-review-workflow 是什么?

该技能专注于自动化 PR 评审反馈循环,旨在提高开发效率。它明确了智能体在解决评审反馈后的操作顺序:必须先解决相应的评审线程,运行验证套件并总结结果,然后才能重新请求评审。该技能还规定了何时应将预防性措施(如规则或技能更新)纳入同一变更集,从而避免重复出现相同的问题。在重新请求评审方面,它智能地限制只向提交了相关反馈的评审者重新请求,避免不必要地打扰其他人。对于 Codex 和 Copilot 等 AI 评审机器人,它提供了具体的触发重新评审的方法(如使用 `@codex review` 命令或通过 GitHub API 操作),确保流程自动化。此外,该技能还包含了 GitHub 通知管理的最佳实践,建议使用 DELETE API 将通知标记为“完成”以清理收件箱,而非仅标记为已读。最后,它还涵盖了合并后清理工作,如合并 PR、同步目标分支以及删除本地和远程分支,从而保持仓库整洁。该技能适用于 Claude Code、Cursor 和 Codex 等开发工具,帮助团队更高效地管理代码评审流程。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add metyatech/skill-pr-review-workflow

在你喜欢的 AI 中提问

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

文档

PR 评审反馈工作流

处理评审反馈

  • 在解决 PR 评审反馈后,智能体必须在结束前解决相应的评审线程。如果智能体没有权限,则必须明确说明。
  • 在重新请求评审之前,智能体必须运行相关的验证套件,并必须在 PR 评论或描述中总结结果(命令和输出)。
  • 对于由智能体引起的遗漏或可复用的推理缺陷导致的反馈,智能体必须评估将预防措施放入测试、检查、技能或规则中的哪一处。当需要更新规则或技能时,智能体必须将其作为同一变更集的一部分进行更新。如果不需要更新,则智能体必须简要说明最早的可复用防护点为何在其他地方。

重新请求评审

  • 在推送修复后,智能体必须仅向在当前评审轮次中发布了已处理反馈的评审者重新请求评审。
  • 智能体不得向未发布已处理反馈或已经表示没有可操作问题的评审者(包括 AI 评审者)重新请求评审。
  • 如果没有适用的评审者剩余,智能体必须询问接下来应由谁进行评审。

AI 评审机器人重新评审

当仓库配置了 Codex 或 Copilot 评审机器人时,智能体必须仅触发发布了已处理反馈的机器人的重新评审。

  • 对于 Codex 重新评审:在 PR 上评论 @codex review。
  • 对于 Copilot 重新评审:使用 GitHub API 移除并重新请求机器人评审者 copilot-pull-request-reviewer[bot]。智能体不得依赖基于 UI 的评审者分配。
    • 移除:DELETE /repos/{owner}/{repo}/pulls/{pr}/requested_reviewers,请求体为 {"reviewers":["copilot-pull-request-reviewer[bot]"]}。
    • 添加:POST /repos/{owner}/{repo}/pulls/{pr}/requested_reviewers,请求体为 {"reviewers":["copilot-pull-request-reviewer[bot]"]}。

GitHub 通知管理

  • 智能体必须使用 DELETE /notifications/threads/{id} (HTTP 204) 将通知标记为已完成(将通知从收件箱中移除并移至“已完成”选项卡)。
  • 智能体不得使用 PATCH /notifications/threads/{id},该操作仅标记为已读,但通知仍留在收件箱中。
  • 处理完通知后,智能体必须使用相同的 DELETE API 批量删除任何剩余的已读但未完成的通知。

合并后清理

  • 完成 PR 后,智能体必须合并它,同步目标分支,并删除本地和远程的 PR 分支。

相关技能