moai-adk

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

环境要求

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

安装与启动步骤

1. 1确认 Go 环境

   README 徽章标注需要 Go 1.26+，先确认本机 Go 版本。若版本过低请先升级。

   go version

   复制

2. 2查阅官方安装说明

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

3. 3启动主导会话

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

   moai cc -k

   复制

4. 4手动启动伴随会话

   伴随会话不会被自动创建，需自行开新终端逐个启动。名字只写角色，run-id 保留在 lead 会话。

   moai cc -k --name plan
   moai cc -k --name run
   moai cc -k --name sync

   复制

5. 5规划一个 SPEC

   在会话中用 /moai 斜杠命令提交自然语言任务，进入 SPEC 驱动的计划阶段。

   /moai plan "Refactor the payment module"

   复制

6. 6执行长任务

   用 /moai goal 声明完成条件，会话会自主运行直到条件成立；轮数默认上限 30，并带停滞保护。

   /moai goal "go test ./... exits 0 && lint clean, or stop after 20 turns"

   复制

7. 7用 worktree 并行

   开启独立工作树并行开发，--spawn 可在新窗口打开并保留当前会话。

   moai cc -w feature-auth
   moai cc -w feature-billing --spawn

   复制

关键配置

如何确认成功

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

常见问题

注意事项

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