使用 Git Worktree

Worktree 在 同一仓库 下提供 多个工作目录，可 并行 在不同分支上工作而无需来回 checkout。

核心： 按优先级选目录 + 项目内目录必须确认已被 ignore = 可靠隔离。

开场宣告：「我正使用 using-git-worktrees 技能来创建隔离工作区。」

目录选择顺序

1. 看是否已有： .worktrees（优先）或 worktrees；两者都有用 .worktrees。
2. 读 CLAUDE.md 是否指定 worktree 目录。
3. 都没有： 问用户选「项目内 .worktrees/」还是「全局 ~/.config/superpowers/worktrees/<项目名>/」。

安全校验（项目内目录）

创建前必须 git check-ignore 确认 .worktrees 或 worktrees 已被忽略。

若未忽略：按「见坏就修」原则，写入 .gitignore 并提交，再创建 worktree。否则可能把 worktree 内容 误提交进库。

全局路径 ~/.config/... 不在仓库内，不必 做此项检查。

创建步骤

1. project=$(basename "$(git rev-parse --show-toplevel)")
2. git worktree add <路径> -b <分支名>，cd 进去。
3. 安装依赖：有 package.json → npm install；Cargo.toml → cargo build；Python/Go 同理自动判断。
4. 基线测试：跑项目测试；失败则汇报并询问 是否仍继续。
5. 汇报： Worktree 路径、测试结果、准备实现的功能名。

常见错误

• 未校验 ignore
• 自作主张选目录
• 基线测试失败仍静默继续
• 写死某种包管理器不自动检测

禁止 / 必须

禁止： 项目内 worktree 不验 ignore；不测基线；失败不问就继续；有约定不先查 CLAUDE.md。
必须： 目录优先级；项目内 git check-ignore；自动安装依赖；基线测试与汇报。

衔接

调用方： brainstorming（实现前）、subagent-driven-development、executing-plans 等。
收尾： finishing-a-development-branch。