mcpField
E
end-pr-review

end-pr-review

github.com/koruworks测试与质量0131 次安装2 周前更新
代码仓库

关于 end-pr-review

用于整理并结束 Pull Request 评审的技能,为作者留下清晰记录。它把评审发现、会话提交、验收结果和未完成事项对应起来,并给出有理由的评审建议。

主要功能

  1. 01将提交与发现及处理结果对应
  2. 02检查文档是否同步更新
  3. 03总结评审发现和决定
  4. 04报告验收检查与未完成事项
  5. 05提出评审结论建议

适用场景

  1. 01完成修复后的代码评审
  2. 02向 PR 作者说明会话中的提交
  3. 03记录失败或尚未运行的验收检查

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/koruworks/skills --skill end-pr-review

安装后在 Claude Code 中输入/end-pr-review确认已加载。

详细介绍

结束拉取请求审查

此次更改的作者没有参与本次会话。他们会打开 PR,看到自己没有写过的评论、新提交和验收记录。 此技能确保他们看到的内容完整呈现整个过程:审查了什么、做出了什么决定、他们的工作有哪些更改以及原因——语气应以指导为主,而非责备,因为我们的目标是让下一个 PR 不必经历同样的审查。

收集记录

  1. PR 本身:本次会话期间发布的审查评论及其处理决定、描述,以及审查依据的规范(参见 start-pr-review)。
  2. 作者上次提交之后的提交: git log --oneline <author's last commit>..<branch>,以及各提交的消息。每个提交都是在本次会话中创建的。
  3. docs/<feature>/ACCEPTANCE.md 中各项检查旁边的验收结果,以及候选文件 docs/acceptances/ATTENTION.<feature>.md(如果运行了 start-acceptance)。

确认每项更改都有记录

对照记录逐一检查提交列表。对于每个提交,作者都应能找到:它回应了哪条发现或验收结果,以及为何选择这项更改而非其他方案。没有对应记录的提交就是缺口——应在撰写总结之前立即补上缺失的评论,而不是让这项更改显得没有解释。然后反向检查:如果用户要求修复某项发现,却没有相应提交,那么该问题仍未解决,总结必须说明这一点。

如果某项更改影响了项目文档描述的行为,请确认文档也已更新,否则将其记录为后续工作。

总结

在 PR 上发布一条面向作者的评论:

  • 审查了什么,以及依据是什么——规范、原则和验收清单。
  • 各项发现,每项用一行说明处理结果:已修复(以及对应提交)、接受为后续工作(以及记录位置),或已驳回(以及原因)。如果某项发现源自某条原则或 ATTENTION.md 条目,请说明这一点——这部分经验将传递到下一个 PR。
  • 作者的工作改了什么,以及原因,逐个提交用通俗语言说明。原因比差异更重要;差异作者可以自行查看。
  • 验收结果:哪些检查通过、失败或未运行,以及哪些内容是人能看到而测试无法验证的。
  • 仍待完成的事项,以及负责人(如有)。

条件允许时就发布;否则交给用户发布,并说明情况。这是对记录的总结,而非记录的替代品:行内评论和提交都应保留原位。

完成验收

运行 end-acceptance:与用户协商解决本次审查提出的候选事项,使用用户自己的措辞,并移除该功能的候选文件。如果审查发现了系统性经验,却没有将其推广,那么下一个 PR 还会遇到同样的问题。

结论

给出一个建议——批准、请求更改,或将问题交还作者处理——并用两句话说明理由。由用户决定。 合并由 merge-branch 把关,不属于此技能;是否推送本次会话的提交以便作者查看,由用户决定,只需询问一次。

评论

支持 Markdown