moai-workflow-worktree

moai-workflow-worktree 是一套专为高性能 AI 辅助开发设计的健壮 Git 工作树管理系统。通过为每个软件规范 (SPEC) 任务建立完全隔离的工作空间，此工具消除了上下文切换的成本，并防止在多任务并行开发期间发生文件系统冲突。它与 MoAI-ADK 生态系统深度整合，特别是 /moai:1-plan、/moai:2-run 与 /moai:3-sync 生命周期，确保即使同时处理数十个实验性分支或独立开发环境时，Git 状态依然保持一致且易于管理。

• 隔离的工作空间：为每个 SPEC 建立专属目录结构，允许独立的文件状态与分支管理，且不影响主要项目存储库。

• 自动化登录系统：维护中央 JSON 注册表，追踪所有活动的工作树、对应的 SPEC ID 以及上次同步时间与状态等元数据。

• 与 ADK 无缝整合：在规划阶段自动设定工作树，并在同步阶段协助与基准分支进行无冲突的整合。

• 生命周期自动化：支持对已合并或过时分支的智能清理，减少开发者的认知负担并防止代码库熵增。

• CLI 驱动的工作流程：提供包含 new、switch、go (shell 评估)、sync、status 与 config 等指令集，促进在隔离环境间快速切换。

• Shell 整合：提供安全的路径切换指令，适合用于 CI/CD 管线与自动化开发脚本。

• 使用场景包含：同时开发多个 SPEC、在沙盒中测试实验性功能、管理隔离的代码审查，以及维持长期的开发环境而不发生内容漂移。

• 输入要求：需要于 MoAI-ADK 内初始化的有效项目内容。指令依赖于位于 ~/.moai/worktrees/{ProjectName}/ 的全局配置根目录。

• 实务限制：请确保您的项目为 Git 存储库。工作树应完全通过提供的 CLI 管理，以保持中央注册表元数据与实际文件系统状态的一致性。

• 推荐模式：在 shell 脚本中使用 go 指令进行动态工作空间切换。变更合并后请务必执行 clean 指令以保持本机开发环境的性能。