SuperAPI AI 工具集

moai-workflow-worktree

办公与效率

查看项目

更新于 10-16 06:48

技能介绍

用途:MoAI Worktree Management 是 Git worktree 管理系统,为每个 SPEC 建立隔离的开发环境,实现并行 SPEC 开发,避免上下文切换开销。其理念是每个 SPEC 都应有独立工作区。

主要能力:为每个 SPEC 创建独立 Git 状态的隔离工作区;通过 worktree 注册表自动登记所有活动工作区;支持多个 SPEC 同时开发;与 /moai:1-plan、/moai:2-run、/moai:3-sync 流程无缝集成;按需与基础分支自动同步;自动清理已合并的 worktree。

使用方式:提供 CLI 接口,核心命令包括 new(按 SPEC ID 和描述创建工作区)、list(列出)、switch(切换)、go(输出 cd 命令供 shell eval 集成)、sync(与基础分支同步)、remove(移除)、clean(清理已合并项)、status(查看状态)、config(get/set 管理配置)。注册表以 JSON 格式存储标识符、路径、分支名、创建与同步时间、状态和基础分支;工作区位于 {repo}/.moai/worktrees/{ProjectName}/ 下。工作流示例:创建 SPEC-001 工作区并切换后运行 /moai:2-run SPEC-001,再回主仓库创建 SPEC-002 工作区并行开发,最后同步集成。

适用场景:多 SPEC 并行开发、隔离测试环境、特性分支隔离、代码评审流程、实验性功能开发;也支持团队共享注册表与开发者前缀、选择性同步、模板预设等高级用法。

限制:资料未提供安装命令、价格和平台支持信息;部分命令的具体语法和模板细节依赖配套模块文档(如 worktree-commands.md、troubleshooting.md),本次未完整给出。