git-worktree（Git 工作树）

Git Worktree Skill

Manage parallel development environments without manual path juggling.

When to Use

• Setting up parallel agents
• Multi-agent development
• When "worktree" is mentioned
• Need isolated environments for different features

Status Check

git worktree list
git branch --list

Actions

[NEW] Create Agent Environment

1. Name the Agent: Short identifier (e.g., frontend-refactor, agent-3)
2. Define Paths:

- Branch: [agent-name] - Folder: ../[repo-name]-[agent-name]

1. Execute:

git branch [branch_name]
git worktree add [folder_path] [branch_name]

1. Validate: git worktree list
2. Context Migration (ask user):

cp .env [worktree_path]/.env
# If SQLite:
mkdir -p [worktree_path]/prisma
cp prisma/dev.db [worktree_path]/prisma/dev.db

1. Initialize: pnpm install in new worktree

[SYNC] Synchronize Agents

1. Ask: Sync ALL or SPECIFIC worktree?
2. Execute:

git fetch origin
cd [worktree_path]
git merge origin/main  # or rebase
cd -

[KILL] Teardown Agent

1. Select worktree from list
2. Execute:

git worktree remove [worktree_path]
git branch -d [branch_name]  # Ask before deleting!
git worktree prune

Troubleshooting

• "already checked out": Use a new branch name
• Stale entries: Run git worktree prune
• Files still tracked: Directory was deleted manually—prune first