用途:在隔离工作区中开始实现,同时不接管用户或运行框架已管理的 worktree。
主要能力:检测当前检出是否已是链接 worktree(比较 git rev-parse --git-dir 与 --git-common-dir,并用 --show-superproject-working-tree 排除子模块);在用户明确要求或任务已授权隔离时创建 worktree;支持框架原生创建或 git worktree 创建;运行仓库定义的初始化与最小基线检查;报告路径、分支状态、创建机制与验证证据。
使用方式:先读取仓库说明并检查 Git 状态。若已隔离则复用,不创建嵌套或替代 worktree。无显式机制时用 git worktree,目录置于仓库内 .worktrees/;创建前用 git check-ignore 检查路径,未被忽略则加入本地 Git exclude,不改 .gitignore。创建命令为 git worktree add <path> -b <branch> <start-point>,已有分支则省略 -b。创建前检查 git worktree list --porcelain 与分支引用,复用已有匹配 worktree,不强制、删除或覆盖。
适用场景:需要与当前检出隔离的分支工作区,例如计划要求独立工作区时。
限制:检测与报告为只读;创建分支和 worktree 需明确请求或同意。创建不授权提交、推送、变基、修改受跟踪配置、升级依赖或清理。外部管理的 worktree 不得在本流程中移除。保留无关的脏状态,冲突时报告而非移动或暂存他人改动。沙箱或文件系统策略阻止创建时报告失败机制。基线失败需与后续工作区分。仅当位置与 Git 状态验证后才算就绪,测试成功须单独报告。