imMamdouhaboammar/get-fable

get-fable

如果你已经在用的编程智能体，能更像 Claude Fable 那样工作，会怎样？

同样的模型。更好的工作习惯。一个强大得多的编程循环。

npm version
CI
Security
E2E
License: MIT

29 个互联的 Skills · 路由 · 研究 · 规划 · 架构 · TDD · 验证 · 审查 · 红队 · 安全修复 · 恢复 · gRPC worker · TOON 协议 · DSH 插件 · 发布

bun add -g get-fable

从这里开始 · 工作原理 · Skills · 文档

我一直在反复思考一个问题

如果你能把你已经在用的编程智能体——Codex、Claude Code、Gemini、OpenCode、Cursor、本地模型、更便宜的模型，无论你碰巧用的是什么——拿来，让它更像一个严肃的编程伙伴那样工作，会怎样？

不是通过换模型。

不是通过写一个巨大的系统提示词，然后指望它在四十分钟后仍然管用。

而是通过改变模型周围发生的事情。

这个问题就是 get-fable 的起点。

因为当人们谈论一个出色的编程智能体时，他们通常首先谈论模型。显然模型很重要。非常重要。

但模型并不是全部体验。

一个强大的编程伙伴还知道什么时候该在动手之前先检查。什么时候该停止猜测，去查阅最新的文档。什么时候一个 bug 需要先有一个失败的测试，然后才去修复。什么时候一个任务大到需要规划。什么时候两个 worker 能够真正并行工作——以及什么时候它们绝对不应该。什么时候一个通过的测试已经过时了，因为代码在那之后又变了。什么时候三次失败的尝试意味着重新思考诊断，而不是再试第四次同样的补丁变体。

这种行为不只是纯粹的智能。

其中很大一部分是脚手架（harness）。

get-fable 就是一次尝试，把这种脚手架带给几乎任何编程智能体。

目标刻意定得很高：把你已经在用的智能体，推向更接近你期望从顶级编程伙伴那里得到的纪律性。

不，它不会魔法般地把一个小型本地模型变成 Claude Fable。
但它可以为那个模型提供一种更好的方式来处理真实的软件工作。

而当底层的模型已经足够强大时，测试框架就有更多可以发挥的空间。

模型只是智能体的一部分

两个智能体可以使用完全不同的模型，却仍然犯下相同的错误。

它们都可能过早开始编辑。

它们都可能在长任务进行到一半时丢失最初的计划。

它们都可能依赖关于某个 API 的过时知识。

它们都可能在没有先证明 bug 存在的情况下就修补 bug。

它们都可能运行测试、又改动五个文件，却仍然把旧的测试运行当作证据。

它们都可能因为文件看起来不同就把工作拆分给子智能体，而实际上这些工作者正在悄悄改动同一个契约。

它们都可能不断重试一个显然行不通的方法。

而它们都可能以智能体编程中最危险的一句话收尾：

“完成了。”

get-fable 解决的正是问题中的这一部分。

它并不取代模型。

它为模型包裹上一种工作方式。

你的编程智能体
+
GET-FABLE 测试框架
↓
发现
研究
规划
测试
委派
执行
验证
审查
安全
恢复
发布
↓
一个更有纪律的编程循环

那么 get-fable 到底做什么？

它给智能体提供 28 个相互关联的专家技能，以及一个决定每个技能何时应该接手的生命周期。

一个普通的 bug 请求不应该立刻意味着“编辑生产代码”。

“修复 token 刷新竞态条件”

↓

该行为实际上存在于哪里？
↓
我们能可靠地复现它吗？
↓
哪个测试层级跨越了真正的失败边界？
↓
RED 是否因正确的原因而失败？
↓
做出最小的生产代码改动
↓
全新的 GREEN
↓
探查相邻的竞态/错误路径
↓
验证当前的变更
↓
审查实际的 diff

一个发布请求则遵循不同的路径。

一个不熟悉的 SDK 应该触发在实现之前对当前一手资料的研究。

一次反复出现的失败应该停止改动并进入诊断。

一个安全敏感的改动应该沿着信任边界进行追踪，而不是因为扫描器返回干净结果就放行。

工作流跟随工作本身。

这不是一个提示词包

