用途:在开始需要与当前工作区隔离的功能开发,或执行实现计划之前,创建隔离的 Git worktree 工作区。Git worktree 共享同一仓库,可同时处理多个分支而无需切换。
主要能力:按优先级选择 worktree 目录(已存在的 .worktrees 优先,其次 worktrees,再查 CLAUDE.md 偏好,最后询问用户);对项目内目录强制校验是否被 gitignore 忽略,未忽略则加入 .gitignore 并提交;自动检测项目类型并运行安装(如 package.json 用 npm install、Cargo.toml 用 cargo build、requirements.txt 用 pip install -r、pyproject.toml 用 poetry install、go.mod 用 go mod download);创建后运行测试验证干净基线,并报告路径与测试结果。
使用方式:开始时声明使用该技能;用 ls -d .worktrees 与 ls -d worktrees 检查目录;用 grep -i "worktree.*director" CLAUDE.md 查偏好;用 git check-ignore -q .worktrees 校验忽略;用 git worktree add "$path" -b "$BRANCH_NAME" 创建并 cd 进入;随后运行项目对应测试命令。
适用场景:需要隔离工作区的功能开发、执行实现计划、子代理驱动开发等。
限制:项目内目录必须先确认被忽略,否则可能误提交 worktree 内容;基线测试失败时应报告并询问是否继续;无 package.json 等文件时跳过依赖安装;目录位置不明确时不得擅自假设。