SuperAPI AI 工具集

fable-advisor

智能体与模型

查看项目

更新于 10-25 00:10

技能介绍

用途

Fable Advisor 是一个咨询协议,供 Codex 或 Claude Code 的上级编排器在面临难以撤销的决策或真正卡住时,向 Claude Fable 获取一次精炼的战略性第二意见。其核心原则来自 Anthropic 的 advisor-tool 设计:Fable 提供判断,上级编排器负责探索、构建、编写和测试,绝不将生成工作交给 Fable。

主要能力

  • 咨询门槛:在每次咨询前回答两个问题——该决策是否难以撤销,或是否真正卡住?是否存在真正的岔路口?若答案是否定的,则跳过自动咨询。
  • 五个触发条件:代价高昂且难以撤销的决策(在构建前)、卡住时的升级(两次以上不同尝试失败)、计划评审(非平凡任务的实施计划草案)、完成前评审(生产部署、数据迁移等难以回退的交付物)、无人值守自动化设计(循环、调度、常规任务)。
  • 简报包:咨询时需提供约 800 词(上限 1200 词)的简报,包括决策(首行)、上下文、选项与倾向、硬性约束、关键证据、相关文件(最多 5 个)及要求的答案格式(结论先行,然后主要风险,然后改变想法的条件,300 词以内)。
  • 预算规则:每个任务默认一次咨询,硬性上限为三次 Fable 交互(原生生成、CLI 调用和跟进合并计算)。若需要第四次,说明问题定位有误。
  • 咨询方式:根据宿主环境选择路由——Codex 使用 claude -p 命令行,Claude Code 使用原生 fable-advisor 智能体(或回退到 general-purpose 并指定模型 fable 和 xhigh 努力级别)。
  • 处理建议:认真对待建议,但经验证据优先;冲突时进行一次协调调用,不静默切换;Fable 可以拒绝选项菜单并提出更好的方案。
  • 回报:在最终消息中告知用户已咨询 Fable(及次数)、其结论摘要,以及是否遵循了该结论(若未遵循,说明原因)。

使用方式

  1. 判断是否满足触发条件,并完成前置定位(阅读关键文件、收集约束)。
  2. 构建简报包,明确决策、选项、倾向、约束、证据和文件。
  3. 在调用前用一行公告咨询内容与次数(格式:Consulting Fable on <decision> (trigger: <which>, consult 1/3))。
  4. 按宿主路由执行咨询:Codex 使用 claude -p,Claude Code 使用原生 fable-advisor 智能体(参数示例:subagent_type: "fable-advisor",name: "fable-consult-1",run_in_background: false)。
  5. 要求 Fable 按指定格式回答(结论先行、主要风险、改变想法的条件,300 词以内)。
  6. 如需要,通过 SendMessage 发送一次跟进(仅新信息,不重新简报),或进行一次新的 CLI 调用。
  7. 处理建议并回报用户。

适用场景

  • 架构、数据库模式、数据模型、API 与 Webhook 契约、n8n 工作流拓扑、队列与单实例选择、技术或供应商选型等难以撤销的决策。
  • 两次以上不同尝试失败或出现无法解释的失败时升级咨询。
  • 非平凡任务的实施计划草案评审。
  • 生产部署、数据迁移等难以回退的交付物完成前评审。
  • 循环、调度、常规任务等无人值守自动化设计评审(检查停止条件、触发与间隔、每次迭代验证、成本、影响范围、静默失败模式)。

限制

  • 不用于容易回退的工作(重命名、文件内重构、添加标志、样式、文案)。
  • 不用于已由用户、仓库约定、AGENTS.md / CLAUDE.md 或记忆确定的决策。
  • 不用于路径清晰的常规实现,无论多长。
  • 不用于任何生成任务(代码、文档、配置、工作流)。
  • 不用于第一次失败尝试(应先尝试真正不同的方法)。
  • 不用于低风险且可轻松取消的循环(如只读轮询)。
  • 不用于卸载尚未完成的思考。
  • 不得将 Fable 用作普通子智能体(探索、实现、评审分发)的模型。
  • Codex CLI 路由固定使用 claude-fable-5-1,Claude Code 原生智能体使用宿主的 fable 别名;两路由均使用 xhigh 努力级别,但保留用户明确指定的模型或努力级别选择。
  • 咨询预算硬性上限为每任务三次 Fable 交互。