内容
<div align="center">
<h1>/build-it</h1>
<h3>
<strong>plan-it 计划它，build-it 构建它。</strong>
</h3>
<p>
给 Claude 一个目标和一个编号的完成定义。<br>
<strong>去睡觉。醒来时获得一份诚实的报告。</strong>
</p>
<p>
<em>以前称为 <code>fable-it</code>。行为转移。这就是为什么夜间工作可以生存。</em>
</p>
<a href="#how-it-works">
<img src="assets/build-it-header.gif" alt="build-it 流程图 — 目标，完成定义，自动运行，诚实报告" width="100%">
</a>
<p>
<a href="#installation"><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/为Sonnet%205调优-blueviolet?style=for-the-badge" alt="为Sonnet 5调优"></a>
<a href="https://claude.ai/code"><img src="https://img.shields.io/badge/为Opus%204.8调优-blueviolet?style=for-the-badge" alt="为Opus 4.8调优"></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="#installation">安装</a>
·
<a href="#the-honest-claim">诚实的声明</a>
·
<a href="#how-it-works">工作原理</a>
·
<a href="#whats-bundled">捆绑内容</a>
·
<a href="#platform-compatibility">平台兼容性</a>
·
<a href="#sources">来源</a>
·
<a href="CHANGELOG.md">更新日志</a>
</p>
> [!IMPORTANT]
> **📛 v3.1.0（2026-07-24）— fable-it 现已更名为 build-it.** 相同的插件，新的名称：最初的模型特定品牌（“让你的模型表现得像 Fable 一样”）发展成为了 *-it 生命周期中的构建阶段 — plan-it 计划它，build-it 构建它，review-it 审查它。GitHub 重定向从 `DevOtts/fable-it` 保持不变，旧的 `/fable-it` 触发器仍然路由到此处，新的运行写入 `.build-it-reports/`（遗留的 `.fable-it-reports/lessons.md` 仍然被读取）。
> [!IMPORTANT]
> **🔒 v3.0.1（2026-07-08）— 安全的并行执行，现已在竞争条件下得到验证。** build-it 运行的并行 *变异* 代理 — 或与另一个会话共享存储库 — 现已 **在构造上安全**：原子运行锁（[G-INTERLOCK](plugins/build-it/skills/references/parallel-safety.md)），每个变异通道一个 `git worktree`（G-WORKTREE），以及合并树集成门（G-INTEGRATE），在 v3.0.1 中通过无 TOCTOU 锁获取、定时心跳、仅限所有者回收和崩溃后剩余通道清理进行强化。通过针对 v2.1.0 的两轮 A/B 测试验证：单通道交付质量相同，竞争并行运行的 60/46 规则获胜 — v2 的失败模式（自信的错误完成和剩余工作树）已在结构上消除。详细信息请参阅 [CHANGELOG](CHANGELOG.md)。
> [!NOTE]
> **针对长时间任务优化** — 研究、浏览器任务以及主要是 **vibe 编码**。
> [!NOTE]
> **生命周期家族** — [`plan-it`](https://github.com/DevOtts/plan-it) 计划 → **build-it** 构建 → [`review-it`](https://github.com/DevOtts/review-it) 验证。review-it 是 QA 前门：它运行计划阶段的测试契约对抗 build-it 构建的内容（独立审查阶段），强制执行 11 条规则目录对抗虚假 VERIFIED 声明，并共享 build-it 的证据账本报告格式。
<br>
</div>
当你观看 Fable 运行一个长时间的多步骤任务时，令人惊讶的不是原始的聪明才智。而是它 **保持线程**：它不会与一小时前做出的决定相矛盾，它会在声称完成之前测试自己的工作，它会在无法验证某些内容时诚实地报告，并且它不会漫无目的地构建你从未要求的东西。
那是 **行为**，而不是智商 — 而且行为会转移。build-it v2 编码了这种行为契约 — 首先从一个实时 Fable 5 会话中捕获，并与 Anthropic 的“提示 Claude Fable 5”指南进行交叉验证 — 作为 **可检查的门控与磁盘支持状态**，适用于 **Sonnet 5 和 Opus 4.8**，因此你的模型可以运行长时间的无人值守作业，就像 Fable 一样。
**v2 新增功能：** 5 个门控目录取代姿态散文（turn-end、claim、state-change、phase-boundary、delegation）· 证据账本使 `VERIFIED` 成为一个查找，而不是一种感觉 · 全新上下文验证器在发送每份报告之前审计 · 在步骤 0 应用的模型自适应姿态 · 成本感知委托路由 · 可选的 [强化模式钩子](plugins/build-it/hooks/README.md)（选择加入，失败打开），机械地阻止承诺结束和无证据的 VERIFIED 行在 Claude 代码上。
**v3 新增功能：** 三个门控使并行和多会话运行 **在构造上安全** — 原子 `.taskstate/RUNLOCK` 互锁（两个运行永远不会共同变异一个树），每个通道的 `git worktree` 隔离每个变异子代理，以及合并树集成门控，以便在隔离时绿色但破坏构建的切片被重新打开，而不是被接受。完整的协议位于 [`parallel-safety.md`](plugins/build-it/skills/references/parallel-safety.md)。
## 诚实的声明
它 **不** 将 Sonnet 或 Opus 变成 Fable，任何告诉你技能可以做到这一点的人都在出售东西。它使你的模型 **表现得像 Fable 一样**，适用于长时间的工作 — 这正是你在实际使用 Fable 时感受到的大部分内容。精确地说：基于证据的状态报告和参考验证在可衡量的情况下抑制了夜间运行的失败模式（Anthropic 报告了声明接地气片段“几乎消除了伪造的状态报告”）。它 **不** 使模型在一般情况下“更诚实”。
| 移植到你的模型 ✓ | 停留在 Fable ✕ |
|---|---|
| 长期运行的一致性，保持早期的约束 | 原始推理能力在真正困难的问题上 |
| 自我验证，然后再声明一个步骤完成 | 从一个薄提示中一口气完成一个复杂的系统 |
| 诚实、基于证据的进度报告 — **Fable 上也提示诱导**（声明接地气规则是发布的提示文本，对移植它的技能来说是最好的消息） | 最深的长期上下文保留质量 |
| 自主转折纪律，无需不必要的暂停 | 来自权重的东西，而不是提示 |
| 克制 — 做工作，而不是发明范围 | |
这条线是真实的（证据见下文 [来源](#sources)）。但移植的部分是使夜间工作可生存的部分：你的模型运行它们比昨天更像 Fable。
## 安装
build-it 作为 **Claude 代码插件** 和标准存储库根目录的 **`SKILL.md`** 交付，因此它安装在整个代理生态系统中。根据您的工具选择下面的工具。
> [!TIP]
> **两个通用安装程序** 了解 `SKILL.md` 标准，并将 build-it 放入 70 多种工具的正确目录中 — 如果您的代理未列出，请使用这些：
> ```sh
> npx skills add DevOtts/build-it -a <agent> # 例如 -a codex, -a cursor, -a github-copilot ; 添加 -g 以全局安装
> gh skill install DevOtts/build-it # GitHub CLI（项目或用户范围）
> ```
> 使用 `npx skills add DevOtts/build-it --list` 先查看。
### Claude 代码 · *原生，全功能体验*
```sh
# 1. 注册市场
/plugin marketplace add DevOtts/build-it
# 2. 安装插件（plugin-name@marketplace-name)
/plugin install build-it@devotts
```
市场名称 `devotts` 来自 [marketplace.json](.claude-plugin/marketplace.json) 中的 `name` 字段。这是 **唯一** 获取完整包的目标 — 导体 *加* `launch`、`iterate`、`full-qa` 和 `chrome-cdp-control`，带有斜杠命令调用和自动激活。（Skills-CLI 替代方案：`npx skills add DevOtts/build-it -a claude-code`。）
### Codex · *OpenAI Codex CLI*
```sh
npx skills add DevOtts/build-it -a codex
# 或：gh skill install DevOtts/build-it
```
安装到 Codex 读取的共享 `.agents/skills/build-it/`。Codex 不携带捆绑的 sibling 技能，因此 build-it 运行启动/迭代/质量保证阶段 **内联**（优雅降级）— 您仍然获得自主姿态、预接地门、一致性护栏和诚实的每个标准报告。
### OpenClaw
```sh
npx skills add DevOtts/build-it -a openclaw
```
位于 `.openclaw/skills/build-it/SKILL.md`。
### Cursor
```sh
npx skills add DevOtts/build-it -a cursor # 添加 -g 以全局安装
```
安装到 Cursor 的 `.agents/skills/` 并自动发现。
### VS Code + GitHub Copilot
```sh
npx skills add DevOtts/build-it -a github-copilot
# 或：gh skill install DevOtts/build-it
```
Copilot 在 `.agents/skills/` 下自动发现技能。
### Copilot CLI
```sh
gh skill install DevOtts/build-it
# 或：npx skills add DevOtts/build-it -a github-copilot
```
### Kiro CLI / IDE
```sh
gh skill install DevOtts/build-it
```
如果您的 Kiro 构建尚不支持读取共享技能路径，请手动将技能放入：
```sh
git clone https://github.com/DevOtts/build-it /tmp/build-it
mkdir -p "<kiro-skills-dir>/build-it" && cp /tmp/build-it/SKILL.md "<kiro-skills-dir>/build-it/"
```
### 其他 · *OpenCode · Cline · Windsurf · Zed · Gemini CLI · Antigravity · Amp · Warp …*
```sh
npx skills add DevOtts/build-it -a <agent>
```
运行 `npx skills add DevOtts/build-it --list`，然后针对您的代理 — CLI 知道每个代理的正确路径。**手动备用**：克隆存储库并将根目录 [`SKILL.md`](SKILL.md) 复制到您的代理的技能/指令目录中。
> [!NOTE]
> 在 **Claude 代码** 以外的所有目标上，build-it 作为单个行为技能（根目录 `SKILL.md`）安装。委托的 `/launch`、`/iterate`、`/full-qa` 和 `/chrome-cdp-control` 是 Claude 代码插件技能；在其他地方，build-it 内联执行这些阶段，并在其报告中记录缺失。
## 工作原理
您向 build-it 提供一个 **目标** 和一个 **编号的完成定义**。它会完成其余的工作 — 无需监督。
```
目标：启动 Shopify → Postgres 同步功能以用于分析仪表盘。
完成定义：
1. Shopify 订单同步到 postgres.orders，具有正确的模式
2. 增量同步有效（仅限上次运行后新增的订单）
3. 仪表盘 /analytics 页面显示真实数据，而非模拟数据
4. 所有三个通过质量保证报告
```
build-it 是一个 **协调器**，而不是替代品。如果您已经使用带有 `/launch`、`/iterate`、`/full-qa` 和 `/chrome-cdp-control` 等技能的 Claude 代码，它会将每个工作部分路由到正确的技能，并在正确的时间使用它们 — 并且永远不会粘贴一个较差的逻辑副本。改进 `/iterate`，build-it 会继承改进。
除了路由之外，它还强制实施原本需要手写的层：
- **自主姿态** — 继续前进而不是停止寻求许可，由两个反向规则限制：不要伪造信心，不要镀金。不可逆操作仍需要事先授权。
- **预接地门** — 读取真实的源（实际模式，实际端点） *在写入一行代码之前*，因此第 3 小时的操作不会偏离第 1 小时的现实。
- **三个一致性护栏**，阻止长时间并行运行默默地不同步：
1. **共享决策契约** — 并行代理读取和写入一个共享文件，用于每个交叉决策，因此不会为模式 A 构建渲染器，而连接器保存模式 B。
2. **跨会话接口文件** — 当此运行假定另一个会话仍在构建时，它会写入双方同意的契约，而不是猜测。
3. **诚实的每个标准状态** — 每个完成定义项都有一个状态和证据：`VERIFIED`、`IMPLEMENTED-NOT-VERIFIED` 或 `BLOCKED`。不会报告没有模拟或假设的绿色结果。
长时间工作的连贯性问题不是原始能力 — 而是小时 1 的决定与小时 3 的工作相矛盾。护栏恰好存在于此。
## 使用
您不需要输入命令 — 技能在您描述目标到完成定义的交付时 **自动激活**：
> *"自主工作直到完成"* · *"我要睡觉了，完成这项工作"* · *"运行到完成定义"* · *"绿灯，采取决策"* · 或目标后跟编号的验收标准。
要显式调用它（插件技能按插件名称命名）：
```
/build-it:build-it 构建 Shopify 多存储连接器。
完成定义：
1. 补丁显示连接器日志中的所有记录
2. UI 中启用连接池，记录出现在日志中
3. 新交互在时间线页面上可见
4. ShopifyRenderer 显示点击项目的详细信息
```
只需要两个条件：**目标** 和 **编号的完成定义**。所有其他条件都有一个合理的默认值 — 凭据、根据完成定义推断的工具、并行性、报告位置。状态报告和任何凭据工件都写入工作空间根目录下的 `.build-it-reports/`（不是存储库根目录），因此运行后留下干净的树 — 如果您不想跟踪它，请忽略该文件夹。
## 捆绑内容
| 技能 | 角色 |
|-------|------|
| `build-it` | 协调器 — 拥有姿态、护栏和最终报告 |
| `launch` | 任务控制：环境库存、方法选择、代理拓扑 |
| `iterate` | 诊断 → 修复 → 测试 → 评估循环 |
| `full-qa` | 自主质量保证套件：读取测试计划、运行 CDP + 迭代、生成通过/失败报告 |
| `chrome-cdp-control` | 通过 Playwright 上的 CDP 对您的真实、已登录的 Chrome 进行逐步控制 |
由于它委托的技能包含在插件中，因此没有缺失的依赖项。而且，如果某些环境中缺少委托的技能，build-it 会 **优雅地降级** — 它内联运行该阶段，并在报告中记录缺失。
## 报告的样子
```
# Build-it 报告 — Shopify → Postgres 分析同步
运行窗口：02:14 → 05:47 | 方法：单会话
## 完成定义状态
| # | 标准 | 状态 | 证据 |
|---|------------------------------------|---------------------------|-----------------------|
| 1 | 订单同步，模式正确 | VERIFIED | 1,847 行，模式 ✓ |
| 2 | 增量同步有效 | VERIFIED | delta 查询确认 |
| 3 | 仪表盘显示真实数据 | IMPLEMENTED-NOT-VERIFIED | 服务不可用 |
| 4 | 三项都通过质量保证报告 | BLOCKED | 取决于 #3 |
## 推荐的下一步操作
- 重启仪表盘服务，并为标准 #3 重新运行 /full-qa
```
`VERIFIED` 代表真实数据、真实端点和真实证据 — 绝非冒牌货。
## 状态
诚实，就像技能本身一样：v2 与 **26 例绑定测试契约**（`delivery/epics-build-it-v2.md`）一起发布 — 由全新的上下文代理根据注册的先前实施的转录本、脚本化的 grep-lints（`tests/lints/`）和可执行钩单元测试（`plugins/build-it/hooks/tests/`）进行评判。实时运行的 `[REAL]` 示例在 Sonnet 5 和 Opus 4.8 会话中进行了练习；每个示例的状态都记录在 `delivery/STATUS.md` 中。
v3 的并行安全协议添加了自己的门控：**6 个黄金案例（T30-T35）**，每个由具有引文检查的全新上下文验证器独立评判，加上两个 **与 v2.1.0 对比的 A/B 验证轮次** — 在单个通道运行中具有相同的交付质量，在对抗性并行运行中具有 60/46 的规则胜利，而 v2 自信地报告了错误的完成。互锁本身在实时运行中得到了锻炼：两个并发的 build-it 会话在这个存储库上，失败者被阻塞并干净地恢复。
## 来源
上述声明经过研究，而不是凭空捏造 — 移植/保留表和每个 v2 设计决策都追溯到存储库中的两个文档：
- [`docs/research/01-fable5-vs-opus.md`](docs/research/01-fable5-vs-opus.md) — 什么使 Fable 5 比 Opus 更好，以及一个技能可以移植哪些部分（优势目录 F1-F17，具有证据类别：第一方文档、基准、Fable 5 会话的实时内省、社区分析）
- [`docs/research/02-gap-analysis.md`](docs/research/02-gap-analysis.md) — build-it v1 针对该目录进行审计（差距、结构缺陷 D1-D9、优先级层，它们成为 v2 的史诗）
## 安全考虑
- **安装或运行该技能不需要任何机密信息。** 您只需为要它执行的特定作业提供凭据。
- 它 **仅在本地** 读取 `.full.credentials` 和 `.env` — 这些文件从未传输或提交。
- 浏览器自动化使用 **您自己的 Chrome**，通过 CDP 在本地端口重用您现有的登录会话。build-it 不存储或泄露您的 cookie 或会话。
- 在运行期间创建的任何凭据（例如，管理员令牌、注册登录）都 **隔离在专用凭据工件** 中，并附带轮换说明 — 绝不会埋在报告的正文中。
- 不可逆操作（删除表、强制推送、共享/生产状态上的破坏性迁移）始终需要明确的事先授权；自主权仅涵盖可逆工作。
## 平台兼容性
build-it 本质上是一个 `SKILL.md` 文件，因此它可以在所有支持 [Agent Skills](https://github.com/vercel-labs/skills) 标准的平台上运行。**Claude Code** 可以获得完整的插件（conductor **+** 四个捆绑技能）；其他工具只能获得可移植的**行为层** —— 姿势、预预置门控、防护栏和诚实报告 —— 委托阶段内联运行。
以下每个 `skills add -a <agent>` 命令都代表 `npx skills add DevOtts/build-it -a <agent>` （全局安装时追加 `-g`）。如果找不到您的工具，请运行 `npx skills add DevOtts/build-it --list` —— CLI 支持 70 多个代理。
| 平台 | 状态 | 安装方法 |
|----------|--------|----------------|
| Claude Code | ✅ 原生支持 | 插件市场 |
| Cursor | ✅ 支持 | 自动发现 |
| 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 Agent | ✅ 支持 | `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/build-it --list` |
**图例** — **✅ 原生支持：** 完整的插件（conductor + 所有四个捆绑技能，斜杠命令 + 自动激活）。**✅ 支持：** 根 `SKILL.md` 行为层安装并运行；Claude 特有的委托技能在内联执行，而不是被路由。
## 许可证
MIT — 参见 [LICENSE](LICENSE) 和 [plugin.json](plugins/build-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) 构建。_
连接信息
猜你喜欢
暂无推荐服务器