name: 使用Git工作树 description: 当开始需要与当前工作空间隔离的特性工作或在执行实施计划之前使用 - 创建具有智能目录选择和安全验证的隔离Git工作树

使用Git工作树

概览

Git工作树创建共享同一仓库的隔离工作空间，允许同时在多个分支上工作而无需切换。

核心原则： 系统目录选择 + 安全验证 = 可靠的隔离。

开始时宣布： “我正在使用使用Git工作树技能来设置一个隔离的工作空间。”

目录选择过程

按照这个优先级顺序：

1. 检查现有目录

# 按优先级顺序检查
ls -d .worktrees 2>/dev/null     # 首选（隐藏的）
ls -d worktrees 2>/dev/null      # 替代方案

如果找到： 使用该目录。如果两个都存在，.worktrees 胜出。

2. 检查superpowers-rule.md

grep -i "worktree.*director" superpowers-rule.md 2>/dev/null

如果指定了偏好： 不询问直接使用。

3. 询问用户

如果没有目录存在且没有superpowers-rule.md偏好：

没有找到工作树目录。我应该在哪里创建工作树？

1. .worktrees/（项目本地，隐藏）
2. ~/.config/superpowers/worktrees/<项目名称>/（全局位置）

你更喜欢哪一个？

安全验证

对于项目本地目录（.worktrees或worktrees）

必须验证目录是否被忽略，然后再创建工作树：

# 检查目录是否被忽略（尊重本地、全局和系统gitignore）
git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null

如果没有被忽略：

根据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/` 存在	使用它（验证忽略）
`worktrees/` 存在	使用它（验证忽略）
两者都存在	使用 `.worktrees/`
两者都不存在	检查superpowers-rule.md → 询问用户
目录未被忽略	添加到.gitignore + 提交
基线测试期间测试失败	报告失败 + 询问
没有package.json/Cargo.toml	跳过依赖安装

常见错误

跳过忽略验证

问题： 工作树内容被跟踪，污染git状态
修复： 创建项目本地工作树前始终使用git check-ignore

假设目录位置

问题： 创建不一致性，违反项目约定
修复： 遵循优先级：现有 > superpowers-rule.md > 询问

测试失败时继续进行

问题： 无法区分新错误和现有问题
修复： 报告失败，获得明确的继续权限

硬编码设置命令

问题： 在使用不同工具的项目上中断
修复： 从项目文件（package.json等）自动检测

示例工作流

你：我正在使用使用Git工作树技能来设置一个隔离的工作空间。

[检查.worktrees/ - 存在]
[验证忽略 - git check-ignore确认.worktrees/被忽略]
[创建工作树：git worktree add .worktrees/auth -b feature/auth]
[运行npm install]
[运行npm test - 47通过]

工作树准备就绪于 /Users/jesse/myproject/.worktrees/auth
测试通过（47测试，0失败）
准备实现auth特性

红旗

永不：

创建工作树而不验证它是否被忽略（项目本地）
跳过基线测试验证
在测试失败时继续而不询问
在模糊不清时假设目录位置
跳过superpowers-rule.md检查

始终：

遵循目录优先级：现有 > superpowers-rule.md > 询问
验证目录是否被忽略对于项目本地
自动检测并运行项目设置
验证清洁测试基线

集成

由以下调用：

头脑风暴（第4阶段） - 当设计获批且随后实施时必需
任何需要隔离工作空间的技能

与以下配对：

完成开发分支 - 工作完成后必需清理
执行计划或子代理驱动开发 - 工作在此工作树中进行