用途:为每个 SPEC 创建独立 Git worktree,实现无上下文切换的并行开发,并与 MoAI-ADK 的 Plan-Run-Sync 工作流集成。
主要能力:隔离工作区(每个 SPEC 独立 Git 状态)、自动注册(注册表跟踪所有活动工作区)、并行开发、与 /moai:1-plan、/moai:2-run、/moai:3-sync 集成、按需与基础分支同步、合并后自动清理。注册表以 JSON 存储标识、路径、分支名、创建时间、最后同步时间、状态与基础分支,配置含 worktree 根目录、自动同步与合并清理。
使用方式:CLI 提供 new、list、switch、go、sync、remove、clean、status、config 等命令;go 输出 cd 命令供 shell eval,适合脚本与自动化。典型流程:worktree new SPEC-001 并切换,运行 /moai:2-run SPEC-001 隔离开发;再创建 SPEC-002 并行开发;集成前执行 sync,PR 合并后用 clean --merged-only 清理。
--spawn:在新 tmux 窗口中启动 Claude 或 GLM 会话而不替换当前会话,如 moai cg -w feat-auth --spawn。新窗口以 detached 方式创建,焦点留在原窗格,打印的 pane id 用于切换;窗口从项目根启动,-w 名称解析到 .claude/worktrees/<name>/。--spawn 由 MoAI 消费,不传给 Claude Code,-- 之后的参数原样保留,参数经 shell 引用。缺少 $TMUX、tmux 二进制或 PATH 中的 moai 时会明确报错而非静默回退。
适用场景:多 SPEC 并行开发、隔离测试环境、功能分支隔离、代码审查、实验性功能。
限制与注意:只读代理(mode: plan)无需隔离;代理提示中写目标文件应使用相对路径,绝对路径会绕过隔离;会话结束后应清理 worktree,避免残留分支;团队模式可配置共享注册表与开发者前缀。具体命令细节、模板、性能选项与故障排查见对应模块文档,资料未提供完整命令示例与版本要求。