用途:该技能提供统一的 Git worktree 管理接口,支持在多个独立目录中同时检出不同分支,实现隔离的并行开发。适用于创建功能开发隔离环境、同时处理多个分支、在不暂存当前工作的情况下审查 PR,以及清理已完成的功能分支。
主要能力:自动将主仓库的 .env 文件复制到新工作树;工作树统一存放在仓库根目录的 .worktrees/ 下并自动加入 .gitignore;可识别并清理已合并分支、远程分支已删除以及目录缺失的工作树。
使用方式:所有操作均通过统一脚本执行,官方强调应始终使用该脚本而非原始 git worktree 命令。基本形式为 bash scripts/worktree-manager.sh <command> [options]。创建:worktree-manager.sh create <branch-name> [source-branch],在 .worktrees/<branch-name> 创建,分支存在则检出,否则从源分支(默认 main/master)新建。列出:worktree-manager.sh list,显示分支、提交与状态(clean/dirty/missing)。切换:worktree-manager.sh switch <branch-name|path>,提供切换所需信息。清理:worktree-manager.sh cleanup [--force],--force 跳过确认。复制环境文件:worktree-manager.sh copy-env [worktree-path|branch-name],复制 .env* 文件(排除 .env.example);在工作树内无参数运行则复制到当前位置。
限制与说明:资料未提供该技能的安装方式、依赖要求、平台支持、收费或价格信息,暂未提供。