用途:为一个分支的有意义改动撰写或更新 PR 正文,帮助审阅者快速理解改动形态、验证其有效性,并把审阅时间集中在风险最高处。该技能改进审阅叙事,不替代代码审查或验证。
主要能力:使用固定结构组织正文,包括 Summary(用最小可视化说明改动形态,如调用树、组件树、文件树、diff 草图、Mermaid 序列/流程图或伪代码)、Evidence(Before/After 执行证据、截图、日志、全量检查结果)、Merge Danger(门类型:双向/单向;影响范围单字描述,并说明可能损坏点、回滚可恢复内容与重点审阅位置)。
必要用法:写作前需收集权威规格/issue/计划/工单图、对 PR 基线的完整 diff、实际运行的命令及输出、可用的截图日志与前后行为;若无有意义的前置状态,应说明并给出可得的最强验证,不得编造未实际运行的测试或检查。发布时依据 draft-pull-request 工作流做仓库预检、分支处理,并用 --body-file 创建或更新 PR,随后核对返回的 PR URL、标题、基线、head 与草稿状态,报告确切的验证结果及仅环境层面的阻碍。已有 PR 的分支应复用而非重复开启。
适用场景:分支有实质 diff 且需新建/更新 PR 正文;需要说明重构、流程或集成的形态;改动具有证据与回滚影响;技能或工作流变更需展示同一输入的学习闭环(输入、旧技能输出、人工编辑及原因、更新后输出、重跑对比)。
限制:不替代代码审查与验证;不得声称未运行的测试、截图或人工检查;不得在未读仓库模板时替换其 PR 标题或勾选项;对迁移或外部副作用不能把 revert 当作完整回滚;避免用大段散文代替小图示、只列测试而不展示前后结果、只写低风险而不说明可逆性与影响范围。发布后需核对 PR 元数据与 URL。