这一区别很重要。

一个提示词可以说：

验证你的工作

get-fable 可以追踪到仓库在验证之后发生了改动，并把旧证据视为过时。

一个提示词可以说：

使用 TDD

fable-tdd 现在能区分有效的 RED 与语法错误、损坏的测试夹具、过时的产物、虚假通过的 mock，或仅仅因为休眠时间足够长才通过的并发测试。

一个提示词可以说：

使用子智能体

fable-delegate 会追问工作是否在语义层面独立，而不仅仅是两个工作者是否触及不同的文件。

一个提示词可以说：

仔细调试
fable-recover 冻结盲目变更，构建按优先级排序的假设队列，选择具有区分度的探针，证伪错误理论，然后才发出一个有界修复。

提示词可以这样说：

确保发布能够正常工作

fable-release 将源代码正确性与用户实际安装的产物区分开来，然后区分 READY_NOT_PUBLISHED、PUBLISHED_UNVERIFIED 和真正的 RELEASED。

这就是项目的方向：不是更多的指令，而是围绕指令的更多操作性判断。

深度技能手册 V2

每个规范技能都承载完整的操作性知识和架构纪律：

- 激活边界：何时激活、拒绝或推迟的精确标准；
- 情境分类：行动前针对模糊情况的分类法和决策分支；
- 分阶段执行：可验证的、逐步的证据协议，带有红/绿门禁；
- 架构不变量：必须始终成立、不可协商的约束；
- 失败处理：出错时改变下一步行动的可操作分类法；
- 反模式防护：明确列举需要避免的诱人反模式；
- 结构化产物：机器可验证的凭据、模板和状态交接；
- 渐进式参考：针对复杂场景的大量深度指南（>1,000 至 >3,000 字节）；
- 行为评估：每个技能全面的 10 场景评估基准。

来之不易的工程推理直接存在于技能之中——在所有模型层级上提供可靠、确定性的执行。

29 个技能。一种工作方式。

理解工作

get-fable — 根据意图和持久状态选择下一位专家，优先考虑失败、安全、过期证明和未知项。

fable-discover — 追踪真实的仓库/运行时执行路径，而不是根据文件名和导入进行猜测。

fable-research — 依据与版本相符的一手来源解决当前的外部事实问题。

fable-plan — 将证据转化为依赖感知、风险感知、可证伪的工作卡片。

构建变更

fable-architecture — 评估规模、领域解耦和资源强度向量，当阈值越过限制时锁定单体脚手架，强制执行双传输边界（REST 与 gRPC），并在搭建脚手架之前规定多语言技术栈矩阵。

fable-tdd — 在生产变更之前，通过正确的测试边界证明行为差距。

fable-delegate — 仅当写入、语义和验证独立性真实存在时才并行化。

fable-execute — 在保护范围、事实来源和用户工作的同时，实现一张有界卡片。

fable-simplify — 在不悄悄改变行为的前提下降低复杂度。

证明它

fable-verify — 构建主张 → 失败模式 → 证据矩阵，并尝试证伪该实现。

fable-review — 检查实际差异以发现具体的失败场景，而不是进行风格评论表演。
fable-security — 跨信任边界追踪攻击者控制的输入，并以怀疑态度验证发现。

fable-redteam — 运行企业级自动化渗透测试、CVSS v3.1 评分、熔断器保护、SARIF 报告和加密运行证明。

fable-heal — 针对 fable-redteam 识别的漏洞，自动合成、应用并验证安全修复。

fable-simulator — 与独立预言机进行对比，而不将模拟与生产证明混为一谈。

fable-eval — 衡量 agent 行为的变化，而不出现基准过拟合或预言机泄漏。

让长会话保持清醒

fable-recover — 在反复失败后停止盲目重试，重建因果信心。

fable-spark — 建议最小可用的下一步行动——或者当另一个建议只会成为噪音时保持沉默。

fable-memory — 以作用域、来源、取代和密钥安全规则保存持久事实。

fable-handoff — 为另一个 agent/会话创建真正的可恢复性契约。

fable-cowork — 自主执行长期范围内的既定工作，而不丢弃生命周期门控或授权边界。

fable-loop — 使用显式状态机、预算、退避和诚实的停止原因轮询变化的条件。

