Using git worktrees

Skill 1to9dota/superpowers-zh/skills/using-git-worktrees

在开始需要与当前工作区隔离的功能开发时，或执行实施计划之前使用——创建带有智能目录选择和安全验证的隔离 git worktreeFrom its SKILL.md

Install

npx -y skills add 1to9dota/superpowers-zh --skill using-git-worktrees

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

5.3 KB, as published. Nobody here has run it

使用 Git Worktrees

概述

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

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

开始时宣布： "我正在使用 using-git-worktrees 技能来设置隔离的工作空间。"

目录选择流程

按此优先顺序：

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 中没有偏好：

没有找到 worktree 目录。我应该在哪里创建 worktrees？

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

你想用哪个？

安全验证

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

创建 worktree 之前必须验证目录被忽略：

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

如果没有被忽略：

按照 Jesse 的规则"立即修复损坏的东西"：

在 .gitignore 中添加适当的行
提交更改
继续创建 worktree

为什么关键： 防止意外将 worktree 内容提交到仓库。

对于全局目录（~/.config/superpowers/worktrees）

不需要 .gitignore 验证——完全在项目之外。

创建步骤

1. 检测项目名

project=$(basename "$(git rev-parse --show-toplevel)")

2. 创建 Worktree

# 确定完整路径
case $LOCATION in
  .worktrees|worktrees)
    path="$LOCATION/$BRANCH_NAME"
    ;;
  ~/.config/superpowers/worktrees/*)
    path="~/.config/superpowers/worktrees/$project/$BRANCH_NAME"
    ;;
esac

# 用新分支创建 worktree
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. 验证干净基线

运行测试确保 worktree 从干净状态开始：

# 示例——使用项目适当的命令
npm test
cargo test
pytest
go test ./...

如果测试失败： 报告失败，询问是继续还是调查。

如果测试通过： 报告就绪。

5. 报告位置

Worktree 就绪于 <完整路径>
测试通过（<N> 个测试，0 失败）
准备实施 <功能名>

快速参考

情况	操作
`.worktrees/` 存在	使用它（验证已忽略）
`worktrees/` 存在	使用它（验证已忽略）
两个都存在	使用 `.worktrees/`
都不存在	检查 CLAUDE.md → 询问用户
目录未被忽略	添加到 .gitignore + 提交
基线测试失败	报告失败 + 询问
没有 package.json/Cargo.toml	跳过依赖安装

常见错误

跳过忽略验证

问题： Worktree 内容被跟踪，污染 git status
修复： 创建项目本地 worktree 之前总是使用 git check-ignore

假设目录位置

问题： 造成不一致，违反项目约定
修复： 遵循优先级：现有 > CLAUDE.md > 询问

测试失败时继续

问题： 无法区分新 bug 和预先存在的问题
修复： 报告失败，获得明确许可再继续

硬编码设置命令

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

示例工作流

你：我正在使用 using-git-worktrees 技能来设置隔离的工作空间。

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

Worktree 就绪于 /Users/jesse/myproject/.worktrees/auth
测试通过（47 个测试，0 失败）
准备实施 auth 功能

红旗

永远不要：

不验证忽略就创建 worktree（项目本地）
跳过基线测试验证
测试失败时不问就继续
模糊时假设目录位置
跳过 CLAUDE.md 检查

总是：

遵循目录优先级：现有 > CLAUDE.md > 询问
为项目本地验证目录被忽略
自动检测并运行项目设置
验证干净的测试基线

集成

被调用：

brainstorming（第 4 阶段）- 设计批准且继续实施时必需
任何需要隔离工作空间的技能

配合使用：

finishing-a-development-branch - 工作完成后清理时必需
executing-plans 或 subagent-driven-development - 工作在这个 worktree 中进行