用途
Forge 是一个面向 Claude Code 的原生插件，目标是把“一行想法”变成“经过测试、审查并已提交的代码分支”，即从头脑风暴到提交的自动化流水线。它旨在取代开发者充当“粘合剂”的角色——过去需要人工反复编写提示、审查代码、重新提示、重新解释上下文，Forge 通过自主循环承担这些协调工作。使用者在早晨阅读 diff 即可。
主要能力
- 五阶段自主循环：
- brainstorm：想法变成带 R 编号的规格（spec），含可测试的验收标准。
- plan：规格变成按依赖排序的任务 DAG，并附 token 估算。
- execute：每个任务在独立的 git worktree 中按 TDD 运行；通过的任务以原子方式 squash-merge。
- review + verify：审查者检查代码，验证者按四个层级（existence 存在、substantive 非桩、wired 使用处已导入、runtime 运行时）逐项核对每个 R 编号。
- backprop：当运行时失败暴露规格缺口时，缺口变成新的验收标准 + 回归测试，循环继续。
- 状态落盘：状态保存在磁盘
.forge/目录，而非对话窗口，因此崩溃、上下文重置、OOM 均可恢复。 - 隔离与原子合并：每个任务在独立 git worktree 中运行，失败任务不触碰主分支；成功时以结构化提交信息 squash-merge，失败则丢弃 worktree。
- 崩溃恢复：带心跳的锁文件、逐步检查点、从 git log 取证式恢复；中途重启后可用
/forge:resume重建状态继续。 - Token 预算控制：每任务与会话预算为硬上限，达到 100% 时状态机在
.forge/resume.md写入交接并干净停止；/forge:resume从断开处继续。 - Token 节省机制：PostToolUse 过滤器裁剪长 Bash 输出（如
npm install、git diff、tsc、find、curl）为头部 + 警告 + 尾部；120 秒读工具缓存减少重复文件读取；caveman 压缩去除代理间交接文本的填充；按角色 max_tokens 上限（2k–16k）。 - 无头就绪：具备正确的退出码、约 2 ms 的 JSON 状态查询、零交互提示，可将
/forge:status --json接入 Prometheus 或 cron。 - 多人模式（可选）：通过
/forge:collaborate启用，可选用 Ably 实现亚秒级跨机器协调；两人或以上在同一仓库通过分布式认领队列（120 秒租约）并行驱动不同任务。
使用方式
安装需两分钟，要求 Claude Code v1.0.33+，单人路径无需 npm install。基础流程为三个命令、一个自主循环、一次 squash-merge：编写想法后运行对应命令，随后离开，完成后阅读 diff 并合并分支。流水线严格顺序并由程序强制：brainstorm → plan → execute，不能跳过头脑风暴、跳过规划或绕过审批门。
当循环完成但功能仍有问题（<promise>FORGE_COMPLETE</promise> 是结构性门：任务完成、测试通过、审查者满意、验证者满意，但浏览器中仍可能表现异常，例如画布模糊、面板空白、点击后状态错误，因为单元测试不渲染像素）时：
- 手动冒烟测试：打开开发服务器，点击 90 秒，用平实语言记下问题。
- 运行
/forge:backprop "<问题描述>"。Backprop 会追溯到本应捕获该问题的 R 编号验收标准，提出收紧后的标准，并生成一个针对已发布代码会失败的回归测试。 - 若 backprop 无法定位缺口，阅读规格。像“功能存在”或“测试通过”这类标准通常是元凶，改写为可观察行为（例如“点击退出后，URL 变为 /login 且会话 cookie 被清除”），然后重跑
/forge:execute。
对于 0.3+ 的视觉验收标准，验证者可选择感知门：[visual] path=/login occluded_check=true selector="#login-form" 会通过 Playwright 运行，具有确定性就绪（document.fonts.ready + 动画禁用 + 2× rAF）以及基于 elementFromPoint 的遮挡探测，从而让隐藏在模态框后的目标失败而不是静默通过。
权限方面：全模式假设你在运行 /forge:execute --autonomy full 时已授权副作用类别，但它仍拒绝破坏性 git 操作，并在推送前暂停。
适用场景
适合在 Claude Code 中开发功能的个人开发者，用来减少充当项目管理者、状态机和粘合剂的开销；也适合需要多人并行驱动同一仓库不同任务、并希望 AI 决策以可异步审查的标记提交到 git 的团队。同时适合希望将状态查询接入监控或定时任务的无头自动化场景。
限制
- 需要 Claude Code v1.0.33+。
- 流水线严格顺序，不可跳过头脑风暴、规划或审批门。
- 通过全部四层验证的功能仍可能在浏览器中表现异常，因为单元测试不渲染像素，需要手动冒烟测试与 backprop。
- 实际 token 节省高度依赖任务：没有可过滤 Bash、没有重复读取、没有冗长交接的工作负载几乎为 0% 减少。
- 多人模式为可选且需额外配置（例如 Ably）。
其他
仓库地址：https://github.com/LucasDuys/forge 。文档包括 docs/commands.md、docs/budgets.md、docs/configuration.md、docs/comparison.md、docs/architecture.md、docs/agents.md、docs/verification.md、docs/recovery.md、docs/backpropagation.md、docs/collaborate.md、docs/visual-verification.md、docs/worktrees.md、docs/headless.md 。贡献流程：Fork 仓库、创建功能分支、修改、运行测试 node scripts/run-tests.cjs、打开拉取请求，详见 CONTRIBUTING.md。Caveman 技能改编自 JuliusBrussee/caveman（MIT）；Ralph Loop 模式来自 Geoffrey Huntley；规格驱动开发概念来自 TÂCHES 的 GSD v1；Karpathy 护栏来自 andrej-karpathy-skills；Claude Code 插件系统由 Anthropic 提供，Forge 是原生扩展而非包装器。具体价格与收费信息暂未提供。
