SuperAPI AI 工具集

Using Git Worktrees

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:为同一 Git 仓库创建隔离工作区,支持同时处理多个分支而无需切换分支。核心原则是系统化目录选择加安全校验,从而获得可靠的隔离环境。

主要能力:按优先级选择 worktree 目录(已存在的 .worktrees 优先,其次 worktrees,再查 CLAUDE.md 偏好,最后询问用户);对项目内目录强制校验 .gitignore,防止 worktree 内容被误提交;自动检测并运行项目初始化(如 package.json 用 npm install、Cargo.toml 用 cargo build、requirements.txt 用 pip install、pyproject.toml 用 poetry install、go.mod 用 go mod download);运行基线测试确认起点干净;最后报告路径与测试结果。

使用方式:开始时声明正在使用该技能。检查目录:ls -d .worktrees 2>/dev/null、ls -d worktrees 2>/dev/null;查偏好:grep -i "worktree.*director" CLAUDE.md 2>/dev/null;校验忽略:grep -q "^.worktrees/$" .gitignore || grep -q "^worktrees/$" .gitignore;创建:git worktree add "$path" -b "$BRANCH_NAME" 后 cd "$path"。全局目录 ~/.config/superpowers/worktrees 无需校验 .gitignore。

适用场景:需要隔离工作区并行开发、由 brainstorming 等技能调用,或与 finishing-a-development-branch、executing-plans 配合使用。

限制与注意:项目内目录未加入 .gitignore 时必须先添加并提交;基线测试失败应报告并询问是否继续;无 package.json 等文件则跳过依赖安装;不得假设目录位置或跳过 CLAUDE.md 检查。