用途
pstack-ketchup(Ketchup)用于在 Pstack 任务期间,或用户明确要求时,帮用户“补课”:说明自用户上一条消息以来,这场对话里发生了什么变化,并让用户仅凭这条回复就能完成所有等待其作出的决定。
主要能力
- 假设用户只记得自己上一条消息,之后的一切都需要被说明。
- 汇总自身在用户上一条消息之后的工作、子智能体的报告,以及对话中其他人的消息;通知和子智能体结果不算用户的消息。
- 核对本对话涉及的每个 PR、CI 运行或智能体的当前状态,并检查将展示的每个数字是否与事实一致,纠正时予以说明。
- 识别“行动项”:只有用户能做的决定或步骤,例如产品选择、批准、不可逆操作或权限缺失;用户上一条消息之前提出但仍在等待的事项也纳入。自己能继续做的工作不算行动项。
- 对一组共享同一决定的多个事项(如一批待合并的 PR),统一写出决定和推荐,再逐项给出链接、对用户的影响、选择依据和风险;缺失事实标为“unknown”,没有的链接不写。
使用方式
在 Pstack 任务中或明确请求时调用。过程保持只读:不修改代码、不启动应用或任务、不发布任何内容;可视化只能基于已有材料制作。回复结构为:
- 用一句话开头,说明是否有事项等待用户,没有则直接结束。
- 展示发生了什么,宿主支持时优先放图。
- 每个用户请求的事项用一条短句总结结果,并注明完成、进行中、失败或未检查;单独成立,不把仍在等待用户的事标为完成。
- 最多三条能改变用户认知或行动的短句,再用一行列出自己还能做的工作。
- 列出行动项:说明用户拥有的决定(如合并、批准、选择)并给出推荐;跨选项的决定需列出每个选项的收益与成本。
表达与可视化规则
- 使用“bro”的口吻而非其任务:平实词语、短句、不用行话,像一个人给另一个人讲进展;说对用户的影响而非实现方式(例如说“测试通过了”而不是“CI 是绿的”)。
- 省略哈希、文件路径、命令、构建号和测试数量,除非用户需要其中一个来行动;用用户能懂的名字称呼 PR、分支或智能体,而非自造标签。
- 发生的事控制在 100 词以内(不计图片),每个事项约 30 词;不给事项设数量上限,也不为凑字数删减事项。
- 可视化仅限截图、视频、Mermaid 图、图表或生成图像,Markdown 表格不算;使用宿主支持的格式,最多六个框、每框最多八个词,标签用日常用语;不画状态列表、行动项列表或无连接的方框;同一事实不在文字或不同可视化中重复出现。
- 没有截图或视频的可见变化,在其总结行标注“暂无截图”,并说明屏幕上变了什么;只用已有事实画图,不编造数字,也不绘制未捕获的屏幕;只链接确实存在的产物。
适用场景与限制
适用于 Pstack 任务中需要向用户汇报进展、集中呈现待决策事项的场合。资料说明其过程只读,不提供代码修改、应用启动或发布能力;未提供关于收费、平台支持范围或具体实现细节的信息。