每个阶段由专门的智能体负责,并且 计划与审计相分离,确保创建者不自行检查自己的产出。plan 阶段的产出由 plan-auditor 独立审计,sync 阶段的成果由 sync-auditor 从 4 个维度(Functionality·Security·Craft·Consistency)进行评估。在进入 run 阶段之前,实现启动批准 (人工门禁)始终交还给用户决定。

flowchart TD
    A["/moai project
生成项目文档"] --> B["/moai plan
生成 SPEC 文档"]
    B --> D["/moai run
DDD/TDD 实现"]
    D --> E["/moai sync
文档同步与 PR"]
    E -.-> B
    D -.-> B
    F["/moai harness
挽具学习系统"] -.-> D

命令摘要

命令	阶段	负责智能体	令牌预算	目的
`/moai project`	Phase 0	manager-docs	-	自动生成项目文档
`/moai plan`	Phase 1	manager-spec	30K	生成 SPEC 文档
`/moai run`	Phase 2	manager-develop	180K	以 DDD/TDD 方式实现
`/moai sync`	Phase 3	manager-docs	40K	文档同步与创建 PR
`/moai harness`	辅助	builder-harness	-	挽具创建与学习生命周期管理

各阶段令牌预算不同,这也是 v3 令牌经济学 (Token Economics) 设计的一部分。计划阶段需要深度推理但产出较小(30K),实现阶段代码量大、需要充足预算(180K),文档同步介于两者之间(40K)。在阶段之间用 /clear 清空上下文的惯例也出于同一原因 — 不把上一阶段的对话带入下一阶段,每个阶段才能完整地使用自己的预算。

信息
如果您是首次使用,请从 /moai project 开始。只有项目文档就绪,AI 才能在后续阶段准确理解并处理项目。
/moai harness 是用于管理挽具学习子系统的辅助命令 — 它监控 CLAUDE.md 的变更,并提出基于层级的自动更新建议。

全部子命令(16 个)

/moai 编排器路由 16 个子命令。本节(工作流)讲解 SPEC 3-Phase 生命周期命令,实用命令一节讲解自动化·修复循环·代码管理·反馈命令。

工作流命令(本节)：

子命令	目的
`/moai plan`	生成 SPEC 文档
`/moai run`	DDD/TDD 实现
`/moai sync`	文档同步与 PR
`/moai project`	生成项目文档
`/moai design`	设计阶段协作(manager-design D1-D5)
`/moai harness`	挽具生成与学习生命周期

实用命令（实用命令一节）：

子命令	目的
`/moai fix`	一次性自动修复
`/moai loop`	反复修复循环
`/moai mx`	@MX 代码注释
`/moai feedback`	GitHub 问题反馈
`/moai review`	多视角代码审查(安全·@MX)
`/moai clean`	死代码移除
`/moai codemaps`	生成架构代码地图
`/moai gate`	提交前质量门禁
`/moai e2e`	多平台 E2E 测试
`/moai goal`	条件声明式自主循环

快速开始

bash

# Phase 0: 生成项目文档(仅首次)
> /moai project

# Phase 1: 生成 SPEC
> /moai plan "实现用户认证功能"
> /clear

# Phase 2: DDD 实现
> /moai run SPEC-AUTH-001
> /clear

# Phase 3: 文档同步与 PR
> /moai sync SPEC-AUTH-001

# 辅助: 挽具学习管理(可选)
> /moai harness status
> /moai harness apply

也可以直接用自然语言发出请求。像 /moai "帮我修复登录 bug" 这样不带子命令输入时,Analyze-First 路由 会分析意图并自动连接到合适的工作流。

工作流命令

智能体挽具的核心 — 3-Phase 生命周期

命令摘要

全部子命令(16 个)

快速开始

相关文档