用途:为 Git 项目提供隔离的并行开发环境,通过统一的 worktree-manager.sh 脚本管理 Git worktree,避免直接使用原生命令造成配置缺失。
主要能力:create <branch> [from] 创建 worktree 与分支(默认从 main);list/ls 列出所有 worktree 及状态;switch <name> 切换;copy-env <name> 向已有 worktree 复制 .env 文件;cleanup/clean 交互式清理未使用的 worktree。脚本会复制 .env、.env.local、.env.test,确保 .worktrees 在 .gitignore 中,并建立一致的目录结构。创建后按项目类型安装依赖:package.json→npm install、composer.json→composer install、pyproject.toml→pip install -e .、go.mod→go mod download。
使用方式:所有命令以 bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh <command> 执行,禁止直接调用 git worktree add。创建前用 git check-ignore .worktrees 验证忽略状态。创建后应运行测试套件建立基线。工作完成时提供四个选项:本地合并、推送并创建 PR(gh pr create)、保持原样、丢弃(需输入 discard 确认)。清理后运行 git worktree prune。
适用场景:代码隔离评审、并行开发、需要干净分支环境时;支持与 /workflows:review 和 /workflows:work 集成。
限制:需检测执行环境,若已在 worktree 中或处于 Codex/sandbox($CODEX_SANDBOX 设置)或非标准路径时可能不支持,应回退到常规分支切换;裸仓库需调整路径。具体脚本内容与详细故障排查见随附的 worktree-manager.sh 与 troubleshooting.md。