用途:创建新的 worktrunk worktree,并把当前会话的工作目录切换进去;可在指定仓库中创建,也可在创建后执行给定任务。
参数语法:[<branch>] [<repo>] [-- <task>]。branch 为可选分支名,省略时由技能自行选取;repo 为可选路径或名称,用于在指定仓库而非当前仓库创建;task 为可选任务,省略时进入 worktree 后等待。-- 之前的 token 视为 branch 和/或 repo:路径形状(以 /、~、./、../ 开头)的 token 是 repo;裸名称需根据当前仓库是否已有同名分支、以及用户存放仓库的位置是否存在同名 git 仓库来判断。
主要能力与用法:无 repo 参数时,通过 EnterWorktree({name: "<branch>"}) 一次完成创建与进入,worktrunk 的 WorktreeCreate 钩子会执行 wt switch --create。会话中途需携带未提交改动时,先 git stash push -u,再调用 EnterWorktree,之后 git stash pop。有 repo 参数或上一步失败时,用 Bash 执行 wt -C <repo> switch --create <branch> --no-cd --format=json,从返回 JSON 的 path 字段取得绝对路径,再 EnterWorktree({path: "<path>"});有 repo 参数时先 cd <repo>。若分支已存在,用户指定则去掉 --create 重跑,否则另选名称。进入新仓库后,任务前读取其根目录的 CLAUDE.md 和 AGENTS.md。
限制:若 EnterWorktree 报错,可尝试 cd 到该路径;若出现 Shell cwd was reset 则不可达,需请用户把包含仓库与 worktree 的父目录加入 permissions.additionalDirectories 或运行 /add-dir。若调用被拒绝,worktree 仍存在,需报告路径并询问后续。该 worktree 是普通 worktrunk worktree,可用 wt list 查看、wt merge / wt remove <branch> 合并或删除,不应擅自删除。提交、推送、合并均需用户明确许可。