SuperAPI AI 工具集

solopowers-using-git-worktrees

编程与开发

查看项目

更新于 10-16 08:45

技能介绍

用途:在需要与当前工作区隔离的功能开发或实现计划执行前,建立独立工作区,避免影响当前分支。核心原则是先检测已有隔离,再优先使用平台原生 worktree 工具,最后才回退到手动 git worktree。

主要能力与用法:开始时应声明正在使用该技能。第一步检测是否已在链接 worktree 中,通过比较 git rev-parse --git-dir 与 --git-common-dir,并用 git rev-parse --show-superproject-working-tree 排除子模块;若已在隔离工作区则跳过创建。若为普通仓库,需先询问用户是否同意创建 worktree(已有声明偏好则遵循)。第二步创建隔离工作区:优先使用原生工具(如 EnterWorktree、WorktreeCreate、/worktree 命令或 --worktree 标志);无原生工具时才回退到 git worktree add。目录选择优先级为:用户显式指定、项目内 .worktrees/(优先)或 worktrees/、全局 ~/.config/solopowers/worktrees/、最后默认项目根 .worktrees/。项目内目录必须先用 git check-ignore 验证已被忽略,否则加入 .gitignore 并提交。创建后进入目录。第三步自动检测并运行项目安装(package.json、Cargo.toml、requirements.txt、pyproject.toml、go.mod)。第四步运行测试验证干净基线,失败则报告并询问是否继续。

适用场景:功能开发需隔离、执行实现计划前、多任务并行且需保护当前分支。限制与注意:切勿在已检测到隔离时再创建 worktree,切勿在拥有原生工具时用 git worktree add,切勿跳过忽略验证或基线测试,测试失败未经许可不得继续;若创建因权限被沙箱阻止,则说明后在当前目录就地工作。平台、收费与价格信息暂未提供。