moai-adk

用 SPEC 驱动 Claude Code，多模型协作省成本

moai-adk 是一个面向 Claude Code 的智能体开发工具链，采用 SPEC 驱动的工作流，将开发过程分为计划、执行和同步三个阶段，并通过 TRUST 5 质量门禁确保代码质量。它支持模型和算力路由，可灵活切换 Claude 与 GLM 等不同大模型，实现成本优化。项目以单个 Go 二进制文件分发，无外部依赖，支持 16 种语言，为开发者提供轻量、跨平台的智能体编码体验。核心解决多模型协作、流程规范化和成本控制问题，适合需要高效、可控 AI 辅助编码的团队。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1220

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队modu-ai

所属国家

官网地址https://adk.mo.ai.kr

GitHubhttps://github.com/modu-ai/moai-adk

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型agentic-ai,agentic-coding,agentic-workflow,ai-agent,ai-coding,anthropic,claude,claude-code,cli-tool,code-generation,code-quality,ddd,developer-tools,go,golang,llm,multi-agent,spec-driven-development,tdd,vibe-coding

GitHub 星标★ 1220

30天Star增速

HF 下载量

上线时间2025-09-16 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 15 分钟部署方式：命令行工具 7 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Go 1.26+（README 徽章标注的版本要求）
已按官方文档完成 moai-adk 安装（README 的 Install 章节为空，需参考官网）
按需准备多个终端窗口，用于手动启动伴随会话
Claude Code 或 GLM 等后端模型账号（用于模型路由）

安装与启动步骤

1确认 Go 环境

README 徽章标注需要 Go 1.26+，先确认本机 Go 版本。若版本过低请先升级。
```
go version
```
2查阅官方安装说明

README 的 Install 章节未给出安装命令，请到官网 https://adk.mo.ai.kr 查看正式安装方式，不要凭猜测执行。
3启动主导会话

用 moai cc -k 启动 lead 会话，它会公布 run-id 并作为整条链路的起点。
```
moai cc -k
```
4手动启动伴随会话

伴随会话不会被自动创建，需自行开新终端逐个启动。名字只写角色，run-id 保留在 lead 会话。
```
moai cc -k --name plan
moai cc -k --name run
moai cc -k --name sync
```
5规划一个 SPEC

在会话中用 /moai 斜杠命令提交自然语言任务，进入 SPEC 驱动的计划阶段。
```
/moai plan "Refactor the payment module"
```
6执行长任务

用 /moai goal 声明完成条件，会话会自主运行直到条件成立；轮数默认上限 30，并带停滞保护。
```
/moai goal "go test ./... exits 0 && lint clean, or stop after 20 turns"
```
7用 worktree 并行

开启独立工作树并行开发，--spawn 可在新窗口打开并保留当前会话。
```
moai cc -w feature-auth
moai cc -w feature-billing --spawn
```

关键配置

配置项	必填	说明	示例
`-k`	是	启动会话并生成/携带 run-id，是组成链路的基础参数	`moai cc -k`
`--name`	否	为伴随会话命名角色，名称只写裸角色，不带 run-id	`moai cc -k --name plan`
`-w`	否	指定工作树名称，用于并行开发不同功能	`moai cc -w feature-auth`
`--spawn`	否	在新窗口中打开该工作树，同时保留当前会话	`moai cc -w feature-billing --spawn`

如何确认成功

lead 会话会打印出 run-id，随后在各自终端里看到 plan / run / sync 伴随会话正常挂载，即表示链路可用。

常见问题

Q：怎么把某个会话切到 GLM 后端省钱？

A：把该会话的 moai cc 替换为 moai glm 即可，只影响该列，其它列仍走 Claude 后端，实现按列的成本路由。

Q：伴随会话会自动创建吗？

A：不会。伴随会话必须由人工在每个终端单独启动，一个会话永远不会派生同类会话。

Q：长任务跑太久怎么办？

A：/moai goal 的轮数上限默认 30 轮，并带停滞保护；达到上限或停滞会自动停止，避免无限消耗。

Q：上下文快满了怎么办？

A：当上下文达到阈值（1M 的 50% 或 200K 的 90%）时，会提示执行 /clear，并把进度写入 progress.md。

Q：同一个角色名被重复占用怎么办？

A：第二个在线会话声明同一角色时会自动取下一个可用编号，不会与已有会话冲突。

注意事项

README 中 Install 章节为空，安装命令请以官网 https://adk.mo.ai.kr 为准，本教程未包含任何自行推测的安装命令。
项目以单个 Go 二进制分发、无外部依赖，但仍需满足 Go 1.26+ 的版本要求。
伴随会话必须手动逐个终端启动，且不要在其名字里附带 run-id。
切换模型后端只需替换命令（moai cc ↔ moai glm），无需改动工作流。

核心亮点

SPEC 驱动三阶段工作流，计划-执行-同步清晰可控
TRUST 5 质量门禁，自动拦截低质量代码
单二进制零依赖，支持 16 种语言，部署极简

不足之处

文档/社区待观察

适用场景

团队统一 AI 编码流程，提升代码一致性
多模型切换场景，平衡质量与 API 成本
跨语言项目开发，需要轻量 CLI 工具

替代项目

Claude Code、Aider、OpenHands

项目介绍

moai-adk 是智能体领域的开源项目，由 modu-ai 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,220）位列前 30%，在智能体分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,162 增加到 1,220，净增 58。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，访问稳定性一般，建议自备网络条件。

它主要面向的使用场景是：团队统一AI编码流程，提升代码一致性。同类可对比的替代方案包括 Claude Code、Aider、OpenHands。

上一篇：intelligent-audit-system

下一篇：vm0