利用 AI 自动生成高质量的 Pull Request (PR) 描述 #

解决 PR 描述过于简单或缺失的问题：引导 AI 将复杂的 git diff 转换为结构化的 PR 文档，包含变更分类、风险评估和针对性的审核清单，让评审者快速理解代码意图。

为什么需要这个技能 #

在快速迭代的项目中，开发者往往倾向于在提交 PR 时仅写简单的“fix bug”或“update feature”，导致评审者（Reviewer）需要花费大量时间通过阅读代码来猜测修改目的。

一个高质量的 PR 描述应该包含：改了什么、为什么这么改、如何验证以及潜在风险。本技能通过预设的模板和分类逻辑，让 AI 能够自动分析代码变更，将碎片化的 diff 转化为一份专业、标准且易于审计的评审文档。

适用场景 #

• 当你需要将 git diff 转换为一个对评审者友好的 PR 描述时。
• 面对大型 PR（涉及多文件、多模块），需要通过结构化清单引导评审重点时。
• 团队需要统一 PR 提交规范，确保每个 PR 都包含风险评估和测试记录时。

核心工作流 #

1. 分析变更范围：通过执行 git diff <base>...HEAD --stat 识别修改的文件及其规模。
2. 变更分类：将文件自动归类为：源码（source）、测试（test）、配置（config）、文档（docs）、构建脚本（build）或样式（styles）。
3. 填充结构化模板：
   • Summary：简述变更目的。
   • Changes 表格：列出类别、文件及核心改动。
   • Why：关联 Issue 或阐述动机。
   • Testing：列出已完成的测试项。
   • Risks & Rollback：标注是否包含破坏性变更及回滚方案。
4. 动态生成审核清单：根据涉及的分类，自动添加对应的 Checklist（例如：涉及 auth 路径时，自动增加“输入验证”和“密钥泄露”检查项）。
5. 规模预警：当 diff 超过 20 个文件或 1000 行时，AI 将建议将 PR 拆分为更小的功能单元。

下载和安装 #

下载 comprehensive-review-pr-enhance 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要 #

暂无推荐