用途:在开始新功能分支、同时处理多个任务、为测试或代码审查创建干净环境,或在持续开发时运行长时间测试与构建时,使用 git worktree 创建隔离的工作目录,避免 stash 或频繁切换分支。
主要能力:该技能强制一套确定性的多阶段流程。阶段1选择工作树目录,按优先级检查是否已有匹配工作树(git worktree list)、CLAUDE.md 中的 worktree-directory 配置,否则询问用户并建议 ../worktrees/<project-name>/<branch-name>。阶段2安全检查,确认目录是否在仓库内且未被 .gitignore 覆盖(git check-ignore)、工作区是否干净(git status --porcelain)、分支是否已在其他工作树检出。阶段3创建:新分支用 git worktree add <path> -b <branch-name> <base-branch>,已有分支用 git worktree add <path> <existing-branch>。阶段4自动检测项目生态并运行安装命令,如 pnpm install、yarn install、npm install、poetry install、pip install -e .、go mod download、cargo build、bundle install、composer install,并复制 .env.example 为 .env。阶段5运行基线测试,确认工作树设置正确。阶段6报告路径、分支、基线和测试结果。
使用方式:按阶段顺序执行,不得跳过安全检查与基线测试验证。清理时用 git worktree remove <path>,必要时加 --force,并用 git worktree prune 清理失效引用;锁定工作树先 git worktree unlock <path>。
适用场景:并行开发、隔离测试、代码审查、长时间构建。限制:分支不能同时在两个工作树检出;工作树内 .env 不共享;仓库内工作树必须加入 .gitignore;强制删除未提交工作会丢失数据。该技能为 RIGID 类型,需严格按流程执行。