using-git-worktrees

npx skills add jnMetaCode/superpowers-zh --skill using-git-worktrees --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# 使用 Git 工作树 ## 概述 确保工作发生在隔离的工作区中。优先使用你的平台的原生 worktree 工具。仅在没有原生工具可用时，再回退到手动 git worktree。 **核心原则：** 先检测现有隔离。然后用原生工具。再回退到 git。绝不与 harness 对抗。 **开始时宣布：** "我正在使用 using-git-worktrees 技能来建立一个隔离的工作区。" ## 步骤 0：检测现有隔离 **创建任何东西之前，先检查你是否已经在一个隔离的工作区里。** ```bash GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P) GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P) BRANCH=$(git branch --show-current) ``` **Submodule 守卫：** 在 git submodule 内 `GIT_DIR != GIT_COMMON` 也为真。在判定"已经在 worktree 内"之前，先确认你不在 submodule 里： ```bash # 如果这条命令返回路径，说明你在 submodule 里，不是 worktree —— 按普通仓库处理 git rev-parse --show-superproject-working-tree 2>/dev/null ``` **如果 `GIT_DIR != GIT_COMMON`（且不是 submodule）：** 你已经在一个 linked worktree 内。跳到步骤 2（项目设置）。**不要**再创建一个 worktree。 按分支状态报告： - 在某个分支上："已经在隔离工作区 `<path>`，分支 `<name>`。" - 分离 HEAD："已经在隔离工作区 `<path>`（分离 HEAD，由外部管理）。完成时需要创建分支。" **如果 `GIT_DIR == GIT_COMMON`（或在 submodule 内）：** 你在一个普通的仓库检出里。 用户是否已经在你的 instructions 里表明过 worktree 偏好？如果没有，创建 worktree 之前先征求同意： > "你希望我搭一个隔离的 worktree 吗？它能保护你当前分支不被改动。" 如果用户已声明过偏好，直接遵循，不再询问。如果用户拒绝同意，原地工作并跳到步骤 2。 ## 步骤 1：创建隔离工作区 **你有两种机制。按这个顺序尝试。** ### 1a. 原生 Worktree 工具（首选） 用户已经请求隔离工作区（步骤 0 已获同意）。你是否已经有创建 worktree 的方法？可能是名

git rev-parse --show-superproject-working-tree 2>/dev/null
ls -d .worktrees 2>/dev/null     # 首选（隐藏目录）
ls -d worktrees 2>/dev/null      # 备选
git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null
git worktree add "$path" -b "$BRANCH_NAME"
cd "$path"
Node.js
if [ -f package.json ]; then npm install; fi
Rust
if [ -f Cargo.toml ]; then cargo build; fi