用途:为功能开发创建隔离的 git worktree,保证工作区隔离和干净基线,避免在主检出目录中直接开发。
主要能力:
- 检查 .worktrees/ 是否被 gitignore,缺失时自动追加并提交。
- 从 .planning/PLAN.md 首行提取功能名,或向用户询问,分支名格式为 feature/${feature_name}。
- 执行 git worktree add .worktrees/${feature_name} -b feature/${feature_name} 创建 worktree 并切换目录。
- 根据项目文件自动检测并安装依赖:package.json 用 npm install;requirements.txt 用 pip install -r;pyproject.toml 用 poetry install 或 pip install -e .;pixi.toml 用 pixi install;Cargo.toml 用 cargo build;go.mod 用 go mod download。
- 自动检测并运行测试套件(npm test、cargo test、pytest、go test ./...),验证干净基线。
- 报告完成状态:worktree 路径、分支、依赖安装、测试结果。
使用方式:当用户要求创建隔离 worktree、为功能设置 worktree 或创建功能分支 worktree 时触发。按步骤执行:先确保 .worktrees/ 被 gitignore,再确定分支名,创建 worktree,运行项目设置,最后强制验证基线并报告。
适用场景:Node.js、Python、Rust、Go 等项目的功能开发隔离;需要独立环境、路径和符号链接的并行开发。
限制与注意:worktree 与主检出环境不同,主分支测试通过不代表 worktree 通过,安装成功不等于测试成功。测试失败时必须报告,不得静默继续。不得跳过 gitignore 验证、项目设置或测试状态报告。创建完成后工作目录为 .worktrees/${feature_name},后续实现工作在此进行,保持主工作区干净。