用途:该技能用于在开始需要与当前工作区隔离的功能开发,或在执行实现计划之前,创建相互隔离的 Git worktree 工作区,使同一仓库可同时检出多个分支而不必切换。核心原则是“系统化目录选择 + 安全校验 = 可靠隔离”,开始时需声明使用该技能设置隔离工作区。
目录选择:按优先级检查现有目录,先看 .worktrees(隐藏,优先),再看 worktrees;两者都存在时选 .worktrees。若不存在目录,则用 grep -i "worktree.*director" CLAUDE.md 检查 CLAUDE.md 偏好,有则直接使用。若都没有,则询问用户选择 .worktrees/(项目本地隐藏)或 ~/.config/superpowers/worktrees/<project-name>/(全局位置)。
安全校验:仅针对项目本地目录,创建前必须确认目录已被忽略,可用 git check-ignore -q .worktrees 或 git check-ignore -q worktrees 检查;若未被忽略,需向 .gitignore 添加对应行、提交改动后再继续,以防 worktree 内容被误提交。全局目录在项目外,无需校验。
创建步骤:先用 project=$(basename "$(git rev-parse --show-toplevel)") 获取项目名;再按位置确定完整路径并用 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。随后运行项目相应测试命令验证干净基线,测试失败需报告并询问是否继续或排查,通过则报告就绪,并给出工作区路径、测试结果与待实现功能名称。
适用场景:设计获批后的头脑风暴阶段、子代理驱动开发、执行计划以及其他需要隔离工作区的技能,常与开发分支收尾技能配合使用。
限制:不校验项目本地目录是否被忽略会污染 git status;不应假设目录位置,应遵循现有目录优先、其次 CLAUDE.md、最后询问用户的顺序;测试失败时不应未经询问继续;不应硬编码初始化命令,应从项目文件自动检测。该技能要求执行基线测试,对无测试或不同工具链项目的行为,资料未提供更多说明。