SuperAPI AI 工具集

using-git-worktrees

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:该技能要求在开始任何开发工作前,先创建或确认一个隔离的 git worktree,防止主分支被污染,并支持并行功能开发与干净回滚。

主要能力:worktree 是同一仓库在独立目录中的第二份检出,拥有自己的工作树和 HEAD,但共享 git 对象库。因此子智能体可在隔离环境中工作,不干扰主会话;切换任务无需 stash;并行功能互不影响;放弃 worktree 即可干净回滚。

使用方式:第一步检测是否已隔离,运行 git worktree list 和 pwd;若已在对应 worktree 中则跳到验证基线,否则创建。创建命令示例:git worktree add ../worktrees/<feature-name> -b feat/<feature-name>;若项目使用 .claude/worktrees/,则改用该路径。随后进入 worktree,用 git status 确认无待提交内容,用 git log --oneline -3 确认分支起点,再运行项目安装、构建与测试命令确认基线通过。基线失败应先修复主分支再重建 worktree。完成后从主检出运行 git worktree remove 和 git branch -d 清理。

适用场景:每个功能或缺陷修复的起点;子智能体驱动开发、执行计划类技能之前;任何涉及多个文件的改动。

限制与常见问题:分支已在其他 worktree 检出会报错,需换分支名;worktree 出现意外改动应先 git status 排查,不可在有未提交工作时强制移除;脚本含绝对路径可能在 worktree 中失败;子模块需运行 git submodule update --init --recursive。相比 git checkout -b,worktree 不打断主会话、可并行、拥有独立 node_modules,更适合子智能体隔离。