SuperAPI AI 工具集

wtf

智能体与模型

查看项目

更新于 10-26 18:53

技能介绍

/wtf(bro)是一个策略型技能,所有实际机制由基于 bd 的 bro CLI 提供。其触发条件为用户调用 /wtf,或对代理自身的工作表达尖锐不满。核心产物有三类:wtf 记录是触发凭证,retro 记录是分析结论,prevention 记录承载后续预防工作。

前置条件:bro 已在 PATH 中,或通过 npx -y @broject/bro@0 调用;且已完成 bd init。

主要命令包括:bro wtf <complaint> 或 bro self retrospect capture <complaint>,用于开启一条 wtf 记录,逐字保存用户投诉并附上 git/当前目录快照;bro self retrospect schema 打印带注释的计划模板,模板结构由 CLI 定义;bro self retrospect record <plan.toml> 校验计划,关闭 retro 记录并写入分析备忘录,将每个 [[actions]] 条目转为带 sink:<sink> 标签的开放预防记录,同时关闭对应 wtf(可通过 retro.wtf、--wtf 或唯一开放项自动关联);bro self retrospect status 作为退出闸门,只要存在未回应的 wtf 就以退出码 1 结束;bro self retrospect list 列出 retro 记录与开放 wtf 记录。

策略要点:先记录再道歉,第一步必须用单引号以单个 argv 值逐字传入用户原话,不得转述或软化,避免双引号与复合 shell 命令以防元字符执行;分析对象是代理自身流程缺陷,需回看近期轮次中的提问、假设与遗漏,若处于压缩后且不确定应如实说明,不应编造忏悔,必要时先用 bro work drill down 深挖根因;计划是交付物,what/why 为必填,每个行动项都需指定修复落地的 sink;是否恢复常规工作由 status 命令的退出码决定。

按 sink 分流:backlog 保持排队;memory 写入用户或项目记忆(由作用域决定);agentic-documents 直接更新 AGENTS.md、规则或技能文件;upstream-issue 提交上游问题;workaround 立即实现修复。重复出现会扩大作用域:写计划前先 list,再对每条 retro 执行 bd show 读取 why 备忘录,同一根因按 session→agent→user→project→universal 逐级扩大。重复也会升级 sink:若已有文字规则仍复发,至少一个行动应落到 workaround 或 backlog,形成 CLI 校验、钩子或 schema 检查等机械性护栏。

适用场景为代理工作流中的失误复盘与流程改进;限制在于依赖 bro CLI 与 bd 初始化,且计划结构由 CLI 定义,本技能自身不执行具体机制。