该技能用于在编写 PR 正文时套用统一模板,帮助作者把变更讲清楚。模板包含四个主要部分:Summary(用图示、diff 草图或树状结构说明核心改动)、Evidence(给出改动前后的截图、输出或测试结果)、Merge Danger(说明是单向门还是双向门,以及影响范围 blast radius)、Language(PR 正文用英文撰写;若目标仓库的 remote owner 与当前 GitHub 用户一致,则额外发一条评论,包含 ## Chinese Summary (non-authoritative) 章节总结要点)。
Summary 部分要求跳过前言、保持简短,并使用 GLOSSARY.md 中的领域语言。可根据场景选择最小且清晰的表达方式:用伪代码展示逻辑或算法,用调用树展示运行时控制流,用组件树展示 UI 结构,用浅层文件树展示文件职责或重构,用 Mermaid 展示组件交互、控制流或数据流,用 diff 展示具体变更。每个图示应紧邻其支持的简短文字,只保留回答当前问题所需的调用、文件、属性、状态和边界,不必全部使用。
Evidence 部分要求给出改动有效的具体证据,展示前后对比:截图属于最高等级,适用于环境支持且改动为视觉性的情况;基于执行的证据次之,如测试结果、控制台输出,并用伪代码展示现在失败与通过的测试。
Merge Danger 部分要求描述这是单向门还是双向门:双向门可以回退,单向门不能;容易回滚的 PR 风险更低,涉及破坏性操作或难以逆转的决策属于单向门。Blast radius 指本次改动可能的影响或范围,例如布局偏移、对使用方的破坏、移动端响应式等。
限制方面:资料未提供安装命令、收费信息、平台支持或具体使用步骤,仅给出模板内容与写作规范。