AgentSkillsCN

worktree

为并行开发创建 Git 工作树。适用于用户希望在不切换分支的情况下，在独立目录中开发功能分支时使用。

SKILL.md
--- frontmatter
name: worktree
description: Create a git worktree for parallel development. Use when the user wants to work on a feature branch in a separate directory without switching branches.
disable-model-invocation: true
allowed-tools: Bash, Read

Git Worktree

Create a git worktree for working on a separate branch in parallel.

Current State

  • •Repository: !basename $(git rev-parse --show-toplevel)
  • •Current branch: !git branch --show-current
  • •Existing worktrees: !git worktree list

Instructions

Parse $ARGUMENTS to determine:

  1. •Branch name - required (first argument)
  2. •Base branch - optional (second argument, defaults to main)

Workflow

  1. •

    Determine the worktree path: Use ../<repo-name>-<branch-name> as the directory (sibling to the current repo).

  2. •

    Check if the branch already exists:

    bash
    git branch --list <branch-name>
git branch -r --list "origin/<branch-name>"
  3. •

    Create the worktree:

    • •If branch exists locally or remotely: git worktree add <path> <branch-name>
    • •If new branch: git worktree add -b <branch-name> <path> <base-branch>
  4. •

    Report the result with the full path so the user can navigate to it.

Examples

  • •/worktree feature-auth → Creates ../<repo>-feature-auth on new branch feature-auth from main
  • •/worktree fix-bug develop → Creates ../<repo>-fix-bug on new branch fix-bug from develop
  • •/worktree existing-branch → If branch exists, checks it out in a new worktree

Cleanup Reminder

After reporting success, remind the user how to clean up when done:

code
git worktree remove <path>
# or to also delete the branch:
git worktree remove <path> && git branch -d <branch-name>