MoAI 开发编排器
为 Claude Code 增加可验证的 SPEC 工作流、质量门禁与成本控制。
- Star 数
- ★ 1.3k
- 最近更新
- 4 天前
- License
- Apache-2.0
- 主语言
- Go
- FA 评分
- 66/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Claude Code 的后端团队希望把新增鉴权等需求固定为可审计的 plan → run → sync 流程时。
- 不适合
- 未使用 Claude Code 的团队——核心工作流依赖它
- 需要原生 Windows cmd.exe 的用户——官方明确不支持
- 不愿配置 tmux 或 z.ai API 密钥的用户——CG 模式与 GLM 需要
- 源码审查
- 66/100 · 存在缺口
这个 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？
前提是已安装 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 有哪些优点和局限？
- 将 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 与同类方案有什么区别？
MoAI-ADK 的三种执行方式是 moai cc（Claude）、moai glm（GLM）和 moai cg（Claude 领导者加 GLM 工作者）。前者面向复杂工作和最高质量；GLM-only 面向成本优化；CG 将策略、规划与审计留给 Claude，并把批量实现交给 GLM。README 声明 GLM 可作为 Claude Code 的替代后端，工作流和质量门禁保持一致。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| MoAI 开发编排器 当前 | 66 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.3k | 4 天前 | Go | Claude Code |
| Loki Mode | 57 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.1k | 今天 | Shell | Claude Code · Claude API |
| Context Engineering Kit（上下文工程工具包） | 47 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.8k | 2 个月前 | TypeScript | Claude Code |
| Aegis 方法包 | 44 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.4k | 2 天前 | Python | Codex |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：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 合并策略。
- 性能数据（如成本节省）缺乏独立验证，建议谨慎对待。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
v3.1.2 is a statusline release, plus the documentation sweep it forced. Highlights The slash pair now answers the question you were asking it The pair after the repository name used to be git ahead/behind. It now carries open issues over open change requests, and ahead/behind no longer renders at all. …在 GitHub 查看 ↗ -
发布说明摘录
v3.1.1 is a maintenance release on top of v3.1.0, gathered from two integration batches. Four themes dominate it. Highlights ~/.moai gets one home, an override, and a way to clean it Home-scope path construction used to be three incompatible styles scattered across seven packages, with no way to relocate the state root. It now collapses into a single stdlib-only internal/paths package that honors a new MOAI_HOME environment override, and all 17 home-scope join sites route through it. …在 GitHub 查看 ↗ -
发布说明摘录
English v3.1.0 promotes the v3.1.0-rc.0 → -rc.1 → -rc.2 candidate line to a production release. Three themes dominate it. Kanban Mode is the headline addition: a six-column board (backlog → plan → run → review → sync → done) driven by a lead session that dispatches cards to operator-launched companion sessions. The mode arrives with a single-origin board state store that never writes into SPEC frontmatter, a moai todo CLI for the backlog queue, a lead session name that survives /clear, and an operator-language bootstrap notice. The former manager-lead agent is renamed ` …在 GitHub 查看 ↗