用途
本技能在撰写 PR 正文(PR body)时使用,提供一套固定的 PR 描述模板与写作规范,帮助作者把变更要点、验证证据和合并风险表达清楚。
主要能力
- Summary 模板:根据要表达的重点,选择最小且清晰的视图,包括伪代码、调用树、组件树、浅层文件树、Mermaid 时序图、diff,或直接给出完整代码块。
- Evidence 模板:要求给出变更有效的具体证据。优先使用截图(S 级),在基线分支与当前分支展示同一视图同一状态时做前后对比;没有真实“之前”状态时,展示变更新增的各状态。测试结果、控制台输出等基于执行的证据为 A 级。
- Merge Danger 模板:描述变更是可回滚的双向门还是不可逆的单向门,并说明影响范围(如布局偏移、对下游使用者的破坏、移动端适配等)。
- 截图规范:以粗体视图名标注,每个视图最多一句说明变更,用 Before | After 表格放置截图;命名采用 kebab case,如
<view>-before.png、<view>-after.png、新增视图<view>-after.png、基线未到达的状态<view>--<state>.png;并提供一行说明截图来源、视口和基线。 - 截图发布说明:gh 无法附加图片,可用
node ~/.agents/skills/pr/scripts/pr-evidence.ts <png 或目录>...将截图提交到仅含图片的pr-images/<branch>分支(该分支永不合并),脚本会打印带提交 SHA 链接的表格;--dry-run只检查名称不推送。
使用方式
按模板填写 Summary、Evidence、Merge Danger 各段;跳过所有前言、保持文字简短;通过 /domain-modeling 解析项目的领域词汇并使用其既有语言。每个可视化紧邻其支持的简短文字,只保留回答当前问题所需的调用、文件、属性、状态与边界,避免信息过载。当调用方仓库的贡献格式覆盖此默认模板时,以其格式为准。
完成标准
描述与最终 diff 一致,展示观察到的证据与局限,并标明合并风险。本技能只负责撰写描述,发布行为取决于用户的操作授权。
限制
模板本身不涉及自动化发布 PR;截图上传依赖所述脚本与对应安装路径。