名称: 使用Git工作树 描述: 当开始需要与当前工作空间隔离的功能工作时使用，或在执行实施计划之前使用 - 创建带有智能目录选择和安全性验证的隔离Git工作树
使用Git工作树
概述
Git工作树创建共享同一存储库的隔离工作空间，允许同时处理多个分支而无需切换。
核心原则： 系统化目录选择 + 安全性验证 = 可靠的隔离。
开始时宣布： “我正在使用使用Git工作树技能来设置一个隔离工作空间。”
目录选择过程
遵循此优先级顺序：
1. 检查现有目录
# 按优先级顺序检查
ls -d .worktrees 2>/dev/null # 首选（隐藏）
ls -d worktrees 2>/dev/null # 替代
如果找到： 使用该目录。如果两者都存在，.worktrees 优先。
2. 检查 CLAUDE.md
grep -i "worktree.*director" CLAUDE.md 2>/dev/null
如果指定了偏好： 直接使用，无需询问。
3. 询问用户
如果没有目录存在且没有CLAUDE.md偏好：
没有找到工作树目录。我应该在哪里创建工作树？
1. .worktrees/（项目本地，隐藏）
2. ~/.config/superpowers/worktrees/<项目名称>/（全局位置）
您更喜欢哪一个？
安全性验证
对于项目本地目录（.worktrees 或 worktrees）
必须在创建工作树之前验证 .gitignore：
# 检查 .gitignore 中是否有目录模式
grep -q "^\.worktrees/$" .gitignore || grep -q "^worktrees/$" .gitignore
如果不在 .gitignore 中：
根据Jesse的规则“立即修复损坏的事情”：
- 添加适当的行到 .gitignore
- 提交更改
- 继续创建工作树
为什么关键： 防止意外将工作树内容提交到存储库。
对于全局目录（~/.config/superpowers/worktrees）
无需 .gitignore 验证 - 完全在项目之外。
创建步骤
1. 检测项目名称
project=$(basename "$(git rev-parse --show-toplevel)")
2. 创建工作树
# 确定完整路径
case $LOCATION in
.worktrees|worktrees)
path="$LOCATION/$BRANCH_NAME"
;;
~/.config/superpowers/worktrees/*)
path="~/.config/superpowers/worktrees/$project/$BRANCH_NAME"
;;
esac
# 使用新分支创建工作树
git worktree add "$path" -b "$BRANCH_NAME"
cd "$path"
3. 运行项目设置
自动检测并运行适当的设置：
# Node.js
if [ -f package.json ]; then npm install; fi
# Rust
if [ -f Cargo.toml ]; then cargo build; fi
# Python
if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
if [ -f pyproject.toml ]; then poetry install; fi
# Go
if [ -f go.mod ]; then go mod download; fi
4. 验证清洁基线
运行测试以确保工作树以清洁状态开始：
# 示例 - 使用项目适当的命令
npm test
cargo test
pytest
go test ./...
如果测试失败： 报告失败，询问是否继续或调查。
如果测试通过： 报告准备就绪。
5. 报告位置
工作树准备就绪于 <完整路径>
测试通过（<N> 个测试，0 个失败）
准备实施 <功能名称>
快速参考
| 情况 | 操作 |
|---|---|
.worktrees/ 存在 |
使用它（验证 .gitignore） |
worktrees/ 存在 |
使用它（验证 .gitignore） |
| 两者都存在 | 使用 .worktrees/ |
| 都不存在 | 检查 CLAUDE.md → 询问用户 |
| 目录不在 .gitignore 中 | 立即添加 + 提交 |
| 测试在基线期间失败 | 报告失败 + 询问 |
| 没有 package.json/Cargo.toml | 跳过依赖安装 |
常见错误
跳过 .gitignore 验证
- 问题： 工作树内容被跟踪，污染git状态
- 修复： 总是在创建项目本地工作树之前grep .gitignore
假设目录位置
- 问题： 创建不一致，违反项目约定
- 修复： 遵循优先级：现有 > CLAUDE.md > 询问
继续使用失败测试
- 问题： 无法区分新bug与已存在问题
- 修复： 报告失败，获得明确许可继续
硬编码设置命令
- 问题： 在使用不同工具的项目上中断
- 修复： 从项目文件自动检测（package.json等）
示例工作流程
您：我正在使用使用Git工作树技能来设置一个隔离工作空间。
[检查 .worktrees/ - 存在]
[验证 .gitignore - 包含 .worktrees/]
[创建工作树：git worktree add .worktrees/auth -b feature/auth]
[运行 npm install]
[运行 npm test - 47 通过]
工作树准备就绪于 /Users/jesse/myproject/.worktrees/auth
测试通过（47 个测试，0 个失败）
准备实施 auth 功能
红旗
绝不：
- 在没有 .gitignore 验证的情况下创建工作树（项目本地）
- 跳过基线测试验证
- 在没有询问的情况下继续使用失败测试
- 在模糊时假设目录位置
- 跳过 CLAUDE.md 检查
总是：
- 遵循目录优先级：现有 > CLAUDE.md > 询问
- 为项目本地验证 .gitignore
- 自动检测并运行项目设置
- 验证清洁测试基线
集成
调用者：
- brainstorming（阶段4）- 当设计被批准并实施紧随其后时，必需
- 任何需要隔离工作空间的技能
配对使用：
- finishing-a-development-branch - 工作完成后清理时必需
- executing-plans 或 subagent-driven-development - 工作在这个工作树中进行