modu-ai/moai-adk

MoAI‑ADK – 一个验证驱动的 AI 代码代理工具

它是什么

• 一个开源命令行工具（使用 Go 编写），用于编排 Claude Code（以及其他 LLM 后端，如 GLM 和 Codex）作为可靠的软件开发代理。
• 它增加了一个严格的验证层：代理所做的每一项声明（例如“测试通过”）都必须有实际运行的命令及其输出作为支撑。未经证实的声明将在系统层面被拒绝。

为什么它很重要

• 大语言模型代理可以生成代码，但如果没有外部检查，你无法信任结果。MoAI‑ADK 强制执行 SPEC 生命周期（计划 → 运行 → 同步）以及一组“TRUST 5”门控，将证据绑定到每个步骤。
• 它允许你并行运行多个代理（“通道”），同时将每个通道隔离在各自的 Git 工作树中，防止意外覆盖。
• 该工具专为长时间运行的会话而构建：进度存储在 progress.md 中，会话可以在 /clear 后恢复，而不会丢失上下文。

核心概念

术语	含义
Leader	一个协调会话，负责监视待办事项队列并将 cards（工作单元）分发给通道。它本身从不编写代码。
Lane	一个工作者会话 + 隔离的工作树，通过完整的 SPEC 流水线处理单个卡片。多个通道并排运行。
Card	一个工作单元（例如，错误修复、功能或设计变更）。通过 moai gtd "…" 添加。
Factory Mode	默认的编排模式，其中领导者和一组通道协同工作。
SPEC	三阶段生命周期：plan（编写规范）、run（使用 TDD/DDD 实现）、sync（创建文档/PR）。

工作原理

1. 添加卡片 – moai gtd "fix stale rename hint" 将任务放入待办队列。
2. 启动工厂 – moai cc -f 启动领导者（“工厂”）。
3. 生成通道 – 在单独的终端中运行 moai cc -l (Claude), moai glm -l (GLM), 或 moai codex -l (Codex)。每个通道接收一张卡片，创建一个隔离的 Git 工作树，并运行 SPEC 阶段。
4. 验证 – 当通道完成一个阶段时，它会将证据（命令输出、测试结果）写入 progress.md。领导者仅在读取此证据后才会推进卡片，绝不会仅凭通道的声明推进。
5. 完成 – 同步阶段后，通道会要求用户运行 /clear；用户输入的命令确认工作确实已完成。

主要功能

• Factory Mode 具有自动通道编号和自动运行记录处理功能。
• 并行安全隔离：每个通道都有自己的工作树和分支 (WT‑<slug>)，且每个存储库一次只能运行一个具有写入能力的代理。
• 跨会话消息控制：通过 crosssession.yaml（批准、拒绝或自动接受来自其他会话的消息）。
• 主目录卫生：moai clean --home 删除 ~/.moai 下的旧状态；位置可以通过 MOAI_HOME 覆盖。
• Web 控制台 (moai web) 可视化通道、SPEC 计数和队列状态。
• 支持 16 种编程语言：通过基于标记的自动检测，为每种语言提供同等的工具支持。
• 自我改进循环：失败模式记录在决策内存中，并在用户批准后可提升为新规则。
• 多后端支持：每个通道可选择 Claude、GLM 或 Codex；领导者可以在廉价后端 (GLM) 上运行，而通道使用更昂贵的模型。

快速入门

# 启动领导者（工厂）
moai cc -f

# 在单独的终端中，启动通道（它们将被自动编号）
moai cc -l      # Claude 通道
moai glm -l    # GLM 通道（可选）
moai codex -l  # Codex 通道（可选）

使用 moai gtd "your task" 添加工作，并观察 Web UI (moai web) 或使用 CLI 命令（如 moai factory status）来监控进度。

适用人群

• 希望尝试 LLM 驱动的代码生成但需要强大安全保证的开发者。
• 大规模运行 Claude Code（或类似代理）并希望获得可重现、可审计工作流的团队。
• 任何有兴趣构建尊重 Token 预算、避免失控会话并保持干净 Git 历史的自主编码循环的人。

了解更多

• 官方文档: https://adk.mo.ai.kr
• 详细的“Factory Mode”指南（在 README 中链接）。
• 社区 Discord: https://discord.gg/Z7E7Mdc5aN

---

以上所有信息均直接取自存储库的 README；未推断出任何额外功能。