mcpField
F
fable-loop

fable-loop

github.com/sahir619Agent 工作流2.3k110 次安装4 周前更新
代码仓库

关于 fable-loop

The Fable Loop 是用于将 fable-method 应用于非简单任务的流程编排技能。它组织规划、执行、对抗式验证和报告,并在适当时将搜索与审查分配给子 Agent。

主要功能

  1. 01四阶段任务流程
  2. 02并行收集证据
  3. 03包含范围与检查项的计划文档
  4. 04对重要工作进行对抗式验证
  5. 05外部操作的授权关卡

适用场景

  1. 01规划并完成多步骤编码任务
  2. 02并行收集代码库或文档证据
  3. 03从不同角度审查重要变更
  4. 04未经授权时暂停外部操作

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sahir619/fable-method --skill fable-loop

安装后在 Claude Code 中输入/fable-loop确认已加载。

附带文件agents/openai.yaml

详细介绍

The Fable Loop

此技能负责协调 fable-method:请先阅读其 SKILL.md;其中的规则适用于每个阶段。它与此技能一同安装(位于此插件的 skills/fable-method/ 目录,或手动安装时位于 ~/.claude/skills/fable-method/)。该方法说明要检查什么;此循环说明由谁执行:哪些工作在主线程中运行,哪些工作分派给子 Agent,以及交付前要攻击什么。

先过门槛。 根据该方法的琐碎性门槛,若任务琐碎:直接完成,用一个显而易见的检查进行验证,并用两句话汇报。无需阶段,也无需子 Agent。其他所有任务都按顺序执行以下四个阶段。

阶段 1 - 规划(第一个前后环节)

  1. 应用方法步骤 0-3:对请求分类,明确完成标准并指定验证方式,说明关键假设。
  2. 分派证据收集任务。 在同一条消息中将证据收集工作并行分派给子 Agent,绝不按顺序逐个分派:
    • 代码库问题:针对每个不同领域,分派一个 Explore Agent(例如“X 如何工作”“哪些内容依赖 Y”);
    • 库或事实问题:分派一个研究 Agent,获取最新文档或搜索网络;
    • 每个子 Agent 都应返回经过提炼并附有引用依据的发现,绝不返回原始文件转储。 最多进行一批任务,再加一批后续任务;第三批必须说明理由。
  3. 按以下结构生成计划文档:分类;完成标准及其验证方式;找到的证据(附引用);一个推荐方案(每个被否决的替代方案用一句话说明);范围(工作涉及的确切文件或界面);风险和假设;执行检查清单。
  4. 决策门槛。 任务范围明确且可逆:无需询问,直接进入阶段 2。需要先制定计划的情况(范围不明确、操作不可逆或面向外部,或用户要求提供计划):展示计划文档并停止,等待批准。

阶段 2 - 执行

  1. 在主线程中按检查清单开展工作(如果运行环境提供 todo 工具,请使用它;完成后勾选相应条目)。决策和编辑都留在主线程中;只有搜索和验证工作才分派出去。
  2. 每次编辑都遵循方法步骤 4:行为变更前先过意图门槛;首次使用任何尚未打开过的内容前先过回忆门槛;做出最小的正确变更;精确编辑;未查看前绝不销毁内容。
  3. 独立的机械性任务(在多个文件中应用相同变更、生成彼此隔离的文件)可以在一条消息中并行分派给子 Agent;如果它们可能修改相同文件,应使用工作树隔离。
  4. 执行过程中遇到意外情况时,按方法步骤 2 规则 7 重新安排:说明情况,然后更新计划或返回阶段 1。绝不强行按原计划处理意外情况。
  5. 对某项工作一时不了解时,应暂停,而不是猜测:如果编辑需要依赖记忆中的事实(例如签名、键、数字),立即暂停该项工作,按照方法的回忆门槛分派一个研究子 Agent,并在收到结果后继续。
  6. 面向外部的检查清单条目须遵守方法的授权门槛:没有用户明确授权的原文引用,就不得执行操作;应将该条目改为报告中的建议后续步骤。

阶段 3 - 验证(以对抗方式)

  1. 亲自执行指定的验证,验证两方面:观察到完成标准(运行、渲染、计数);同时确认周边系统仍然健康(对受影响范围运行构建、测试、lint)。
  2. 对于影响重大的变更,分派攻击者。 并行分派 1-3 个子 Agent,让每个子 Agent 从不同角度尝试驳倒这项工作,例如:“阅读此 diff,证明这项变更有误或不完整”“在运行时测试变更后的行为,找出会导致失败的输入”“根据规范/文档检查此说法,并找出矛盾”“将完整变更集与计划声明的范围进行比较,证明有范围外的内容发生了变化”。不同的审查角度优于重复相同的审查。
  3. 经过自身检查后仍然成立的发现,应作为新工作返回阶段 2。根据该方法的硬性限制:同一问题的修复-验证循环失败 3 次,或遇到任何无法由你控制的阻碍,都必须停止并交接当前产出及你的假设。

阶段 4 - 审计并报告(第二个闭环)

  1. 按照寓言方法的审计模式进行自审:逐一检查每个方法步骤,标记为已遵循、已跳过或已造假。修复一轮检查能修复的问题(通常是未经验证的说法:现在就验证,或将其标记为注意事项)。
  2. 按照方法的第 6 步交付:第一句话说明结果,展示验证证据,坦诚说明注意事项,仅在工作过程中确实发现后续事项时才列出。报告中不得出现阶段名称或步骤编号;INTENT 和 AUTH 是报告中唯一可以包含的方法产物。

何时不应使用此循环

  • 简单任务(由门控机制处理)。
  • 无需多步工作的纯问答:普通的寓言方法足以应对。
  • 已处于编排好的 GSD 阶段中:由 GSD 负责该阶段;在其中应用寓言方法规则,而不是再嵌套循环。

模型资源利用

此循环与模型无关。证据收集和攻击者子 Agent 可使用成本较低的模型;主线程(决策、编辑)应使用可用的最强模型;如果可以选择,攻击者应比信息收集者投入更多推理力度。

评论

支持 Markdown