用途:在同一个仓库中创建隔离的 worktree 工作区,使多个分支可并行开发,而无需切换分支或暂存改动;适合新功能开发、实验性修改、并行处理多个功能,以及执行较长任务。
主要能力:按优先级选择目录(已存在的 .worktrees/ 或 worktrees/ > CLAUDE.md 中的偏好 > 询问用户);对项目内目录强制校验是否被 Git 忽略(git check-ignore),未忽略则先加入 .gitignore 并提交;自动识别项目类型并执行安装或构建(Node.js/Python/Rust/Go);创建后运行测试确认干净基线;完成后可列出、删除或清理 worktree。
使用方式:
- 检查目录:ls -d .worktrees 2>/dev/null
- 校验忽略:git check-ignore -q .worktrees
- 创建:git worktree add "$path" -b "$BRANCH_NAME"
- 安装依赖:如 npm install、poetry install、cargo build、go mod download
- 基线测试:npm test、pytest、cargo test、go test ./...
- 清理:git worktree list、git worktree remove .worktrees/feature-name、git worktree prune
限制:项目内 worktree 目录必须先确认被忽略,否则可能污染仓库;若基线测试失败,需报告并询问是否继续;不适用于当前分支上的快速修复、文档或配置修改;目录位置模糊时不得擅自假设;命令需按平台(Windows PowerShell/Unix)分别使用。关于收费、价格、平台支持等更多信息,暂未提供。