用途:在需要隔离检出、用户明确要求 worktree,或存在陈旧 worktree 时,一致地创建、复用与清理 git worktree。worktree 是可选的:当隔离有帮助时(并行代理、在已被占用的检出旁工作)使用,否则就地工作。
主要能力与用法:先检测现有隔离——当 git rev-parse --git-dir 与 --git-common-dir 不同,且 git rev-parse --show-superproject-working-tree 无输出时,说明已在 worktree 中,直接使用并跳过创建。优先使用运行环境自带的原生 worktree 工具,它自行管理放置与清理。手动回退:确认 .worktrees/ 已被忽略(git check-ignore -q .worktrees/wt;缺失时加入 .gitignore 并提交),然后对已有分支执行 git worktree add .worktrees/<flattened-branch> <branch>,创建新分支时加 -b <branch>。若工作需要构建或测试,在新 worktree 中运行仓库的依赖安装。分支合并或废弃后清理:git worktree remove <path>,删除分支,并用 git worktree prune 处理损坏的注册;不确定时用 git worktree list 审计。
限制与护栏:绝不在另一个 worktree 内嵌套 worktree;只在 .worktrees/ 或原生运行环境目录下创建,项目文件夹不得出现裸 worktree 同级项;移除需等分支顶端可从远端到达,或用户明确放弃该要求。输出为 worktree 路径与分支,或按 git worktree list 执行的清理结果。放置规则遵循 git-conventions 技能。