该技能用于维护 diffmap 仓库的对外沟通与发布流程,重点在于让 pull request 描述、issue 回复和发布说明面向阅读渲染后 diffmap 的人,而不是面向编写 Markdown 的 agent。
用途与写作原则:读者看到的是渲染后的 diffmap,其 agent 负责写 Markdown,因此提交 issue 和阅读 PR 的人不会接触 fence 语法、解析规则或 CLI 输出字段。每项改动应按读者实际遇到的方式描述:在查看器中看到的卡片、面板、消息、截图,以及其 agent 现在会做什么或被要求做什么。例如说明 agent 必须在某一阶段的摘要卡片中交代提交更改的每个文件,缺失时 diffmap 会在打开 spec 时警告。应省略 fence 语法、命令行标志、字段名和源文件;这些由 diff、README 和 generate-diffmap 技能提供给 agent。此原则适用于所有面向用户的内容,包括 PR 标题与描述、issue 回复和发布说明。
Pull request 流程:从 main 拉分支,提交改动,然后按 AGENTS.md 中 Releasing 的说明单独提交版本号更新(新行为用 minor,修复用 patch)。对于读者可见的内容,需要捕获渲染后的 diffmap:serve 一个能展示各受影响状态的小型 spec,再用 agent-browser screenshot '<selector>' <path> 以 2x 缩放截取元素截图。截图托管在孤儿分支 pr-assets 下以 issue 或 PR 编号命名的目录中;机器人令牌无法创建 gist,图片也不能进入 main。需在检出 pr-assets 的 worktree 中添加、推送,并通过固定 commit URL 嵌入每张图片,以保证后续推送不会改变图片地址。不要删除 pr-assets,因为已合并的 PR 会引用其中的图片。PR 描述按面向读者的原则撰写:先写对他们的变化,再放截图,最后写随哪个版本发布,并在第一行写 Closes #<n>。合并使用 gh pr merge <n> --rebase --delete-branch,使发布提交在 main 上保持独立。Vercel 是关键检查,Cursor Bugbot 为可选且通常较慢。
Issue 回复:具体感谢报告者报告中的某一点,说明对其而言发生了什么变化以及随哪个版本发布。已合并的版本更新在 npm 上是暂存状态,需维护者批准后才上线,因此应写“will be in 0.9.0”,而不是“is out in 0.9.0”。不要提及本次发布未涉及的问题部分。
适用场景:diffmap 仓库维护者撰写 PR、回复 issue、编写发布说明以及执行截图、合并与发布流程时使用。限制:资料未提供其他功能细节、收费或平台信息。