该技能用于在撰写 PR 正文时提供统一模板,主要面向需要清晰表达代码变更、验证结果与合并风险的开发场景。
用途:帮助作者按固定结构组织 PR 描述,并减少冗长前言,用精炼文字说明变更要点。
主要能力:模板要求正文包含 Summary、Evidence、Merge Danger 三部分。摘要部分可根据表达需要选择伪代码、调用树、组件树、文件树、Mermaid 时序图或 diff 等方式,展示逻辑、运行时控制流、UI 结构、文件职责或数据流;也可在大部分内容为新内容或需要可复制的目标形态时展示完整代码块。证据部分要求给出变更前后的具体证据,例如截图、输出或测试运行结果;资料将截图列为最高优先级,将基于执行的证据列为次一级。合并风险部分要求说明是单向门还是双向门,并给出一词描述的影响范围,必要时补充合并可能带来的后果。模板还要求使用 GLOSSARY.md 中的用户领域语言,跳过前言并保持文字简短。
使用方式:按模板填充各个部分;每个可视化内容紧挨其支持的简短文字,只保留回答当前问题或讨论当前选项所需的调用、文件、属性、状态与边界,可按需选择一种或多种表达方式,避免信息过载。
适用场景:编写代码 PR、重构说明、组件或文件布局变更说明、状态与控制流调整说明等需要结构化描述的场景。
限制:资料仅提供模板与写作指导,未提供自动化生成、平台集成、收费或价格等信息;具体效果与使用步骤暂未提供。