用途
cursor-ketchup 用于在聊天中执行 /ketchup 命令,让用户快速了解自其最后一条消息以来聊天中发生的已验证变化。它假设用户记得自己的最后一条消息,之后的内容一概不知,因此只汇报用户最后一条消息之后的变化。通知和子代理结果不算作用户的消息。
主要能力
- 收集自身工作、子代理报告以及聊天中其他人的消息。
- 检查聊天涉及的每个 PR、CI 运行或代理的当前状态。
- 核对将要展示的每个数字与其来源事实,并在更正时说明。
- 以简洁、口语化的方式说明对用户而言发生了什么,而非描述执行过程,例如说“测试通过了”而不是“CI 是绿色的”。
- 省略哈希、文件路径、命令、构建号和测试数量,除非用户需要其中某项来采取行动。
- 用用户能理解的名称称呼每个 PR、分支或代理,而非自创标签。
- 保持项目状态只读;仅在需要时基于现有证据创建本地状态产物,不修改代码、不启动服务或任务、不发布任何内容。允许打开现有产物进行检查。
使用方式
用户显式请求 /ketchup 时触发。回复整体控制在 150 词以内(含可视化和表格内的词)。开头用一句话说明有多少事项需要用户处理,或说明没有事项需要处理。若什么都没发生且没有事项等待用户,则说明并停止。随后用一个最多四个方框的可视化展示发生了什么,每个方框说明用户所要求事项的结果及其状态(完成、仍在运行、失败或未检查),方框内容需单独阅读时仍成立。可视化下方最多三行短句,用于改变用户认知或行动。然后一行说明自己还能做的剩余工作。
行动项是只有用户才能做出的决定或步骤,如产品选择、批准、不可逆操作或权限缺失。包括任何仍在等待用户的事项,即使是在其最后一条消息之前提出的。自己能做的工作不算行动项。绝不编造调用。用户未要求且工作不需要的步骤不算行动项,除非它不可逆且等待用户:此时给一行行动说明,不加可视化,并跳过用户不回答时的后果。每个行动项用两行说明:决定与建议及理由,然后是不回答时的后果。用户拥有的决定如合并、批准或选择。建议中放入自己会先采取的步骤,以及任何必须先发生的事项和不可撤销的事项。不知道的部分写“unknown”。链接到详情。
每个行动项以并排的前后对比可视化呈现。对于选择,将当前状态放在每个选项旁,或无当前状态时仅放选项。可视化中放入工作权衡过的每个选项,每个选项附带给用户带来什么和花费什么。这些内容不放在正文中。仅权限请求和未要求的不可逆步骤可跳过可视化。
可视化
可视化是图片:截图、视频、Mermaid 图、来自可用原生可视化工具的图表或示意图,或生成的图像。Markdown 表格不算可视化,即使有前后对比列。每个可视化需小到一眼可读:最多六个方框,每个方框最多八个词(不计“No screenshot yet.”)。标签用人们会说的平实词语,而非“Tests: pass”之类的标签。将小项合并到一个方框。需要一句话说明的事实应放在正文或省略。
当变化可见时使用截图或视频。若可见变化没有截图,将其所属方框标记为“No screenshot yet”,并在可视化下方一行说明屏幕上变化了什么。对于其他情况,根据已有事实绘制可视化:状态、流程和结构用 Mermaid 图,数字用可用的原生图表工具。绝不编造数字,绝不绘制或生成未捕获的屏幕图片。仅链接存在的产物。
Codex 呈现
遵循工作区选定的呈现界面。在需要面向人类的 HTML 产物时,使用 effective-html 并通过授权的原生预览检查其实际渲染输出。被拒绝或不可用的预览保持未验证;不要编造截图或绕过拒绝。产物措辞保持在同样简洁的追赶范围内。
适用场景
适用于用户在聊天中执行 /ketchup 命令,希望快速了解自其最后一条消息以来聊天中发生的已验证变化,并需要明确哪些事项等待其决定或行动的场景。
限制
- 仅汇报用户最后一条消息之后的变化,假设用户记得自己的最后一条消息。
- 回复整体控制在 150 词以内。
- 可视化最多四个方框(行动项可视化最多六个方框),每个方框最多八个词。
- 保持项目状态只读,不修改代码、不启动服务或任务、不发布任何内容。
- 绝不编造数字、截图或调用。
- 不知道的部分写“unknown”。
- 仅链接存在的产物。
- 关于收费、价格、平台支持等具体信息暂未提供。