MoAI 开发编排器
为 Claude Code 增加可验证的 SPEC 工作流、质量门禁与成本控制。
按维度查看评分与理由
证据显示：CI工作流明确声明了最小权限（contents: read），并注释说明不需要额外权限；自动合并工作流需要写权限但仅用于合并PR。用户确认机制存在：Token Circuit Breaker 只建议 /clear，不自动执行；学习阶梯的自动更新需要用户批准；Harness v4 Builder 有批准门。数据流透明度：状态行显示上下文使用率、缓存命中率等，验证输出重定向到磁盘文件，证据持久化。敏感数据处理：MCP 模板使用 ${VAR} 环境变量引用，避免字面秘密；安全策略建议使用环境变量。依赖安全：go.mod 列出了大量依赖，但未提供漏洞扫描证据；CI 包含 CodeQL 工作流（未提供文件）。外部影响：自动合并工作流可能自动合并 PR，但仅在 CI 成功后；安装脚本从远程执行，但未审查。回滚：moai update 支持自动回滚，harness rollback 可撤销学习应用。来源归属：README 和 LICENSE 明确版权归属 Modu AI，但发布者未验证。扣分原因：依赖安全缺乏具体漏洞扫描证据；安装脚本未审查；自动合并可能降低人工审查。
证据显示：README 描述的功能与 CLI 命令、代理目录等一致，内部一致性良好。依赖可用性：go.mod 列出了大量依赖，但未提供锁定文件或供应商目录，依赖可用性依赖上游。失败消息：CI 测试脚本有明确的 PASS/FAIL 输出，但产品本身的错误消息未在提供文件中详细说明。扣分原因：依赖可用性未提供锁定文件；失败消息在产品层面证据不足。
证据显示：README 明确目标用户为 Claude Code 用户，提供了多种使用场景（plan/run/sync、goal/loop、CG 模式等）。能力边界：文档说明了支持的平台（macOS/Linux/Windows WSL）和不支持的（原生 cmd.exe），并列出前提条件。触发精度：/moai 命令有明确子命令和自然语言路由，但未提供详细触发条件。环境适配：支持多平台，但 Windows 原生不支持，需要 WSL。扣分原因：触发精度缺乏详细文档；环境适配有平台限制。
证据显示：信息架构清晰，README 有目录、文档站点链接、CLI 参考。安装说明详细，提供多种安装方式。命名稳定性：版本号 v3.0.2，有 CHANGELOG 链接。示例和 FAQ：README 包含快速入门和 FAQ。已知限制：文档提到退役子命令和平台限制。许可证：Apache-2.0 完整文本。版本变更日志：有 CHANGELOG.md 链接。维护责任：有贡献指南和安全政策。扣分原因：未提供 CHANGELOG 内容，版本历史不完整；维护责任未明确具体维护者。
证据显示：输出可用性：状态行提供实时信息，验证输出重定向到文件，证据持久化。边际价值：提供成本控制、质量门、自我改进等独特功能，相比单独使用 Claude Code 有明显增值。成本效益：文档声称 CG 模式可节省 60-70% 成本，但未提供独立验证。扣分原因：成本节省声明缺乏独立验证；输出可用性依赖终端环境。
证据显示：README 中的性能数据（如 DeepSWE 排行榜）未提供来源链接，但文档站点可能提供。跨来源佐证：CI 工作流和测试脚本提供了部分验证，但未提供独立第三方验证。事实与推断分离：README 明确区分了事实（如版本号）和推断（如成本节省），但部分声明（如“16倍成本”）未提供数据来源。扣分原因：性能数据缺乏来源；跨来源佐证不足。
- 发布者身份未验证，安装脚本从远程执行，建议审查安装脚本内容。
- 依赖安全缺乏漏洞扫描证据，建议检查依赖的已知漏洞。
- 自动合并工作流可能降低人工审查，建议关注 PR 合并策略。
- 性能数据（如成本节省）缺乏独立验证，建议谨慎对待。
这个 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 | bashWindows 需要 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 的替代后端，工作流和质量门禁保持一致。