与环境协作

fable-run — 启动确切的运行时产物，并将生成、就绪、功能证明和清理分开处理。

fable-config — 以优先级、最小权限、主机能力诚实性和行为验证来更改 harness 设置。

构建人们可用的证据

fable-dataviz — 选择真实的视觉编码，保留指标语义，并审计误导性的比例尺/变换。

fable-artifact — 生成有来源依据的文档和图表，使其在对话之外仍然可用。

扩展 harness

fable-skill-creator — 按照相同的 V2 标准编写新的 Skills，而不是克隆浅层模板。

fable-learning — 从已完成的会话中提取结构化学习成果、可复用模式和 agent-kernel Playbooks。

探索规范 Skill 目录 →

Fable Spark：有时最好的下一步行动很小

在长时间的编码会话中，agent 通常不需要再来一页建议。

它需要一个有用的行动。

reproduce the bug
check the exact installed SDK version
write the failing contract test
compare source and built entrypoints
review the current diff
rerun evidence after the last mutation
stop retrying and diagnose

或者什么都不需要。

当当前专家已经拥有明显的下一步时，Spark 被明确允许保持沉默。

get-fable spark

与你已经在使用的编码 agent 协作

get-fable 可跨 32 个 AI 编码 agent、平台和 IDE 使用，而不是绑定到某一个模型或编辑器。

专有与商业市场

| Agent / Tool | Integration Tier | Key Capabilities |
|:---|:---|:---|
|  Claude Code (Anthropic) | 全生命周期 | 5 个 Python hooks（settings.json）、29 个规范技能、CLAUDE.md 中的规则、Marketplace 插件 |
|  Gemini CLI / Google Antigravity (Google) | 全生命周期 | hooks.json 生命周期触发器、插件清单、规范技能、章程规则 |
|  Grok Build (xAI) | 全生命周期 | hooks.json 生命周期触发器、Grok 插件清单、规范技能、章程规则 |
|  OpenAI Codex & ChatGPT (OpenAI) | 技能 + 规则 + 插件 | .codex-plugin/plugin.json、ChatGPT OpenAPI Custom Actions、~/.codex/skills/ 中的技能 |
|  Cursor (Anysphere) | 建议性规则 + 插件 | .cursor/rules/fable-lifecycle.mdc、.cursor-plugin/marketplace.json |
|  GitHub Copilot Agent Mode (GitHub / Microsoft) | 建议性规则 | ~/.copilot/rules/fable.md 中的全局规则及项目 .github/copilot-instructions.md |
|  Devin (Cognition) | 技能 + 规则 | 全局 ~/.devin/instructions.md、规则以及 ~/.devin/skills/ 中的规范技能 |
|  Windsurf (Codeium) | 建议性规则 | ~/.codeium/windsurf/rules.md 中的全局规则及项目 .windsurfrules |
|  Replit Agent (Replit) | 建议性规则 | ~/.replit/rules/fable.md 中的全局规则及项目 .replit.md |
|  Amazon Q Dev (Amazon Web Services) | 建议性规则 | ~/.aws/amazon-q/rules/fable.md 中的全局规则及项目 .amazonq/rules.md |
|  Trae (ByteDance) | 建议性规则 | ~/.trae/rules/fable.md 中的全局规则及项目 .trae/rules/fable.md |
|  Warp AI (Warp Terminal) | 建议性规则 | ~/.warp/rules/fable.md 中的全局规则 |
|  Kimi K3 (Moonshot AI) | 建议性规则 | ~/.kimi/rules/fable.md 中的规则 |
|  Atlarix（Atlarix 桌面 Copilot） | 咨询规则 | 规则位于 ~/.atlarix/rules/fable.md |
|  Vellum（Vellum 工作流平台） | 咨询规则 | 规则位于 ~/.vellum/rules/fable.md |
|  Codegen（Codegen 平台） | 咨询规则 | 规则位于 ~/.codegen/rules/fable.md |
|  Muse Code（Muse） | 咨询规则 | 规则位于 ~/.muse/rules/fable.md |
|  Junie（JetBrains） | 咨询规则 | 全局规则位于 ~/.junie/rules/fable.md 及项目 .junie/rules/fable.md |
|  Qodo（原 CodiumAI） | 咨询规则 | 全局规则位于 ~/.qodo/rules/fable.md 及项目 .qodo/rules/fable.md |
|  Roo Code | 技能 + 规则 | 全局规则 ~/.roo/rules/fable.md，技能位于 ~/.roo/skills/，以及项目 .roomodes |

