用途:在开始需要与当前工作区隔离的功能开发,或执行实现计划之前,创建隔离的 Git worktree。Git worktree 共享同一仓库、可在多个分支上并行工作而无需切换分支。核心原则是系统化目录选择加安全校验。
目录选择优先级:先检查已存在目录,ls -d .worktrees 优先于 ls -d worktrees,两者都存在时用 .worktrees;其次检查 CLAUDE.md,用 grep -i "worktree.*director" CLAUDE.md 读取偏好;都没有则询问用户,可选择项目内隐藏目录 .worktrees/ 或全局位置 ~/.config/superpowers/worktrees/<project-name>/。
安全校验:对项目内目录必须在创建前用 git check-ignore -q .worktrees 或 git check-ignore -q worktrees 验证已被忽略,未忽略则加入 .gitignore 并提交,以防 worktree 内容被误提交;全局目录在项目外,无需校验。
创建步骤:先用 git rev-parse --show-toplevel 取项目名为 basename,再执行 git worktree add "$path" -b "$BRANCH_NAME" 并 cd 进入;随后自动检测并运行项目初始化,如 package.json 跑 npm install、Cargo.toml 跑 cargo build、requirements.txt 跑 pip install -r、pyproject.toml 跑 poetry install、go.mod 跑 go mod download;接着运行测试验证干净基线,如 npm test、cargo test、pytest、go test ./...,失败则报告并询问是否继续;最后报告路径与测试结果。
适用场景:需要隔离工作区、经 brainstorming 批准设计后进入实现,或配合 executing-plans、subagent-driven-development 等技能;工作完成后需与 finishing-a-development-branch 配合清理。
限制与注意:不得跳过忽略校验和基线测试验证,不得在目录不确定时臆测位置,不得跳过 CLAUDE.md 检查,不得硬编码初始化命令,测试失败须获得明确许可再继续。以上为资料所述内容,未提供的收费、平台等信息暂未提供。