用途:为特性开发创建隔离的 Git worktree,无需切换当前分支,适合并行处理多个任务。
主要能力:校验分支名(无前缀时自动加 feat/,接受 feat/、fix/、refactor/、chore/、docs/、test/、perf/,拒绝非法字符并检查分支是否已存在);选择目录(优先 .worktrees/,其次 worktrees/,再看 CLAUDE.md,最后询问用户);校验并补充 .gitignore;执行 git worktree add 创建带新分支的工作树。
依赖处理:默认从主 worktree 符号链接 node_modules 以省去重复安装;--isolated 时全新安装。支持 Node.js(按 lockfile 选择 pnpm/npm/yarn)、Rust(cargo build)、Python(requirements.txt 用 pip,pyproject.toml 用 poetry)、Go(go mod download)。
后台校验:在 .worktree-logs 目录后台运行 npx tsc --noEmit 和 npx vitest run,可用 /git-worktree-status 查看状态。
标志:--fast 跳过依赖安装与基线测试;--isolated 全新安装 node_modules 不符号链接;--skip-install 跳过依赖安装但保留基线测试。
用法:/git-worktree auth、/git-worktree fix/session-bug、/git-worktree feature/new-api --fast、/git-worktree refactor/db-layer --isolated。配套命令:/git-worktree-status、/git-worktree-remove、/git-worktree-clean。
数据库建议:创建后可检测 Neon(neonctl branches create)、PlanetScale(pscale branch create)、本地 Postgres(CREATE SCHEMA),模式迁移或数据模型重构建议建分支,普通 bug 修复可不建。
限制与注意:需要 Git 2.5.0+;若目录未加入 .gitignore 会被提交;未配置 .worktreeinclude 时 .env 不会复制到工作树,可能导致 DATABASE_URL not found。官方未提供其他收费、平台或效果信息。