用途:在开展需要与当前工作区隔离的功能开发,或执行实现计划之前,创建独立的 Git worktree 工作区。多个分支可基于同一仓库同时工作,无需切换分支。
主要能力:按优先级选择 worktree 目录;对项目内目录强制校验 .gitignore;自动识别项目类型并运行安装命令;运行基线测试确认工作区初始状态干净;最后报告路径与测试结果。
使用方式:先按优先级确定目录:检查现有 .worktrees 或 worktrees 目录,若都存在则 .worktrees 优先;再查看 CLAUDE.md 中的 worktree 目录偏好;都没有则向用户询问选择项目内隐藏目录 .worktrees/ 或全局目录 ~/.config/superpowers/worktrees/<项目名>/。创建时用 git worktree add "$path" -b "$BRANCH_NAME",随后按项目文件自动运行安装,如 package.json 时 pnpm install、Cargo.toml 时 cargo build、requirements.txt 时 pip install -r requirements.txt、pyproject.toml 时 poetry install、go.mod 时 go mod download。之后运行对应测试(如 pnpm test、cargo test、pytest、go test ./...)验证基线,测试失败则报告并询问是否继续,通过则报告就绪位置。
适用场景:设计获批后进入实现、任何需要隔离工作区的技能或流程。
限制:项目内目录必须先在 .gitignore 中加入对应行并提交,否则不得创建;全局目录无需校验;无对应包管理文件则跳过依赖安装;不得在测试失败时未经确认继续;不得假设目录位置或跳过 CLAUDE.md 检查。