Forge 是一个面向 Claude Code 的结构化交付循环工具，旨在将原本容易在复杂任务中失控的单一代理工作流，转变为可计划、可并行、可验证、可重试并具备记忆能力的工程化流程。
用途
Forge 针对的是普通提示词已经不够用的场景。当任务涉及多个文件、需要模块间协调，或者需要证明其确实能正常工作时，Forge 为 Claude Code 提供了一套工作流，而不仅仅是另一个提示词。它把工作拆分为模块，并行运行可并行的部分，对每个模块进行严格验证，在失败时结合调试上下文重试，并记住对下一个任务有用的内容。
主要能力
- 结构化计划：将功能拆分为带有依赖关系和验证命令的模块。
- 并行执行：在隔离的 worktree 中同时运行相互独立的模块。
- 深度验证：检查文件、命令、语法以及跨模块的 API 契约。
- 智能重试：跟踪尝试次数，检测停滞，并升级到调试代理。
- 会话可恢复：接续未完成的工作，而不是从头开始。
- 跨会话记忆：记住约定、失败模式和测试命令。
- 状态可见性：在 Claude 输出和终端状态行中展示进度。
Forge 采用 DAG 计划而非线性链，工作代理在依赖允许时并行运行。它通过 worktree 隔离和层级间的自动 WIP 提交，确保每一层在下一层分支之前都已写入磁盘。每个模块的验证命令和验收标准在计划阶段定义，防止工作代理悄悄降低标准。多视角审查由一个独立的审查代理加上 3 倍自一致性检查组成，用于捕捉单模块审查者容易遗漏的跨模块缺陷。结构化失败账本以 JSONL 格式记录失败模式，并在下一次计划中通过模式 ID 召回。
使用方式
安装后，重启 Claude Code（如果它已经打开），打开任意想要工作的仓库，运行 /forge <objective>。首次启动可能需要几秒钟，因为 Forge 会自动引导其 MCP 服务器依赖。
用户可用的命令包括：
/forge：完整的编排器工作流。/forge-status：当前计划、模块进度和已学习的模式。/forge-validate：重新运行某个模块的验证。
Forge 附带四个专注的代理：
- planner：探索代码库并提出模块计划。
- worker：在隔离的 worktree 中实现一个模块。
- reviewer：检查正确性、安全性和契约不匹配。
- debugger：调查失败的模块并推动重试。
捆绑的 MCP 服务器提供共享运行时能力，包括 iteration_state 等工具，让多个代理无需依赖松散的对话记忆即可协调。
适用场景
Forge 适用于任务涉及多个文件、需要模块间协调，或者需要证明其确实能正常工作的场景。它不试图替代 Claude Code 的常规使用；对于许多任务，直接使用 Claude Code 即可。Forge 面向的是编排至关重要的任务。
限制与注意事项
- 首次启动可能因自动安装 MCP 服务器依赖而需要几秒钟。
- 如果 Claude Code 已经打开，需要重启。
- 在用户明确批准计划之前，不会执行任何操作。
- Forge 会在工作项目中创建本地
.forge/目录，用于存储计划、日志、记忆、重试历史和可恢复状态。 - 手动安装时，需要使用
.claude/settings.json中的参考配置来连接 MCP 服务器。 - 项目采用 MIT 许可证。
Forge 的架构包括编排器、代理、MCP 服务器和状态流。文档还提供了 MCP 工具参考（包含全部 7 个工具的输入/输出模式和示例）、变更日志、贡献指南和安全政策。
