fable-it

<div align="center"> <h1>/fable-it</h1> <h3> <strong>使 Opus 像 Fable 一样运行</strong> </h3> <p> 向 Claude 提供目标和编号的完成定义。<br> <strong>去睡觉。醒来时获得诚实的报告。</strong> </p> <p> <em>行为转移。这就是为什么夜间任务可以生存。</em> </p> <a href="#工作原理"> <img src="assets/fable-it-header.gif" alt="fable-it 流程图 — 目标，完成定义，自动运行，诚实报告" width="100%"> </a> <p> <a href="#安装"><img src="https://img.shields.io/badge/快速开始-安装-blue?style=for-the-badge" alt="快速开始"></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/许可证-MIT-yellow.svg?style=for-the-badge" alt="许可证：MIT"></a> <a href="https://claude.ai/code"><img src="https://img.shields.io/badge/与Claude代码配合使用-orange?style=for-the-badge&logo=anthropic" alt="与Claude代码配合使用"></a> <a href="https://claude.ai/code"><img src="https://img.shields.io/badge/运行在-Opus-blueviolet?style=for-the-badge" alt="运行在Opus上"></a> <a href="https://github.com/DevOtts"><img src="https://img.shields.io/badge/作者-DevOtts-181717?style=for-the-badge&logo=github" alt="作者：DevOtts"></a> </p> <p> <a href="#安装">安装</a> &nbsp;·&nbsp; <a href="#诚实的声明">诚实的声明</a> &nbsp;·&nbsp; <a href="#工作原理">工作原理</a> &nbsp;·&nbsp; <a href="#包含内容">包含内容</a> &nbsp;·&nbsp; <a href="#平台兼容性">平台兼容性</a> </p> > [!NOTE] > **针对长时间任务优化** — 研究，浏览器任务和主要是**氛围编码**。 <br> </div> 当你观看 Fable 运行一个长时间的、多步骤的任务时，令人惊讶的不是原始的聪明才智。而是它 **保持线程**：它不会与一个小时前做出的决定相矛盾，它会在声称完成之前测试自己的工作，当它无法验证某些内容时，它会诚实地报告，并且它不会漫无目的地构建你从未要求的东西。 那是 **行为**，而不是智商 — 而且行为会转移。fable-it 将这些行为打包成一个单一的 Claude 代码技能，以便 Opus 运行长时间的、 unattended 的作业，就像 Fable 一样。 ## 诚实的声明 它 **不** 将 Opus 变成 Fable，任何告诉你技能可以做到这一点的人都在卖东西。它使 Opus 在长时间的工作中 **表现** 像 Fable 一样 — 而这正是你在 Fable 中实际感受到的大部分内容。 | 移植到 Opus ✓ | 留在 Fable ✕ | |---|---| | 长期运行的一致性，坚持早期约束 | 原始推理能力在真正困难的问题上 | | 自我验证后声明一个步骤完成 | 从薄提示中一次性构建复杂系统 | | 诚实、基于证据的进度报告 | 最深的长上下文保留质量 | | 自主转换纪律，无需不必要的暂停 | 任何来自权重的东西，而不是提示 | | 克制 — 做工作，而不是发明范围 | | 这条线是真实的。但移植的部分是使夜间工作可以生存的部分：您的 Opus 运行它们比昨天更像 Fable。 ## 安装 fable-it 作为 **Claude 代码插件** 和标准存储库根目录的 **`SKILL.md`** 交付，因此它可以跨整个代理生态系统安装。请根据以下内容选择您的工具。 > [!TIP] > **两个通用安装程序** 了解 `SKILL.md` 标准，并将 fable-it 放入正确的目录中，适用于 70 多种工具 — 如果您的代理未列出，请使用这些： > ```sh > npx skills add DevOtts/fable-it -a <agent> # 例如 -a codex, -a cursor, -a github-copilot ; 添加 -g 进行全局安装 > gh skill install DevOtts/fable-it # GitHub CLI（项目或用户范围） > ``` > 使用 `npx skills add DevOtts/fable-it --list` 先查看。 ### Claude 代码 · *原生，全功能体验* ```sh # 1. 注册市场 /plugin marketplace add DevOtts/fable-it # 2. 安装插件（插件名称@市场名称) /plugin install fable-it@devotts ``` 市场名称 `devotts` 来自 [marketplace.json](.claude-plugin/marketplace.json) 中的 `name` 字段。这是 **唯一** 获得完整捆绑包的目标 — 导体 *加上* `launch`、`iterate`、`full-qa` 和 `chrome-cdp-control`，带有斜杠命令调用和自动激活。（技能 CLI 替代方案：`npx skills add DevOtts/fable-it -a claude-code`。） ### Codex · *OpenAI Codex CLI* ```sh npx skills add DevOtts/fable-it -a codex # 或：gh skill install DevOtts/fable-it ``` 安装到 Codex 读取的共享 `.agents/skills/fable-it/`。Codex 不携带捆绑的 sibling 技能，因此 fable-it 运行启动/迭代/QA 阶段 **内联** （降级） — 您仍然获得自主姿态、预先接地门、一致性护栏和诚实的每个标准报告。 ### OpenClaw ```sh npx skills add DevOtts/fable-it -a openclaw ``` 位于 `.openclaw/skills/fable-it/SKILL.md`。 ### 光标 ```sh npx skills add DevOtts/fable-it -a cursor # 添加 -g 进行全局安装 ``` 安装到 Cursor 的 `.agents/skills/` 并自动发现。 ### VS Code + GitHub Copilot ```sh npx skills add DevOtts/fable-it -a github-copilot # 或：gh skill install DevOtts/fable-it ``` Copilot 在 `.agents/skills/` 下自动发现技能。 ### Copilot CLI ```sh gh skill install DevOtts/fable-it # 或：npx skills add DevOtts/fable-it -a github-copilot ``` ### Kiro CLI / IDE ```sh gh skill install DevOtts/fable-it ``` 如果您的 Kiro 构建尚不支持读取共享技能路径，请手动将技能放入： ```sh git clone https://github.com/DevOtts/fable-it /tmp/fable-it mkdir -p "<kiro-skills-dir>/fable-it" && cp /tmp/fable-it/SKILL.md "<kiro-skills-dir>/fable-it/" ``` ### 其他 · *OpenCode · Cline · Windsurf · Zed · Gemini CLI · Antigravity · Amp · Warp …* ```sh npx skills add DevOtts/fable-it -a <agent> ``` 运行 `npx skills add DevOtts/fable-it --list`，然后针对您的代理 — CLI 知道每个代理的正确路径。**手动备用适用于任何工具：** 克隆存储库并将根目录 [`SKILL.md`](SKILL.md) 复制到您的代理的技能/指令目录中。 > [!NOTE] > 在 **Claude 代码** 除外的所有目标上，fable-it 作为单个行为技能（根 `SKILL.md`）安装。委托的 `/launch`、`/iterate`、`/full-qa` 和 `/chrome-cdp-control` 是 Claude 代码插件技能；在其他地方，fable-it 执行这些阶段内联，并在其报告中记录缺失。移植的内容是 **行为** — 而这正是重点。 ## 工作原理 您将目标和编号的完成定义交给 fable-it。它会完成其余的工作 — 无人值守。 ``` 目标：启动 Shopify → Postgres 同步用于分析仪表板。 完成定义： 1. Shopify 订单同步到 postgres.orders，具有正确的模式 2. 增量同步有效（自上次运行以来仅新的订单） 3. 仪表板 /analytics 页面显示真实数据，而不是模拟数据 4. 所有三个在 QA 报告中通过 ``` fable-it 是一个 **协调器，而不是替代品**。如果您已经使用诸如 `/launch`、`/iterate`、`/full-qa` 和 `/chrome-cdp-control` 之类的技能运行 Claude 代码，它会将每个工作部分路由到正确的技能在正确的时间 — 并且永远不会粘贴其逻辑的较差副本。改进 `/iterate`，fable-it 会继承改进。  在路由之上，它强制实施原本需要手写的 overnight 提示层： - **自主姿态** — 继续前进而不是停止寻求许可，由两个反向规则限制：不要假装自信，不要镀金。不可逆操作仍需要事先授权。 - **预先接地门** — 在编写一行代码之前读取真实的源（实际模式，实际端点），以便第 3 小时的操作不会偏离第 1 小时的现实。 - **三个一致性护栏** ，阻止长时间的并行运行默默地不同步： 1. **共享决策合同** — 并行代理读取并写入每个跨切割决策的共享文件，以便在构建渲染器时不会为模式 A 构建，而连接器保存模式 B。 2. **跨会话接口文件** — 当此运行假设另一个会话仍在构建时，它会写入双方同意的合同而不是猜测。 3. **诚实的每个标准状态** — 每个完成定义项目都有一个状态和证据：`VERIFIED`、`IMPLEMENTED-NOT-VERIFIED` 或 `BLOCKED`。没有绿色结果是基于模拟或假设报告的。 长作业的一致性问题不是原始能力 — 而是小时 1 的决定与小时 3 的工作相矛盾。护栏正是为此而存在。 ## 使用 您不必输入命令 — 技能在您描述目标到完成定义的交付时 **自动激活**： > *"自主运行直到完成"* · *"我要睡觉了，完成这项"* · *"运行到完成定义"* · *"绿灯，采取决定"* · 或目标后跟编号的验收标准。 要显式调用它（插件技能按插件名称命名）： ``` /fable-it:fable-it 构建 Shopify 多店连接器。 完成定义： 1. 备份日志中显示所有记录 2. UI 中启用连接池，日志中出现记录 3. 时间线页面上可见新交互 4. ShopifyRenderer 显示点击项目的详细信息 ``` 只需要两个条件：**目标** 和编号的 **完成定义**。其他条件都有合理的默认值 — 凭据、根据完成定义推断的工具、并行性、报告位置。它旨在无人值守运行：长时间的沉默意味着它正在工作，而不是卡住。 ## 包含内容 | 技能 | 角色 | |-------|------| | `fable-it` | 协调器 — 拥有姿态、护栏和最终报告 | | `launch` | 任务控制：环境库存、方法选择、代理拓扑 | | `iterate` | 诊断 → 修复 → 测试 → 评估循环 | | `full-qa` | 自动 QA 套件：读取测试计划、运行 CDP + 迭代、生成通过/失败报告 | | `chrome-cdp-control` | 通过 Playwright 上的 CDP 对您的真实、已登录的 Chrome 进行逐步控制 | 由于它委托的技能包含在插件中，因此没有缺失的依赖项。而且，如果在某些环境中缺少委托的技能，fable-it 会 **降级** — 它内联运行该阶段，并在报告中记录缺失，而不是失败。 ## 报告的样子 ``` # Fable-it 报告 — Shopify → Postgres 分析同步 运行窗口：02:14 → 05:47 | 方法：单会话 ## 完成定义状态 | # | 标准 | 状态 | 证据 | |---|------------------------------------|---------------------------|-----------------------| | 1 | 订单同步，模式正确 | VERIFIED | 1,847 行，模式 ✓ | | 2 | 增量同步有效 | VERIFIED | delta 查询确认 | | 3 | 仪表板显示真实数据 | IMPLEMENTED-NOT-VERIFIED | 服务已关闭 | | 4 | 所有三个在 QA 报告中通过 | BLOCKED | 取决于 #3 | ## 推荐的后续操作 - 重启仪表板服务并重新运行 /full-qa 以获得标准 3 ``` `VERIFIED` 表示真实数据、真实端点、真实证据 — 永远不会是模拟数据冒充通过。 ## 状态 诚实，就像技能本身一样：这已经在真实提示下经过桌面测试，但尚未在每个环境中进行端到端测试。在依赖它之前，请在本地验证插件： ```sh claude plugin validate ./plugins/fable-it claude plugin validate . ``` ## 安全考虑 - **安装或运行技能不需要机密信息。** 您仅为要它执行的特定作业提供凭据。 - 它仅 **本地** 读取 `.full.credentials` 和 `.env` — 这些从未传输到任何地方，也未提交。 - 浏览器自动化使用 **您自己的 Chrome** 通过 Chrome DevTools 协议（CDP）在本地端口，重用您现有的已登录会话。fable-it 不存储或泄露您的 cookie 或会话。 - 在运行期间创建的任何凭据（例如，管理员令牌，注册表登录）都 **隔离在专用凭据工件** 中，并附有轮换说明 — 永远不会埋在报告的正文中。 - 不可逆操作（删除表，强制推送，共享/生产状态上的破坏性迁移）始终需要明确的事先授权；自主权仅涵盖可逆工作。 ## 平台兼容性 fable-it 在其核心是一个 `SKILL.md`，因此它在开放的 [Agent Skills](https://github.com/vercel-labs/skills) 标准所支持的任何地方运行。**Claude 代码** 获得完整的插件（协调器 **+** 四个捆绑的技能）；其他工具获得可移植的 **行为层** — 姿态、预先接地门、护栏和诚实的报告 — 委托阶段内联运行。 每行 `skills add -a <agent>` 都是 `npx skills add DevOtts/fable-it -a <agent>` 的简写（附加 `-g` 进行全局安装）。看不到您的工具？运行 `npx skills add DevOtts/fable-it --list` — CLI 支持 70 多种代理。 | 平台 | 状态 | 安装方法 | |----------|--------|----------------| | Claude 代码 | ✅ 原生 | 插件市场 | | 光标 | ✅ 支持 | 自动发现 | | VS Code + GitHub Copilot | ✅ 支持 | 自动发现 | | Copilot CLI | ✅ 支持 | `gh skill install` | | Codex | ✅ 支持 | `skills add -a codex` | | OpenCode | ✅ 支持 | `skills add -a opencode` | | OpenClaw | ✅ 支持 | `skills add -a openclaw` | | Antigravity | ✅ 支持 | `skills add -a antigravity` | | Gemini CLI | ✅ 支持 | `skills add -a gemini-cli` | | Pi 代理 | ✅ 支持 | `skills add -a pi` | | Vibe CLI | ✅ 支持 | `skills add -a mistral-vibe` | | Hermes | ✅ 支持 | `skills add -a hermes-agent` | | Cline | ✅ 支持 | `skills add -a cline` | | KIMI CLI | ✅ 支持 | `skills add -a kimi-code-cli` | | Trae | ✅ 支持 | `skills add -a trae` | | Nanobot | ✅ 支持 | 手动 — 复制 `SKILL.md` | | Kiro CLI / IDE | ✅ 支持 | `skills add -a kiro-cli` | | Windsurf · Zed · Amp · Warp · Roo · Goose · Junie · Qwen · …50+ 更多 | ✅ 支持 | `npx skills add DevOtts/fable-it --list` | **图例** — **✅ 原生：** 完整的插件（协调器 + 所有四个捆绑的技能，斜杠命令 + 自动激活）。**✅ 支持：** 根 `SKILL.md` 行为层安装并运行；Claude 特有的委托技能内联执行，而不是路由。 ## 许可证 MIT — 参见 [LICENSE](LICENSE) 和 [plugin.json](plugins/fable-it/.claude-plugin/plugin.json)。使用它、fork 它、随它一起发货。 --- 感谢贡献： - [andre2654](https://github.com/andre2654) - [mBidarra](https://github.com/mBidarra) - [her0 Studio](https://github.com/her0-studio/) --- _由 [DevOtts](https://github.com/DevOtts) 构建。_