AgentSkillsCN

using-git-worktrees

为并行开发创建独立的 Git 工作树。在需要隔离的特性开发，或同时处理多个分支时使用。不适用于简单的分支切换或基础的 Git 操作。

SKILL.md
--- frontmatter
name: using-git-worktrees
description: Creates isolated git worktrees for parallel development. Use when starting feature work needing isolation or working on multiple branches simultaneously. Not for simple branch switching or basic git operations.
allowed-tools:
  - Read
  - Bash
  - Grep
  - Glob

Git Worktrees

Git worktrees create isolated workspaces sharing the same repository, allowing work on multiple branches simultaneously.

Announce at start: "I'm using the using-git-worktrees skill to set up an isolated workspace."

Quick Start

bash
# Create worktree with new branch
git worktree add .worktrees/feature-auth -b feature/auth

# Create worktree from existing branch
git worktree add .worktrees/bugfix bugfix/issue-123

# List worktrees
git worktree list

# Remove worktree
git worktree remove .worktrees/feature-auth

Directory Selection

  1. •Check existing: .worktrees/ or worktrees/
  2. •Check CLAUDE.md for preference
  3. •Ask user if neither exists

Safety Requirements

Before creating project-local worktree:

bash
# Verify directory is in .gitignore
grep -q "^\.worktrees/$" .gitignore || grep -q "^worktrees/$" .gitignore

If NOT in .gitignore: Add it immediately and commit.

References