git-worktree（Git 工作树）

Git Worktree

Overview

This skill allows you to quickly create a new git worktree for the current project. The worktree is created in the same parent directory as the current project's root, following the naming convention PROJECT-NAME-T-BRANCH-NAME.

Workflow

1. Verification:

- Verify the current directory is within a Git repository. - Identify the absolute path of the project's root.

1. User Interaction: Proactively suggest values for the required parameters. Ask the user for: Crucially, if the user does not respond to a question or provides no alternative, proceed immediately using your suggested values instead of repeating the question. The goal is to minimize friction while allowing for customization.

- New branch name: The name of the branch to be created. Suggest a context-aware name (e.g., feat-improvement or fix-issue-123 based on context. - Base branch: The branch to base the new branch on (Default: the current branch).

1. Path Calculation: Calculate the new worktree path at the same directory level as the project root. For example, if the project is in /Users/user/my-project, the worktree will be created at /Users/user/my-project-T-NEW-BRANCH.
2. Creation: Execute scripts/create_worktree.sh to:

- Create the new worktree and branch. - Perform initial project setup (e.g., flutter pub get, npm install).

1. Confirmation: Report the location of the new worktree and any initial setup status.
2. Management: Use scripts/manage_worktrees.sh to:

- List all current project worktrees. - Interactively select and remove a specific worktree.

Usage Example

User: "Create a worktree for this repo." Gemini: "I'll create a new worktree for you. I'll use the branch name feat-wyatt_skills-260221 based on the current branch main. Is that okay, or would you like a different name?" User: "That's fine." Gemini: [Runs the script and confirms the path /Users/huwentao/_proj/wyatt_skills-T-feat-wyatt_skills-260221]

Another Example (Proactive/No Response): User: "Create a worktree for feature-login." Gemini: "I'll create a worktree for feature-login based on main. Starting the setup now..." Gemini: [Runs the script and confirms the path /Users/huwentao/_proj/foo_proj-T-feature-login]

Manage Worktrees: User: "Show my worktrees and help me delete one." Gemini: "Here are your current worktrees. Which one would you like to remove?" Gemini: [Lists worktrees and prompts for selection via scripts/manage_worktrees.sh]

Resources

scripts/

• create_worktree.sh: A bash script that calculates the paths, runs git worktree add, and performs initial project setup.

- Arguments: project_path new_branch base_branch

• manage_worktrees.sh: A script to list and interactively remove worktrees.

- Arguments: project_path