开源与社区市场

| 智能体 / 工具 | 集成层级 | 关键能力 |
|:---|:---|:---|
|  Aider（Git 优先 CLI 智能体） | 咨询规则 | 全局规则位于 ~/.aider/rules/fable.md 及项目 .aider.prompt.md |
|  Cline（自主 BYOK 智能体） | 技能 + 规则 | 全局规则位于 ~/.cline/rules/fable.md，技能位于 ~/.cline/skills/，以及 .clinerules |
|  OpenHands（原 OpenDevin） | 技能 + 规则 | 全局微智能体位于 ~/.openhands/microagents/，技能位于 ~/.openhands/skills/ |
|  OpenCode（SST） | 技能 + 规则 | 规则位于 ~/.opencode/rules/fable.md，技能位于 ~/.opencode/skills/ |
|  Continue（IDE 扩展层） | 咨询规则 | 全局规则位于 ~/.continue/rules/fable.md 及项目 .continue/rules/fable.md |
|  Kilo Code（Kilo 平台） | 技能 + 规则 | 全局规则位于 ~/.kilo/rules/fable.md，技能位于 ~/.kilo/skills/ |
|  Plandex（终端多文件引擎） | 建议规则 | 全局规则位于 ~/.plandex/rules/fable.md 与项目 .plandex/context.md |
|  AutoGPT（Significant-Gravitas） | 建议规则 | 全局规则位于 ~/.autogpt/rules/fable.md |
|  Kiro | 规则 + 钩子 | 规则位于 ~/.kiro/rules/fable.md 及生命周期触发器 |
|  DeepSeek Harness (DSH) | 插件 + UI | Cordis 插件包（cordis.patch.yml）、REST 后端，以及所消费的 React Web UI |
|  Pi Code | 建议规则 | 规则位于 ~/.pi/rules/fable.md |

集成深度取决于每个宿主实际暴露的能力：

- Cordis 插件与所消费的 Web UI — DeepSeek Harness (DSH)
- 完整生命周期集成 — Claude Code、Antigravity、Grok Build
- 技能 + 规则集成 — Codex、Devin、OpenCode、Roo Code、Cline、OpenHands、Kilo Code、Hermes Agent
- 建议规则集成 — Cursor、Copilot、Windsurf、Replit、Amazon Q、Trae、Warp、Kimi、Atlarix、Vellum、Codegen、Muse、Junie、Qodo、Aider、Continue、Plandex、AutoGPT、Kiro、Pi Code

这种区分是有意为之。一个能够加载规则但无法注册生命周期钩子的宿主，不应被描述为具备它实际上并不提供的强制执行能力。

查看宿主能力矩阵 →

按宿主划分的安装命令

get-fable install all
get-fable install claude
get-fable install antigravity
get-fable install grok
get-fable install codex
get-fable install cursor
get-fable install copilot
get-fable install devin
get-fable install windsurf
get-fable install replit
get-fable install amazonq
get-fable install trae
get-fable install warp
get-fable install kimi
get-fable install atlarix
get-fable install vellum
get-fable install codegen
get-fable install muse
get-fable install junie
get-fable install qodo
get-fable install roocode
get-fable install aider
get-fable install cline
get-fable install openhands
get-fable install opencode
get-fable install continue
get-fable install kilo
get-fable install plandex
get-fable install autogpt
get-fable install hermes
get-fable install deepseek
get-fable install dsh
get-fable install kiro
get-fable install pi
get-fable install no-mistakes

DeepSeek Harness (DSH) 插件安装：

dsh plugin add imMamdouhaboammar/get-fable

在配置 DSH 插件的 projectRoot 时，即使宿主从其他位置启动，新的路由状态也归属于该项目。路由预览不会
创建 .fable 状态；应用该路由会将其写入已配置的项目。

Claude Code 市场安装：

