⚡

Git工作树管理器Skill git-worktree

Git工作树管理器是一个用于管理Git工作树的技能，支持在软件开发中创建、列出、切换和清理隔离的并行开发环境。它提供交互界面，自动处理.env文件复制和.gitignore管理，适用于代码审查、并行特征开发和DevOps工作流程。关键词：Git、工作树、并行开发、代码审查、DevOps、版本控制、软件开发工具。

DevOps 0 次安装 0 次浏览 更新于 3/9/2026

名称: git-worktree 描述: 此技能管理Git工作树以进行隔离的并行开发。它通过简单的交互界面处理创建、列出、切换和清理工作树，遵循KISS原则。

Git 工作树管理器

此技能为您的开发工作流程提供统一的Git工作树管理接口。无论您是隔离审查PR还是并行处理功能，此技能处理所有复杂性。

此技能做什么

  • 创建工作树 从主分支使用清晰的分支名称
  • 列出工作树 显示当前状态
  • 切换工作树 进行并行工作
  • 自动清理完成的工作树
  • 交互式确认 在每个步骤
  • 自动管理 .gitignore 针对工作树目录
  • 自动复制 .env 文件 从主仓库到新工作树

重要：始终使用管理器脚本

切勿直接调用 git worktree add。 始终使用 worktree-manager.sh 脚本。

脚本处理原始git命令不处理的关键设置：

  1. 从主仓库复制 .env、.env.local、.env.test 等文件
  2. 确保 .worktrees 在 .gitignore 中
  3. 创建一致的目录结构
# ✅ 正确 - 始终使用脚本
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh create feature-name

# ❌ 错误 - 切勿直接执行
git worktree add .worktrees/feature-name -b feature-name main

何时使用此技能

在以下场景使用此技能：

  1. 代码审查 (/workflows:review)：如果当前不在目标分支（PR分支或请求分支），提供工作树进行隔离审查
  2. 功能工作 (/workflows:work)：总是询问用户想要并行工作树还是当前分支工作
  3. 并行开发：当同时处理多个功能时
  4. 清理：在工作树中完成工作后

如何使用

在Claude Code工作流程中

技能从 /workflows:review 和 /workflows:work 命令自动调用：

# 审查：如果不在PR分支，提供工作树
# 工作：总是询问 - 新分支或工作树？

手动使用

您也可以从bash直接调用技能：

# 创建新工作树（自动复制.env文件）
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh create feature-login

# 列出所有工作树
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh list

# 切换到工作树
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh switch feature-login

# 复制.env文件到现有工作树（如果未复制）
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh copy-env feature-login

# 清理已完成的工作树
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh cleanup

命令

create <branch-name> [from-branch]

使用给定分支名称创建新工作树。

选项：

  • branch-name（必需）：新分支和工作树的名称
  • from-branch（可选）：创建的基础分支（默认为 main）

示例：

bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh create feature-login

发生什么：

  1. 检查工作树是否已存在
  2. 从远程更新基础分支
  3. 创建新工作树和分支
  4. 从主仓库复制所有.env文件（.env, .env.local, .env.test等）
  5. 显示cd到工作树的路径

list 或 ls

列出所有可用工作树及其分支和当前状态。

示例：

bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh list

输出显示：

  • 工作树名称
  • 分支名称
  • 哪个是当前（标记为✓）
  • 主仓库状态

switch <name> 或 go <name>

切换到现有工作树并cd进入。

示例：

bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh switch feature-login

可选：

  • 如果未提供名称，列出可用工作树并提示选择

cleanup 或 clean

交互式清理非活动工作树，需要确认。

示例：

bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh cleanup

发生什么：

  1. 列出所有非活动工作树
  2. 请求确认
  3. 移除选中的工作树
  4. 清理空目录

工作流程示例

代码审查与工作树

# Claude Code识别您不在PR分支
# 提供：“使用工作树进行隔离审查？（y/n）”

# 您回答：是
# 脚本运行（自动复制.env文件）：
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh create pr-123-feature-name

# 您现在在隔离工作树中审查，拥有所有环境变量
cd .worktrees/pr-123-feature-name

# 审查后，返回主：
cd ../..
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh cleanup

并行功能开发

# 第一个功能（复制.env文件）：
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh create feature-login

# 稍后，开始第二个功能（也复制.env文件）：
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh create feature-notifications

# 列出您拥有的：
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh list

# 根据需要切换：
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh switch feature-login

# 完成后返回主并清理：
cd .
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh cleanup

关键设计原则

KISS（保持简单愚蠢）

  • 一个管理器脚本 处理所有工作树操作
  • 简单命令 有合理默认
  • 交互式提示 防止意外操作
  • 清晰命名 直接使用分支名称

有主见的默认值

  • 工作树总是从 主 创建（除非指定）
  • 工作树存储在 .worktrees/ 目录
  • 分支名称成为工作树名称
  • .gitignore 自动管理

安全第一

  • 创建前确认 工作树
  • 清理前确认 防止意外移除
  • 不移除当前工作树
  • 清晰错误消息 针对问题

与工作流程集成

/workflows:review

不总是创建工作树：

1. 检查当前分支
2. 如果已经在目标分支（PR分支或请求分支）→ 留在那里，不需要工作树
3. 如果不同分支于审查目标→ 提供工作树：
   “使用工作树进行隔离审查？（y/n）”
   - 是 → 调用git-worktree技能
   - 否 → 在当前分支继续PR差异

/workflows:work

总是提供选择：

1. 询问：“您想如何工作？
   1. 当前工作树上的新分支（实时工作）
   2. 工作树（并行工作）”

2. 如果选择1 → 正常创建新分支
3. 如果选择2 → 调用git-worktree技能从主创建

故障排除

“工作树已存在”

如果看到此消息，脚本会询问是否要切换到它。

“无法移除工作树：它是当前工作树”

首先切换到工作树之外（到主仓库），然后清理：

cd $(git rev-parse --show-toplevel)
bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh cleanup

在工作树中迷失？

查看您在哪里：

bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh list

工作树中缺少.env文件？

如果工作树创建时没有.env文件（例如，通过原始 git worktree add），复制它们：

bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh copy-env feature-name

导航回主：

cd $(git rev-parse --show-toplevel)

技术细节

目录结构

.worktrees/
├── feature-login/          # 工作树1
│   ├── .git
│   ├── app/
│   └── ...
├── feature-notifications/  # 工作树2
│   ├── .git
│   ├── app/
│   └── ...
└── ...

.gitignore（更新以包含 .worktrees）

工作原理

  • 使用 git worktree add 进行隔离环境
  • 每个工作树有自己的分支
  • 一个工作树中的更改不影响其他
  • 与主仓库共享git历史
  • 可以从任何工作树推送

性能

  • 工作树轻量级（只是文件系统链接）
  • 无仓库复制
  • 共享git对象以提高效率
  • 比克隆或存储/切换快得多