用途:在开始需要与当前工作区隔离的功能开发,或执行实施计划前,确保存在一个隔离的工作区,避免改动影响当前分支。核心原则是先检测隔离状态,再优先使用平台原生工作区工具,最后才回退到 git worktree,不与管理框架对抗。
主要能力:
- 检测既有隔离:通过比较 git rev-parse --git-dir 与 --git-common-dir 判断是否已在链接工作树中,并用 git rev-parse --show-superproject-working-tree 排除子模块误判。
- 征询同意:若未预先声明偏好,先询问用户是否创建隔离工作树。
- 创建隔离工作区:优先使用原生工具(如 EnterWorktree、WorktreeCreate、/worktree 命令或 --worktree 标志);无原生工具时才手动执行 git worktree add "$path" -b "$BRANCH_NAME"。
- 目录选择:优先用户指定目录,其次项目内已有的 .worktrees(隐藏)或 worktrees,均无则默认 .worktrees/。项目本地目录创建前必须用 git check-ignore 验证已被忽略,否则先加入 .gitignore 并提交。
- 项目初始化与基线验证:按 package.json、Cargo.toml、requirements.txt、pyproject.toml、go.mod 自动检测并运行安装/构建,再用项目对应命令(npm test、cargo test、pytest、go test ./...)跑测试确认基线干净。
使用方式:调用该技能后先在开场声明正在使用它建立隔离工作区,再按上述步骤执行。若已在链接工作树中则跳过创建;若测试失败则报告并询问是否继续或排查;若 git worktree add 因沙箱权限失败,则告知用户并在当前目录继续执行设置与基线测试。
限制:仅在资料覆盖范围内提供上述流程;未提供关于收费、价格、支持平台范围或效果保证的信息。具体命令和目录规则应保持原样。