该技能用于撰写 PR(Pull Request)正文,适用场景是提交代码变更说明时组织内容。正文结构包含摘要、证据与合并风险三部分。摘要部分建议选择能讲清关键点的最小视图,可用伪代码展示逻辑或算法、用调用树展示运行时控制流、用组件树展示 UI 结构与状态及模块边界、用浅层文件树展示文件职责或重构、用 Mermaid 展示组件交互与控制或数据流;也可用 diff 突出变化,diff 形状需与主题匹配(组件变更、文件布局变更、调用树变更、状态或控制流变更等)。当大部分内容为新增、省略上下文会隐藏归属或顺序、或用户需要可复制的目标形态时,展示完整代码块。每个可视化应紧邻其支持的简短文字,只保留回答当前问题或讨论点所需内容,可选用一种或多种,不宜全部使用。证据部分需提供变更有效的具体证明,展示前后对比:截图在环境允许且变更为视觉性时最佳,基于执行的证据如测试结果、控制台输出为次优。合并风险部分需说明是一扇单向门还是双向门:双向门可回退,单向门不可逆,易回滚的 PR 风险更低;涉及破坏性操作或难以逆转的决策属于单向门。爆炸半径指该 PR 引入变更的潜在影响或范围,需考虑布局偏移、对使用方的破坏、移动端响应式等。写作要求是跳过所有前言,保持行文简短,并使用 GLOSSARY.md 中的用户领域语言。该技能为纯写作模板,不提供收费、价格或平台信息;其核心文档为英文,本介绍为中文整理,未提供具体安装命令或代码示例。
pr
编程与开发
更新于 10-15 22:34