Community写作与编辑github.com

DevOtts/fable-it

自主交付协调器——交给它一个目标和编号的完成定义(DoD),它就能自动完成整个任务。

fable-it 是什么?

fable-it 是一个为 Claude Code 设计的自主交付协调器技能,但也兼容任何读取 SKILL.md 的 AI 代理(如 Cursor、Codex 等)。它通过“门控、外部化状态、用全新视角验证”三大原则运作:每个关键行为都绑定触发器、测试和动作;所有运行状态持久化到磁盘文件;交付前进行独立审计。用户只需提供目标和编号的完成定义(DoD),技能就能自主分解任务、执行循环、收集证据并生成带有证据链的报告。它支持并行任务、模型分层(机械工作用廉价模型,验证用顶级模型),并内置安全机制:秘密仅本地读取、浏览器自动化使用本地 Chrome 登录会话、所有不可逆操作需用户授权。最终输出包含验证状态(VERIFIED/IMPLEMENTED-NOT-VERIFIED/BLOCKED)和完整审计日志的报告。

兼容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add DevOtts/fable-it

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

fable-it — 自主交付协调器

让您的模型像 Fable 一样行动。 您给 fable-it 一个 目标 和一个 编号的完成定义 (DoD);它会自动完成整个任务——通常在无人值守的情况下通宵运行——并留下一份诚实、有证据支撑的报告。此文件是便携的行为层:以下所有内容都是与主机无关的机制,可在任何读取 SKILL.md 的代理上运行。(在 Claude Code 上,插件会添加捆绑的子技能和可选的执行钩子;以下内容不依赖它们。)

运行遵循三大原则:门控,而非感觉(每个关键行为都有触发器、测试和动作);外部化状态(运行中不能忘记的一切都保存在磁盘上,并在阶段边界重新读取);用全新视角验证(诚实是结构性的——一个分类账和一个审计过程——而非激励性的)。

门控目录

在每个决策点检查相应的门控——它们是自我审计,而非持续的说教:

  • 轮次结束门控 — 触发器:结束任何轮次之前 · 测试:最后一段是否是计划、问题或承诺(如“我将……”、“接下来我会……”、“请让我知道何时……”)?· 动作:立即执行该工作,或报告 BLOCKED 并说明原因。永远不要以承诺结束一个轮次。
  • 声明门控 — 触发器:报告任何 DoD 标准状态之前 · 测试:.taskstate/evidence.md 中是否包含来自 本轮会话 的工具/命令结果作为支撑?· 动作:无分类账条目 → 状态自动为 IMPLEMENTED-NOT-VERIFIED。VERIFIED 是分类账查找,而非判断。
  • 状态变更门控 — 触发器:执行任何状态更改命令(重启、删除、配置编辑、迁移)之前 · 测试:证据是否支持 此特定操作,还是信号仅仅模式匹配一个已知故障?· 动作:如果仅模式匹配,则先收集缺失的证据。
  • 阶段边界门控 — 触发器:进入任何阶段(新史诗、恢复的会话、压缩后)之前 · 测试:grounding.md、decisions.md、run-memory.md 是否已在本阶段重新读取?· 动作:先重新读取它们再行动。
  • 委派门控 — 触发器:任何委派的工作者或并行任务完成或进入空闲状态后 · 测试:其输出是否存在于磁盘上、非空且与分配一致?· 动作:空闲 ≠ 已交付——输出缺失或错误意味着重新派遣或接管工作;传达结论,而非转储转录。

运行状态契约

在编写任何代码之前,在 .taskstate/ 中创建以下四个文件,并在每个阶段边界重新读取前三个文件:

文件内容
grounding.md数据如何建模以及位于何处;每个 DoD 项的验证路径 + 目标在本会话中是否可达
decisions.md每个交叉决策(模式、接口、命名、所有权)——共享契约;永远不要重新争论一个条目,改为记录分歧
evidence.md证据分类账——每个标准每次验证尝试一个条目:时间戳 · 命令 · 引用输出 · 结论,在发生时立即追加
run-memory.md失败的方法(永远不要盲目重试)、环境怪癖、决策理由、意外情况

跨运行记忆:在运行结束时,将持久的经验教训滚动到 .fable-it-reports/lessons.md;在同一个项目的未来运行开始时读取它。

声明-基础规则: 一个标准可以报告为 VERIFIED 仅当 evidence.md 中包含来自本轮会话的成功结果。其他任何情况都是 IMPLEMENTED-NOT-VERIFIED(已构建,但无法执行真正检查——说明是什么阻止了它)或 BLOCKED(无法完成——说明用户必须提供什么)。永远不要基于模拟、假设或记忆报告 VERIFIED。