/plugin marketplace add imMamdouhaboammar/get-fable
/plugin install get-fable@get-fable

快速安装

Bun（推荐）
bun add -g get-fable

npm
npm install -g get-fable

Homebrew（macOS 和 Linux）
brew tap imMamdouhaboammar/get-fable && brew install get-fable

单行 shell 安装脚本（CI、Docker、裸机）
curl -fsSL https://raw.githubusercontent.com/imMamdouhaboammar/get-fable/master/install.sh | bash

仅技能包（Vercel / skills.sh）
bunx skills add imMamdouhaboammar/get-fable

DeepSeek Harness (DSH) Cordis 插件
dsh plugin add imMamdouhaboammar/get-fable

Claude Code 市场
/plugin marketplace add imMamdouhaboammar/get-fable
/plugin install get-fable@get-fable

完整安装路径

安装 CLI 后，按照以下步骤操作一次，即可在你的各个 agent 和项目中启用完整生命周期。

步骤 1 — 安装 CLI

bun add -g get-fable
get-fable --version   # 确认二进制文件已在 PATH 中

步骤 2 — 配置你的编码 agent

一次性配置所有 agent（推荐）
get-fable install all

或单独选择
get-fable install claude        # Claude Code   — 完整生命周期钩子 + 技能
get-fable install antigravity   # Google Antigravity / Gemini CLI — 钩子 + 插件
get-fable install grok          # Grok Build (xAI) — 钩子 + 插件
get-fable install codex         # OpenAI Codex + ChatGPT — 插件 + 技能
get-fable install cursor        # Cursor — 建议规则 + 插件
get-fable install copilot       # GitHub Copilot — 建议规则
get-fable install devin         # Devin — 技能 + 规则
get-fable install windsurf      # Windsurf — 建议规则
get-fable install replit        # Replit Agent — 建议规则
get-fable install amazonq       # Amazon Q Dev — 建议规则
get-fable install trae          # Trae — 建议规则
get-fable install warp          # Warp AI — 建议规则
get-fable install kimi          # Moonshot Kimi — 建议规则
get-fable install roocode       # Roo Code — 技能 + 规则
get-fable install cline         # Cline — 技能 + 规则
get-fable install openhands     # OpenHands — 技能 + 规则
get-fable install opencode      # OpenCode — 技能 + 规则
get-fable install kilo          # Kilo Code — 技能 + 规则
get-fable install aider         # Aider — 建议规则
get-fable install continue      # Continue — 建议规则
get-fable install plandex       # Plandex — 建议规则
get-fable install autogpt       # AutoGPT — 建议规则
get-fable install hermes        # Hermes Agent — 技能 + 规则
get-fable install kiro          # Kiro — 规则 + 钩子
get-fable install dsh           # DeepSeek Harness — Cordis 插件 + Web UI
get-fable install pi            # Pi Code — 建议规则
get-fable install no-mistakes   # no-mistakes 质量门禁 + pre-push 钩子

步骤 3 — 初始化项目
cd your-project
get-fable init

创建 .fable/state.json、.fable/LEDGER.md、.fable/PROGRESS.md 和 docs/SPEC.md。

第 4 步 — 验证健康状况

get-fable doctor          # 42 项系统检查 — 技能、钩子、状态、供应链
get-fable doctor --json-v1  # 机器可读的诊断信封
get-fable lint            # 账本 + 状态完成语义

第 5 步 — 路由你的第一个任务

get-fable route "Fix the checkout race condition and verify it with a regression test"

在任何时候获取最小可用的下一步行动：

get-fable spark

第 6 步 — 架构评估（新项目）

get-fable arch-eval "High-throughput fintech ledger with 100k TPS and polyglot datastores"
→ outputs composite score, monolith lockout decision, dual-transport contract, language matrix

第 7 步 — 安全与质量门禁

Red team scan against a local target
get-fable redteam scan --target http://127.0.0.1:3000 --profile api-logic

CI/CD baseline diff + CVSS threshold gate
get-fable redteam scan --target http://127.0.0.1:3000 \
--baseline .fable/baseline.json --fail-on-cvss 7.0

Auto-heal findings from the last red team run
get-fable route "remediate redteam findings"

