关于 end-pr-review
用于整理并结束 Pull Request 评审的技能,为作者留下清晰记录。它把评审发现、会话提交、验收结果和未完成事项对应起来,并给出有理由的评审建议。
主要功能
- 01将提交与发现及处理结果对应
- 02检查文档是否同步更新
- 03总结评审发现和决定
- 04报告验收检查与未完成事项
- 05提出评审结论建议
适用场景
- 01完成修复后的代码评审
- 02向 PR 作者说明会话中的提交
- 03记录失败或尚未运行的验收检查
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ koruworks/ skills --skill end-pr-review安装后在 Claude Code 中输入/end-pr-review确认已加载。
详细介绍
结束拉取请求审查
此次更改的作者没有参与本次会话。他们会打开 PR,看到自己没有写过的评论、新提交和验收记录。 此技能确保他们看到的内容完整呈现整个过程:审查了什么、做出了什么决定、他们的工作有哪些更改以及原因——语气应以指导为主,而非责备,因为我们的目标是让下一个 PR 不必经历同样的审查。
收集记录
- PR 本身:本次会话期间发布的审查评论及其处理决定、描述,以及审查依据的规范(参见 start-pr-review)。
- 作者上次提交之后的提交:
git log --oneline <author's last commit>..<branch>,以及各提交的消息。每个提交都是在本次会话中创建的。 docs/<feature>/ACCEPTANCE.md中各项检查旁边的验收结果,以及候选文件docs/acceptances/ATTENTION.<feature>.md(如果运行了 start-acceptance)。
确认每项更改都有记录
对照记录逐一检查提交列表。对于每个提交,作者都应能找到:它回应了哪条发现或验收结果,以及为何选择这项更改而非其他方案。没有对应记录的提交就是缺口——应在撰写总结之前立即补上缺失的评论,而不是让这项更改显得没有解释。然后反向检查:如果用户要求修复某项发现,却没有相应提交,那么该问题仍未解决,总结必须说明这一点。
如果某项更改影响了项目文档描述的行为,请确认文档也已更新,否则将其记录为后续工作。
总结
在 PR 上发布一条面向作者的评论:
- 审查了什么,以及依据是什么——规范、原则和验收清单。
- 各项发现,每项用一行说明处理结果:已修复(以及对应提交)、接受为后续工作(以及记录位置),或已驳回(以及原因)。如果某项发现源自某条原则或
ATTENTION.md条目,请说明这一点——这部分经验将传递到下一个 PR。 - 作者的工作改了什么,以及原因,逐个提交用通俗语言说明。原因比差异更重要;差异作者可以自行查看。
- 验收结果:哪些检查通过、失败或未运行,以及哪些内容是人能看到而测试无法验证的。
- 仍待完成的事项,以及负责人(如有)。
条件允许时就发布;否则交给用户发布,并说明情况。这是对记录的总结,而非记录的替代品:行内评论和提交都应保留原位。
完成验收
运行 end-acceptance:与用户协商解决本次审查提出的候选事项,使用用户自己的措辞,并移除该功能的候选文件。如果审查发现了系统性经验,却没有将其推广,那么下一个 PR 还会遇到同样的问题。
结论
给出一个建议——批准、请求更改,或将问题交还作者处理——并用两句话说明理由。由用户决定。 合并由 merge-branch 把关,不属于此技能;是否推送本次会话的提交以便作者查看,由用户决定,只需询问一次。
评论
支持 Markdown