MoAI 开发编排器
为 Claude Code 增加可验证的 SPEC 工作流、质量门禁与成本控制。
这个 Agent 能做什么，适合哪些场景？
MoAI-ADK 是围绕 Claude Code 构建的开发编排工具，以单个 Go 二进制在 macOS、Linux 和 Windows 上运行。它将一次开发任务组织为 /moai plan、/moai run、/moai sync 三阶段 SPEC 生命周期，并按任务规模调整验证深度。工具提供 TRUST 5 质量门禁、11 个规划、实现、审计和文档角色，以及 Git worktree 隔离。它还提供模型与推理强度路由、Token Circuit Breaker、状态栏和会话交接，以控制长任务的成本与连续性。需要 Claude Code 的团队可将其作为现有开发环境的外层 harness，而不是独立聊天式编码产品。
运行 moai init 后，向导检测项目语言、框架和方法论并生成 Claude Code 集成文件。开发者在项目目录启动 claude，再使用 /moai plan "Add JWT login" 创建 SPEC、/moai run SPEC-AUTH-001 执行 TDD 或 DDD 实现、/moai sync SPEC-AUTH-001 同步文档并创建 PR。/moai goal 和 /moai loop 可持续检查目标或并行扫描 LSP diagnostics、AST-grep 与 linter；/moai gate、/moai review、/moai clean 分别执行门禁、审查和死代码清理。moai cc、moai glm 与 moai cg 可启动 Claude、GLM 或 Claude 领导者加 GLM 工作者的会话，moai worktree 管理并隔离 SPEC 工作树。
- 使用 Claude Code 的后端团队希望把新增鉴权等需求固定为可审计的 plan → run → sync 流程时。
- 维护低测试覆盖率遗留项目的开发者，需要通过 DDD 和 characterization tests 先保持既有行为时。
- 需要并行处理多个 SPEC 的团队，希望每个任务在独立 Git worktree 中实施并减少互相覆盖时。
- 按用量或配额使用模型的工程团队，需要按规划、实现和审计阶段配置模型与推理强度时。
- 实施量较大的任务可由 GLM 工作者完成、但仍希望 Claude 负责策略、规划和审计的团队时。
这个 Agent 有哪些优点和局限？
- 将 SPEC 的计划、实现和同步明确拆分为 /moai plan、/moai run、/moai sync，并提供按规模决定验证深度的流程。
- TRUST 5 将测试、可读性、统一性、安全性和可追踪性作为可执行门禁，README 标明测试门槛为 85%+ 覆盖率。
- 提供 11 个明确角色，且 plan-auditor 和 sync-auditor 独立于编写侧，有助于将规划与审核分离。
- 支持 moai cg 的 Claude 领导者与 GLM 工作者组合，并提供模型/推理强度配置和 Token Circuit Breaker。
- 以无额外依赖的单 Go 二进制交付，并明确支持 macOS、Linux 和 Windows 环境。
- 核心定位是 Claude Code 的 harness，因此采用前必须部署并使用 Claude Code；并非独立 IDE、库或通用聊天代理。
- 需要 Git 和本地 shell、文件系统工作流；Windows 原生 cmd.exe 明确不受支持，推荐 WSL 或 PowerShell 7.x+。
- CG 模式要求 tmux，GLM 模式还需要 z.ai API key 或相应订阅，增加了运行环境和供应商配置。
- 质量门禁依赖项目已有或可用的测试、lint 与语言工具链；README 仅将这些工具链列为推荐项，未证明所有语言的验证能力一致。
- fully-autonomous 模式需要 sandbox proof；没有证明时会降级为 automatic，且仍受 deny/ask 规则约束。
如何安装或部署这个 Agent？
前提是已安装 Git 和 Claude Code。macOS、Linux 或 WSL 可执行：
curl -fsSL https://raw.githubusercontent.com/modu-ai/moai-adk/main/install.sh | bash
Windows 需要 PowerShell 7.x+，可执行：
irm https://raw.githubusercontent.com/modu-ai/moai-adk/main/install.ps1 | iex
从源码构建需要 Go 1.26+：
git clone https://github.com/modu-ai/moai-adk.git
cd moai-adk && make build
然后执行 moai init my-project。PR 自动化推荐安装 gh；CG 模式需要 tmux。
如何使用这个 Agent？
在已初始化的项目中启动 Claude Code：
claude
然后依次执行：
/moai plan "Add JWT login"
/moai run SPEC-AUTH-001
/moai sync SPEC-AUTH-001
如需 GLM 后端，先保存 z.ai API key，再进入混合模式：
moai glm sk-your-glm-api-key
moai cg
仅使用 Claude 时运行 moai cc。
这个 Agent 与同类方案有什么区别？
MoAI-ADK 的三种执行方式是 moai cc（Claude）、moai glm（GLM）和 moai cg（Claude 领导者加 GLM 工作者）。前者面向复杂工作和最高质量；GLM-only 面向成本优化；CG 将策略、规划与审计留给 Claude，并把批量实现交给 GLM。README 声明 GLM 可作为 Claude Code 的替代后端，工作流和质量门禁保持一致。