PR 摘要助手

要解决的问题

在代码评审流程中，PR 描述的质量直接影响审查效率。开发者提交 PR 时，常面临两个困境：要么描述过于简略，审查者无法快速理解变更意图；要么事无巨细地堆砌信息，淹没关键内容。gy3 技能的目标是让 PR 描述聚焦于审查者真正需要的信息——用户可见行为变化、内部重构、迁移内容以及测试覆盖情况。

核心能力与工作方式

gy3 按固定工作流处理变更：

• 检查变更文件与测试：当测试文件存在时，一并纳入分析范围。
• 分类变更内容：将变更拆分为四类——用户可见行为、内部重构、迁移工作、测试覆盖，每类独立呈现。
• 风险与后续工作：仅在确有必要时才提及风险或后续待办，避免制造噪音。
• 保持简短事实化：摘要以事实为基础，控制篇幅。

模板设计上，gy3 遵循一个原则：当没有有用内容可写时，直接省略 Notes 部分。这避免了为凑篇幅而生成无意义文本。

适用边界与注意点

gy3 适合标准 Git 工作流下的 PR 场景，依赖仓库中的变更文件作为输入。以下几点需要注意：

• 技能分析的是 diff 内容，无法感知未提交的代码或仓库外上下文。
• 当变更涉及复杂的跨仓库依赖时，摘要可能不完整，仍需人工补充。
• "风险仅在确有必要时提及"意味着技能不会自动列举所有潜在问题，审查者仍需自行判断。
• 生成的摘要偏保守，适合作为草稿起点，团队可按需调整格式和内容粒度。