SuperAPI AI 工具集

fable-reporting

写作与研究

查看项目

更新于 10-16 08:02

技能介绍

用途:该技能聚焦于一个时刻——回合结束时写给用户看的最终消息。用户通常没有观看中间的搜索、diff 或测试过程,因此最终消息应面向“刚离开又回来”的同事,不预设对方知道你中途发明的简写,也不把过程日志当作报告。报告不是记录你做了什么,而是读者据此采取行动所需的信息。

主要能力与原则:

  1. 先讲结果。第一句回答“发生了什么”或“发现了什么”,即用户要的 TLDR;推理、证据与叙述放在其后。按时间顺序叙述是工作方式,几乎不是读者需要的方式。
  2. 选择而非压缩。可读性优先于简短。选择意味着删掉不改变读者下一步动作的细节;压缩则是保留所有细节却把文字挤成碎片、缩写、箭头链(A → B → fails)或未解释的表格,让读者被迫解码。检验标准:若读者需要重读一句或回翻才能理解“v2 路径”指什么,报告即失败。
  3. 诚实的账本。测试失败就说出失败并引用断言,不能写“大体通过”;跳过某步要说明并给出原因,沉默会被读成“已完成”;已完成且已验证就直说,不加含糊;未验证要写“我尚未验证这一点”,而不是“现在应该可以了”——should 是你在报告一个希望,而希望只是线索不是结果。一次不诚实的“完成”比十次诚实的“受阻,原因如下”更损害信任。
  4. 一切落在最终消息里。工具调用之间写的文字可能永远不会被看到。最终消息必须独立成立:答案、关键发现、注意事项,即使与回合中说过的话重复也要写全。只存在于思考中或三次工具调用前的状态说明里的结论等于不存在。
  5. 末段检查。发送前读自己的最后一段:若它是计划、是任务范围已覆盖的下一步清单,或是承诺(“我接下来会跑测试”),那不算报告,而是半途停下的工作。先做完再报告已完成。只有在真正受阻时才以下一步结尾:需要只有用户能提供的输入,或需要批准超出任务范围(不可逆或超出所问)的动作,此时明确说出你需要什么。在评估型回合中,修复本身属于范围之外,因此“原因是 X,说一声我就提交修复”是正确结尾。

适用场景:AI 助手在编码、调试、调查任务结束时撰写结果汇报,以及回合过程中的状态更新。

限制:资料未提供该技能的具体安装方式、平台支持、收费信息或命令示例。它是 fable-* 系列五个技能中的第五个,其余为 fable-intake(阅读请求)、fable-diagnosis(调查失败)、fable-decision(选择方案)、fable-implementation(编写代码)。