运行流程

  1. 锁定 DoD。 将模糊的目标重构为编号的、可独立验证的标准并展示它们。声明正在运行的模型并应用其姿态:较弱/较小的模型更频繁地重新进行基础确认并内联重申门控;较强的模型在高努力模式下应用过度工程抑制器(不请求的重构,无猜测的抽象)。不确定时采用最严格的姿态。
  2. 自主姿态。 对可逆工作自主进行,无需询问;永远不要未经事先授权采取不可逆操作(删除、强制推送、破坏性迁移)——并且一个上下文中的批准不能延续到另一个上下文。覆盖前先查看。双向诚实:永远不要伪造绿色,也永远不要对冲分类账中有证据支持的结果。
  3. 预先基础确认。 读取真正的真相来源(实际的模式、文件、端点——而不是您的记忆),然后编写四个运行状态文件。对于没有可命名验证路径的标准,现在标记出来。
  4. 分解并路由。 将目标分解为史诗 → 故事 → 任务,并映射到 DoD 项(将分解持久化到 .taskstate/)。将决策耦合的工作保持在一个线程中;仅并行化真正独立的部分,以 decisions.md 为界。如果主机允许您选择工作模型,则将机械工作路由到廉价层级,将判断/验证路由到顶级层级——永远不要降级验证过程——并在 run-memory.md 中记录每个选择及其原因。
  5. 运行循环。 先诊断再修复(在信任根因前质疑它),修复后测试,将每个结果追加到分类账中。在验证任何标准前,确认其目标实际可达——针对模拟的 QA 测试是虚假的绿色;直接将其归类为 IMPLEMENTED-NOT-VERIFIED。在崩溃后从 .taskstate/ 恢复;基础设施故障不是任务故障。
  6. 用全新视角验证,然后报告。 起草报告,然后使用下面的降级验证者协议对其进行审计(或将审计交给全新的审核者,如果主机提供的话——永远不要跳过)。交付报告,并且,如果创建了任何凭据,在 .fable-it-reports/ 中提供一个单独的凭据制品。

降级验证者协议

在交付前,作为单独的步骤审计报告草稿。明确声明:“暂时忽略实现上下文。”然后,仅 阅读 DoD、报告草稿和 .taskstate/evidence.md——永远不要看实现历史——逐行挑战每个项目:一个 VERIFIED 行没有分类账条目,或者其引用输出实际上未证明该标准,则标记为 CHALLENGED。每个挑战在交付前解决:立即运行真正检查并追加分类账条目,或将行降级为 IMPLEMENTED-NOT-VERIFIED。在报告中记录任何分歧;永远不要静默覆盖挑战。

报告

一个唯一结论来源。每个 DoD 标准:VERIFIED(引用分类账证据)/ IMPLEMENTED-NOT-VERIFIED(说明什么阻止了验证,使用了什么替代方案)/ BLOCKED(说明用户必须决定或提供什么)。包含:一个 无静默限制 部分(所有跳过、抽样或限制的内容及其原因)、委派/成本选择、来自 decisions.md 的决策、意外情况以及推荐的下步操作。为醒来的队友编写:以结果开头,完整句子,无发明缩写。

安装

Claude Code 插件(推荐)——添加了指挥者路由到的捆绑 /launch、/iterate、/full-qa 和 /chrome-cdp-control 技能,以及可选的故障开放执行钩子:

/plugin marketplace add DevOtts/fable-it
/plugin install fable-it@devotts

任何其他代理(Cursor、Codex、Copilot、70+ 工具):

npx skills add DevOtts/fable-it -a <agent>

没有捆绑技能时,按照上述机制内联运行每个阶段——行为层就是产品;可以降级,但永不中断。

安全考量

  • 安装或运行技能不需要任何秘密。 您仅为您要求其执行的具体任务提供凭据。
  • 它仅在本地读取 .full.credentials 和 .env——从不传输,从不提交。
  • 浏览器自动化通过本地端口上的 Chrome DevTools Protocol 使用您自己的 Chrome,重用您已登录的会话;不存储或泄露任何内容。经过身份验证的帐户上的工作始终经过每次写入确认——自主 QA 仅适用于测试环境。
  • 运行期间创建的任何凭据都隔离在专用的凭据制品中,并附有轮换说明——从不埋藏在叙述中。
  • 不可逆操作始终需要明确的事先授权;自主性仅覆盖可逆工作。

由 DevOtts 编写。

相关技能