关于 fable-loop
The Fable Loop 是用于将 fable-method 应用于非简单任务的流程编排技能。它组织规划、执行、对抗式验证和报告,并在适当时将搜索与审查分配给子 Agent。
主要功能
- 01四阶段任务流程
- 02并行收集证据
- 03包含范围与检查项的计划文档
- 04对重要工作进行对抗式验证
- 05外部操作的授权关卡
适用场景
- 01规划并完成多步骤编码任务
- 02并行收集代码库或文档证据
- 03从不同角度审查重要变更
- 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 - 规划(第一个前后环节)
- 应用方法步骤 0-3:对请求分类,明确完成标准并指定验证方式,说明关键假设。
- 分派证据收集任务。 在同一条消息中将证据收集工作并行分派给子 Agent,绝不按顺序逐个分派:
- 代码库问题:针对每个不同领域,分派一个 Explore Agent(例如“X 如何工作”“哪些内容依赖 Y”);
- 库或事实问题:分派一个研究 Agent,获取最新文档或搜索网络;
- 每个子 Agent 都应返回经过提炼并附有引用依据的发现,绝不返回原始文件转储。 最多进行一批任务,再加一批后续任务;第三批必须说明理由。
- 按以下结构生成计划文档:分类;完成标准及其验证方式;找到的证据(附引用);一个推荐方案(每个被否决的替代方案用一句话说明);范围(工作涉及的确切文件或界面);风险和假设;执行检查清单。
- 决策门槛。 任务范围明确且可逆:无需询问,直接进入阶段 2。需要先制定计划的情况(范围不明确、操作不可逆或面向外部,或用户要求提供计划):展示计划文档并停止,等待批准。
阶段 2 - 执行
- 在主线程中按检查清单开展工作(如果运行环境提供 todo 工具,请使用它;完成后勾选相应条目)。决策和编辑都留在主线程中;只有搜索和验证工作才分派出去。
- 每次编辑都遵循方法步骤 4:行为变更前先过意图门槛;首次使用任何尚未打开过的内容前先过回忆门槛;做出最小的正确变更;精确编辑;未查看前绝不销毁内容。
- 独立的机械性任务(在多个文件中应用相同变更、生成彼此隔离的文件)可以在一条消息中并行分派给子 Agent;如果它们可能修改相同文件,应使用工作树隔离。
- 执行过程中遇到意外情况时,按方法步骤 2 规则 7 重新安排:说明情况,然后更新计划或返回阶段 1。绝不强行按原计划处理意外情况。
- 对某项工作一时不了解时,应暂停,而不是猜测:如果编辑需要依赖记忆中的事实(例如签名、键、数字),立即暂停该项工作,按照方法的回忆门槛分派一个研究子 Agent,并在收到结果后继续。
- 面向外部的检查清单条目须遵守方法的授权门槛:没有用户明确授权的原文引用,就不得执行操作;应将该条目改为报告中的建议后续步骤。
阶段 3 - 验证(以对抗方式)
- 亲自执行指定的验证,验证两方面:观察到完成标准(运行、渲染、计数);同时确认周边系统仍然健康(对受影响范围运行构建、测试、lint)。
- 对于影响重大的变更,分派攻击者。 并行分派 1-3 个子 Agent,让每个子 Agent 从不同角度尝试驳倒这项工作,例如:“阅读此 diff,证明这项变更有误或不完整”“在运行时测试变更后的行为,找出会导致失败的输入”“根据规范/文档检查此说法,并找出矛盾”“将完整变更集与计划声明的范围进行比较,证明有范围外的内容发生了变化”。不同的审查角度优于重复相同的审查。
- 经过自身检查后仍然成立的发现,应作为新工作返回阶段 2。根据该方法的硬性限制:同一问题的修复-验证循环失败 3 次,或遇到任何无法由你控制的阻碍,都必须停止并交接当前产出及你的假设。
阶段 4 - 审计并报告(第二个闭环)
- 按照寓言方法的审计模式进行自审:逐一检查每个方法步骤,标记为已遵循、已跳过或已造假。修复一轮检查能修复的问题(通常是未经验证的说法:现在就验证,或将其标记为注意事项)。
- 按照方法的第 6 步交付:第一句话说明结果,展示验证证据,坦诚说明注意事项,仅在工作过程中确实发现后续事项时才列出。报告中不得出现阶段名称或步骤编号;INTENT 和 AUTH 是报告中唯一可以包含的方法产物。
何时不应使用此循环
- 简单任务(由门控机制处理)。
- 无需多步工作的纯问答:普通的寓言方法足以应对。
- 已处于编排好的 GSD 阶段中:由 GSD 负责该阶段;在其中应用寓言方法规则,而不是再嵌套循环。
模型资源利用
此循环与模型无关。证据收集和攻击者子 Agent 可使用成本较低的模型;主线程(决策、编辑)应使用可用的最强模型;如果可以选择,攻击者应比信息收集者投入更多推理力度。
评论
支持 Markdown