安装方式
手动下载安装
下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常，本站会改为提示页 + 原始链接，请按页内说明操作。
下载 ZIP (oss-superpowers-using-git-worktrees-v1.0.0.zip)触发指令
/using-git-worktrees
跨平台安装指引
该技能声明兼容以下 1 个平台，将 ZIP 解压到对应目录即可被识别。
unzip oss-superpowers-using-git-worktrees-v1.0.0.zip -d ~/.claude/skills/
mkdir -p 创建；启用 Skill 后请重启对应 Agent 让配置生效。
使用指南
使用 Git Worktree
Worktree 在 同一仓库 下提供 多个工作目录，可 并行 在不同分支上工作而无需来回 checkout。
核心： 按优先级选目录 + 项目内目录必须确认已被 ignore = 可靠隔离。
开场宣告：「我正使用 using-git-worktrees 技能来创建隔离工作区。」
目录选择顺序
- 看是否已有：
.worktrees（优先）或worktrees；两者都有用.worktrees。 - 读 CLAUDE.md 是否指定 worktree 目录。
- 都没有： 问用户选「项目内
.worktrees/」还是「全局~/.config/superpowers/worktrees/<项目名>/」。
安全校验（项目内目录）
创建前必须 git check-ignore 确认 .worktrees 或 worktrees 已被忽略。
若未忽略：按「见坏就修」原则，写入 .gitignore 并提交，再创建 worktree。否则可能把 worktree 内容 误提交进库。
全局路径 ~/.config/... 不在仓库内，不必 做此项检查。
创建步骤
project=$(basename "$(git rev-parse --show-toplevel)")git worktree add <路径> -b <分支名>，cd进去。- 安装依赖：有
package.json→npm install；Cargo.toml→cargo build；Python/Go 同理自动判断。 - 基线测试：跑项目测试；失败则汇报并询问 是否仍继续。
- 汇报： Worktree 路径、测试结果、准备实现的功能名。
常见错误
- 未校验 ignore
- 自作主张选目录
- 基线测试失败仍静默继续
- 写死某种包管理器不自动检测
禁止 / 必须
禁止： 项目内 worktree 不验 ignore；不测基线；失败不问就继续；有约定不先查 CLAUDE.md。
必须： 目录优先级；项目内 git check-ignore；自动安装依赖；基线测试与汇报。
衔接
调用方： brainstorming（实现前）、subagent-driven-development、executing-plans 等。
收尾： finishing-a-development-branch。
<!-- zh-only -->
# 使用 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。