用途:在用户要求于 worktree 中工作时,于任务技能运行前建立或复用任务的工作目录,并返回其已验证位置。仅负责目录建立与校验,不实现、不交付任务;仅创建分支的请求不属于本技能范围。零归属:任何输出都不得添加或保留共同作者、AI 或工具署名。
主要能力:解析目标仓库与任务,按 <project-repo>/.worktrees/<task-name> 放置,遵循用户提供的分支与基线版本,否则沿用项目约定并将新任务分支默认指向当前检出的 HEAD 并说明假设。复用已有 worktree 仅当其属于本任务、分支与基线匹配且位于该仓库的 .worktrees/ 下;不嵌套、不动无关 worktree。
使用方式:先声明技能并检查仓库,使用 git rev-parse --show-toplevel、git rev-parse --path-format=absolute --git-dir --git-common-dir、git worktree list --porcelain、git status --short、git branch --show-current、git rev-parse HEAD;随后用 git worktree add -b "$task_branch" "$worktree_path" "$base_commit" 创建新分支,已有分支在确认可用后使用 git worktree add "$worktree_path" "$task_branch"。创建或复用前需将 /.worktrees/ 添加到所属仓库 .gitignore 并确认目标被忽略。任务落笔前记录并核对规范化检出路径、所属仓库与公共 Git 目录、分支或分离状态、起始提交与基线结果;每个命令显式指定工作目录,文件编辑用绝对路径,写入前解析符号链接。
限制:保留现有暂存、未暂存与未跟踪改动,不 stash、reset、覆盖或整体复制;创建失败或被权限拒绝即视为阻塞,需报告并暂停,不得退回源检出写入。建立过程不 stage、不 commit、不 merge、不 push、不删分支、不移除 worktree。首次写入前及交接、重启、检出变更后需重新校验,不匹配则阻塞写入。多项目任务每个受影响仓库各建一个 worktree。文档类仓库无依赖时可跳过依赖安装。基线失败仅在已有用户指令授权时继续,否则报告并询问。输出至多三条要点,含最短决定性验证证据;仅设置请求到此结束,最多推荐一个后续技能。