--- name: ketchup description: "用直白文字和小型图示,让用户了解本聊天自其上一条消息以来的变化。列出每个等待其处理的事项,并提供其仅凭回复就能决定所需的信息。用于 `/ketchup`。" disable-model-invocation: true --- # Ketchup:补上进展 让用户了解本聊天中,他们在 `/ketchup` 之前写的最后一条消息以来发生了什么,并帮助他们理解每项变化,而不只知道状态。然后列出每个等待他们作出的决定,使他们仅凭你的回复即可决定。通知和子代理结果不是用户消息。假定用户记得自己的最后一条消息,而不记得之后任何事。 使用 [`/bro`](../bro/SKILL.md) 的语气,而非其任务:直白用词、短句、不用术语,像一个人向另一个人补充近况。说明对用户而言有什么改变,而非你如何完成。说“测试通过”,不要说“CI 是绿色的”。除非用户采取行动需要,否则省略哈希、文件路径、命令、构建编号和测试数量。使用用户认识的名称称呼每个 PR、分支或代理,不要发明标签。如果某事实需要背景才有意义,提供背景,或省略该事实。 ## 收集变化 本轮保持只读。只用已有材料制作图示:不改代码,不启动应用或任务,不发布任何内容。收集自那条消息以来你自己的工作、子代理报告及本聊天中其他人的消息。检查本聊天涉及的每个 PR、CI 运行或代理的当前状态。将要展示的每个数字与其来源事实核对;纠正数字时明确说明。 行动项是只有用户才能作出的决定或采取的步骤,例如产品选择、批准、不可逆动作,或你缺少的访问权限。所有仍等待用户的事项都应包含,即使早于其最后一条消息提出。你仍能自行完成的工作不算行动项。绝不为填满回复而编造决定。用户未要求、工作也不需要的步骤不算行动项,除非它不可逆且在等待用户:用一行说明,不配图。 一个决定可覆盖许多事项,例如一组等待合并的 PR。对每项收集链接、对用户的改变、支持你建议的证据、风险和你的建议。决定所需但你不知道的事实写“unknown”。没有的链接就省略。 ## 撰写回复 篇幅用于决定,而非故事。不计图片,已发生事情的说明少于 100 个英文单词;发生较少时更短。省略未给用户带来变化的工作。每个事项约 30 个英文单词。回复随事项数量增长:两项总共应远少于 150 个英文单词,不计图片;三十项就需要多得多。绝不为满足字数而删项或压缩事项:不能以数量代替清单,也不能以链接代替事项。链接可增加深度,但单凭回复就必须足够作决定。 开头用一个短句指出什么在等待用户,或说明没有。如果没有发生任何事,也没有等待用户的事项,说明后停止。 然后展示已发生的事,先放图片。内嵌工作产生的截图和视频,再放解释变化的图。随后对用户要求的每件事各用一个短项目符号概括:结果如何,以及已完成、仍运行、失败还是未检查。每行按口头表达来写:“搜索缓慢是因为缺少索引”,而不是“搜索审查:完成”或“搜索慢:缺少索引”。指出过程中发现并修复的 bug。每行单独阅读也必须真实。仍等待用户的事情绝不能标为完成,并省略行动项已说明的内容。概况下方最多用三条短行,补充会改变用户认知或所需行动的信息。再用一行指出你自己还能完成的剩余工作。 然后列行动项。询问用户负责的决定,例如合并、批准或选择,并给出建议。你会先做的步骤放在建议里。所有前置事项及不可撤销事项也放在那里。对每个决定涉及的 PR、问题或代理,给出编号或链接,包括在选项之间作选择的决定。 根据决定选择形式。单一事项的决定写成一个项目符号:决定、建议、对用户的改变、支持建议的证据和风险,事项只命名一次。多个事项共享一个决定时,决定和建议各写一次,再为每项单独列点,风险最高的优先:链接和名称、对用户的改变、支持建议的证据及风险。只有某项建议与整体决定不同,才单独说明。每项都给出风险,即使很低,例如“风险低:仅更改颜色。”只有等待代价不只是延迟时才说明,例如截止期限或数据丢失。 对于选项之间的决定,列出工作中权衡过的每个选项,各自能给用户什么、代价是什么,以及存在时的当前状态。这些代价就是该决定的风险,因此不另加风险行。如果上方截图展示了选项,在对应截图下写各自收益和代价。 ## 图示 图示是图片:截图、视频、Mermaid 图、来自 `/visualize` 的图表或示意图,或生成图像。Markdown 表格不是图示,即使有修改前后两列。 当图片比句子更易理解时就画出来:设计或系统如何工作、带每个 PR 状态的 PR 堆叠或依赖链、修复前后对比,或选项并排比较。绝不画状态清单、行动项清单或互不连接的方框。同一事实不要在文字中或不同图示间重复。 每张图保持小到一眼能读懂:最多六个框,每框最多八个英文单词。标签写成日常语言,不用“Tests: pass”这种标签式措辞。需要一句话的事实放在文字中,或不写。 可见变化的截图和视频应内嵌,而非仅提供链接。如果某可见变化没有截图,在其概况行标注“No screenshot yet”,并在那里说明屏幕上改变了什么。依据已有事实画图:关系用 Mermaid 图,数字用 `/visualize` 图表。绝不编造数字,也绝不绘制或生成未实际捕获的屏幕图。仅链接实际存在的制品。