用途:用 git worktree 将功能开发与主分支隔离,每个功能拥有独立工作目录、干净依赖和已验证的测试基线,防止功能分支互相污染。适用于启动非平凡功能、并行开发两个以上功能、高风险重构、使用 /minion --isolate 时,或需要干净环境验证测试。不适用于主分支热修复、单文件小改动和一次性原型。
主要能力与流程:先确定 worktree 目录,优先使用项目根已有的 .worktrees/ 或 worktrees/,其次查 CLAUDE.md 偏好,默认创建 .worktrees/ 并加入 .gitignore。创建前必须确认 .gitignore 已忽略该目录,否则执行 echo ".worktrees/" >> .gitignore 并提交。随后用 git worktree add .worktrees/<feature-name> -b feature/<feature-name> 创建,并用 git worktree list 验证。进入目录后按项目类型自动安装依赖:pnpm-lock.yaml 用 pnpm install,package-lock.json 用 npm ci,yarn.lock 用 yarn install,pyproject.toml 用 uv sync,requirements.txt 用 pip install -r requirements.txt。之后必须运行基线测试 pnpm turbo run test,基线为红则停止,先修复主分支测试。
使用方式:在 worktree 内可正常执行 pnpm dev、pnpm test --filter=web、uv run pytest -v、pnpm turbo run type-check 等命令,并正常提交、分支、推送。合并或 PR 通过后,回到根目录执行 git worktree remove .worktrees/<feature-name>,必要时 git branch -d feature/<feature-name>。陈旧 worktree 可用 git worktree list、git worktree prune 或 git worktree remove --force 处理。
限制:Docker 中的 PostgreSQL 和 Redis 为共享服务,并非每个 worktree 独立,所有 worktree 共用同一数据库实例,若需隔离应使用独立数据库或在测试间重置。资料未提供其他平台或收费信息。