SuperAPI AI 工具集

git-worktrees

编程与开发

查看项目

更新于 10-16 00:02

技能介绍

用途:为并行开发任务创建与管理隔离的 git worktree,避免多个子任务在同一项目根目录互相干扰,减少合并冲突、误改共享状态以及构建/测试相互影响。

主要能力:在多个任务可并行、使用 delegate 派发可并行任务、需要为子智能体提供隔离环境或用户明确要求时激活。创建前必须做安全检查,确认目录已被 gitignore:git check-ignore -q .worktrees && echo "Safe" || echo "NOT GITIGNORED";若未忽略则加入 .gitignore 的 .worktrees/。目录位置优先 .worktrees/,其次 worktrees/,再查 CLAUDE.md 约定,不清楚时询问用户。创建示例:git branch feature/task-name main;git worktree add .worktrees/task-name feature/task-name;git worktree list。命名约定为 .worktrees/<task-id>-<brief-name>。

使用方式:创建后搭建环境,运行基线验证脚本 exarchos_orchestrate({ action: "verify_worktree_baseline", worktreePath: ".worktrees/task-name" }),自动识别 Node.js、.NET、Rust 项目类型并执行相应测试;passed: true 才可进入实现,false 需先排查。子智能体在任何文件修改前必须验证所在位置:exarchos_orchestrate({ action: "verify_worktree" }),可传 cwd 指定路径;passed: false 时立即停止,不得修改文件。合并后清理:git worktree remove .worktrees/task-name;git branch -d feature/task-name;git worktree prune。合并待处理阶段使用 serialize_merge 串行落分支,不要直接调用 raw merge_orchestrate。

适用场景:并行智能体团队开发、每个任务一个 worktree、独立运行测试、按依赖顺序合并分支。

限制:须始终保证目录被 gitignore、先跑基线测试、合并后清理、每个 worktree 只做一项任务、安装依赖;环境搭建脚本与并行创建示例见 references/commands-reference.md。部分流程细节依赖外部技能文档,资料未完全展开。