SuperAPI AI 工具集

workspace-isolation

编程与开发

查看项目

更新于 10-16 04:54

技能介绍

用途:该技能用于借助 Git worktree 创建隔离的工作环境,使多个分支的并行开发互不干扰,无需在分支间来回切换。核心原则是“系统化目录选择 + 安全验证 = 可靠隔离”。使用开始时需声明正在使用该技能设置隔离工作区。

目录选择:按优先级依次判断。先检查是否存在 .worktrees 或 worktrees 目录,若两者都在则 .worktrees 优先;若不存在则查询 CLAUDE.md 中的 worktree 目录偏好并直接采用;若仍无则询问用户,可选项目内隐藏目录 .worktrees/ 或全局位置 ~/.config/superpowers/worktrees/<project-name>/。

安全验证:项目本地目录必须在创建 worktree 前确认 .gitignore 已包含对应目录(如 ^.worktrees/$ 或 ^worktrees/$),否则应立即补充并提交;全局目录在项目之外,无需校验。

创建步骤:先用 basename 与 git rev-parse --show-toplevel 探测项目名,再执行 git worktree add "$path" -b "$BRANCH_NAME" 并进入该路径;随后按项目文件自动运行初始化(如 package.json 时 npm install、Cargo.toml 时 cargo build、requirements.txt 时 pip install -r、pyproject.toml 时 poetry install、go.mod 时 go mod download);接着运行测试验证干净基线,如 npm test、cargo test、pytest、go test ./...。测试通过则报告路径与测试结果,失败则报告并询问是否继续。

适用场景:并行开发多分支、为设计获批后的实现准备隔离工作区,常与 finishing-a-development-branch 配合用于收尾清理。

限制与注意:不得跳过 .gitignore 校验(否则 worktree 内容会被跟踪)、不得跳过基线测试、不得在测试失败时未经确认继续、不得在目录不明确时自行假设、不得跳过 CLAUDE.md 检查。若无 package.json 或 Cargo.toml 等则跳过依赖安装。