用途:确保当前工作发生在隔离的工作区中,不干扰用户的主检出。多数编码工具在会话开始时会默认创建 worktree,因此常见情况是隔离已存在。完成条件是调用方处于隔离树中(已有或新建),并报告其路径与分支,或报告阻塞原因。
主要能力:两种模式。新工作(默认):未指定 ref 时,从基线(主干)创建新分支,ce-work 与 ce-code-review 在用户选择 worktree 选项时使用。隔离已有 ref:调用方指定 PR head、分支或提交,把 worktree 挂到该 ref 而非新建分支。一个分支同一时间只能在一个 worktree 中检出;若指定 ref 已在别处检出(最常见是主检出的当前分支),不要创建第二个 worktree,应报告已在 <path> 检出,由调用方决定就地工作,或仅在必须独立干净树时于同一提交创建 detached worktree。
使用方式:顺序为检测已有隔离 -> 优先使用原生 worktree 工具 -> 回退到普通 git。步骤 0 用 git rev-parse --absolute-git-dir 与 (cd "$(git rev-parse --git-common-dir)" && pwd -P) 比较,相等为普通检出,不同则为链接 worktree 或子模块,再用 git rev-parse --show-superproject-working-tree 区分。步骤 1 若宿主提供原生 worktree 原语(如 EnterWorktree/WorktreeCreate 工具、/worktree 命令或 --worktree 标志)则使用并停止。步骤 2 仅在无原生工具且无已有隔离时回退 git:从仓库根运行,选择有意义的分支名,确保 .worktrees/ 被 gitignore,刷新基线,按模式执行 git worktree add,然后 cd 进去并报告路径与分支。
限制:不要创建宿主看不见的 worktree;不要从 worktree 再建 worktree;若 git worktree add 因沙箱或权限失败,不要在当前检出继续,应报告失败并询问用户,使用宿主已有的阻塞式提问工具,绝不跳过确认或自动重试其他路径。资料未提供收费、价格、平台与效果信息。