Agent Skills
返回列表
💻

Pull Request 增强

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/comprehensive-review-pr-enhance。

技能介绍

审查者常缺上下文

大 diff 堆在 PR 里,标题一行、描述空白,审查者只能逐文件猜意图;变更是否测过、有没有破坏性、怎么回滚,往往要来回问作者。问题不在「会不会写代码」,而在 PR 作为交付物 是否把范围、动机和验证结果写清楚。

技能如何工作

本技能把角色定为 PR 优化专家:在你提供变更材料(通常通过 $ARGUMENTS 传入 diff、说明或任务要求)后,按固定流程产出可审查的 PR 文档。

  1. 分析 diff:识别改动意图与影响范围,区分功能、重构、配置与文档类变更。
  2. 汇总变更与验证:说明「改了什么、为什么改」,并整理 已执行测试与结果(或应补测项)。
  3. 风险与上线:突出破坏性变更、迁移步骤、回滚思路及上线注意事项。
  4. 审查指引:给出检查清单,告诉审查者应重点看哪些文件与行为。

输出结构对齐常见工程实践:PR 摘要与范围、变更原因、测试结果、风险 / 回滚 / 审查者备注。需要更细的段落模板时,技能会引用 resources/implementation-playbook.md 中的示例。

适用边界

  • 适合:撰写或改写 PR 描述、为加快审查而汇总变更、整理测试与上线说明、讨论如何 缩小 PR 规模 或提高可审查性。
  • 不适合:没有任何可汇总的 PR 或变更列表;你需要的是 完整代码审查(逐行找 bug、架构裁决)而非 PR 文案与结构;任务与软件交付无关。

把它当作「把 diff 翻译成审查者能用的说明书」,而不是替代人工审代码。

使用场景

  • 功能分支已开发完,准备提 PR,需要把 `git diff` 里的改动整理成摘要、测试说明和审查清单
  • 一次提交涉及多模块,审查者时间有限,要把变更按意图分组并标注应重点看的文件
  • 接口或配置有破坏性调整,要在 PR 里写清迁移步骤、回滚方式及上线注意事项
  • PR 体积过大被 reviewer 打回,需要梳理可拆分边界并改写描述以提升可审查性

适合人员

  • 在团队仓库频繁提功能 PR 的后端工程师,希望描述结构固定、测试与风险一次写全
  • 要带多人做 code review 的技术负责人,希望成员 PR 自带范围说明与审查指引而非口头补充
  • 负责发版的前端或平台工程师,需要在 PR 中明确风险、回滚与上线检查项
  • 维护开源项目的 maintainer,收到外部贡献时要把稀疏的 commit 说明扩成可审查的 PR 文档