no-mistakes pre-push quality gate
get-fable install-no-mistakes

第 8 步 — gRPC 工作进程（分布式执行）

Start the Fable Worker gRPC server
get-fable worker-serve

Behavioral evaluation pipeline
get-fable behavior-eval export --out /tmp/fable-behavior-requests.json
get-fable behavior-eval score /tmp/provider-responses.json \
--out evals/results/agent-behavior-v1.json
get-fable behavior-eval status

Shell 集成（可选）

将实时提示提示符和生命周期别名添加到你的 shell 配置文件中：

Zsh (~/.zshrc)
eval "$(get-fable shell zsh)"

Bash (~/.bashrc or ~/.bash_profile)
eval "$(get-fable shell bash)"

Fish (~/.config/fish/config.fish)
get-fable shell fish | source

启用的别名：gfr（route）、gfs（spark）、gfe（evidence）、gfc（card）、gfl（lint）、gfd（doctor）、gfm（mutation）、gfst（status）。

📖 完整多主机与平台指南：有关钩子、shell 补全和各个代理环境的详细配置，请参阅 docs/INSTALLATION.md。

行为证明：令人不适的部分是有意为之

get-fable 将 “技能存在” 和 “技能已被证明行为正确” 视为不同的主张。

先前版本的目录包含一次外部提供者证据运行，涵盖 115 个盲测案例，115 次通过，零禁止行为违规。

那次运行是有用的历史记录。

它不是 Deep Skill Playbooks V2 的新鲜证明。

V2 实质性地更改了指令并扩展了语义场景语料库。因此，证据哈希应使旧的行为结果失效。

这是特性，不是回归。
在当前 V2 请求包针对独立提供方执行并重新评分之前，受影响的行为成熟度应保持 NOT_CHECKED，而不是神奇地继承旧的 M4 徽章。

当前工作流是：

get-fable behavior-eval export --out /tmp/get-fable-behavior-requests.json
execute the blinded requests with an independent provider
get-fable behavior-eval score /tmp/provider-responses.json \
--out evals/results/agent-behavior-v1.json
get-fable behavior-eval status
get-fable doctor --json-v1

导出的请求包由当前 Skill 语料库生成，因此 README 刻意不硬编码 V2 请求数量。

阅读行为证据协议 →

默认本地优先

get-fable 的设计目标是在不把你的仓库变成遥测产品的前提下增加流程。

- 遥测默认禁用；
- 状态和证据与项目一起保存在本地；
- 极简的零遥测依赖（@grpc/grpc-js、@grpc/proto-loader、@toon-format/toon），用于高性能 gRPC 和 TOON 序列化；
- Skill 安装会拒绝路径穿越和符号链接逃逸；
- 本地代理默认绑定到回环地址；
- GitHub Actions 固定到不可变的提交 SHA；
- CodeQL、Dependency Review、TruffleHog 和 E2E 工作流是仓库质量保障体系的一部分。

完整的信任边界，请参阅 SECURITY.md。

你实际会用到的几个命令

get-fable init
get-fable route "your task"
get-fable spark
get-fable arch-eval "your specification"
get-fable doctor
get-fable install-no-mistakes
get-fable worker-serve
get-fable feed list
get-fable graph
get-fable recipes
get-fable packs
get-fable behavior-eval status

旧版 --json 输出仍然可用，而受支持的命令可以使用增量式版本化 --json-v1 信封。

阅读使用指南 →

分发

- npm — get-fable
- GitHub Releases — 发布历史
- Homebrew formula — Formula/get-fable.rb
- Agent 打包 — Claude、Codex、Gemini、Cursor、OpenCode、Kimi、DeepSeek、Kiro 和 Pi 清单随项目/包一起发布

文档

README 讲述产品故事。实现细节在这里：

- 快速开始和 CLI 用法
- 规范 Skills
- 宿主兼容性
- 行为证据
- 架构
- 插件分发
- 发布流程
- 安全
- 支持
- 贡献

更好的模型有帮助。

更好的 harness 也有帮助。

bun add -g get-fable
get-fable init
开始使用 · 探索技能 · 查看发布版本 · 报告问题

MIT 许可

get-fable 是一个独立的开源项目，与 Anthropic 无关联。