用途:为同一 Git 仓库创建隔离工作区,使多个分支可并行开发而无需切换分支。核心原则是系统化目录选择加安全校验,从而获得可靠的隔离环境。
主要能力:按优先级选择 worktree 目录;对项目内目录强制校验 .gitignore;自动探测并运行项目初始化;运行基线测试确认干净起点;最后报告路径与测试结果。
使用方式:开始时声明正在使用该技能。目录选择顺序为:先检查 .worktrees(优先,隐藏)或 worktrees,存在则使用,两者都有时 .worktrees 优先;再检查 CLAUDE.md 中的 worktree 目录偏好;都没有则询问用户,可选 .worktrees/ 或 ~/.config/superpowers/worktrees/<项目名>/。项目内目录必须先确认 .gitignore 含对应条目,否则立即添加并提交。创建时先取项目名,再执行 git worktree add "$path" -b "$BRANCH_NAME" 并进入目录;随后按 package.json、Cargo.toml、requirements.txt、pyproject.toml、go.mod 自动运行对应安装或构建;再运行项目测试确认基线干净,失败则报告并询问是否继续;通过后报告路径、测试数量与就绪状态。
适用场景:需要隔离工作区并行开发、由 brainstorming 等技能调用,或与 finishing-a-development-branch、executing-plans 配合时。
限制与注意:项目内 worktree 未校验 .gitignore 会导致内容被跟踪;不得假设目录位置;不得在测试失败时未经询问继续;不得硬编码初始化命令;全局目录无需 .gitignore 校验。该技能不依赖 MCP,可跨 GitHub Copilot、Claude Code、Codex 使用,Codex 可同步到 $CODEX_HOME/skills/using-git-worktrees 并重启。