用途
该技能用于在开始需要与当前工作区隔离的功能开发之前,或执行实施方案之前,创建一个隔离的 Git worktree 工作区。Git worktree 能创建共享同一仓库的独立工作区,允许同时处理多个分支而无需来回切换。其核心原则是:系统性目录选择 + 安全验证 = 可靠的隔离。
主要能力
- 目录选择流程:按优先级顺序检查已存在的目录(.worktrees 优先于 worktrees),检查 CLAUDE.md 中是否指定了 worktree 目录偏好,若都没有则询问用户选择项目本地隐藏目录 .worktrees/ 或全局位置 ~/.config/superpowers/worktrees/<project-name>/。
- 安全验证:对于项目本地目录,创建 worktree 前必须用 git check-ignore 验证该目录已被忽略;若未被忽略,则向 .gitignore 添加相应条目并提交该更改,以避免 worktree 内容被意外提交到仓库。全局目录无需 .gitignore 验证。
- 自动创建与初始化:检测项目名称,使用 git worktree add 创建带新分支的 worktree,并自动检测项目文件(package.json、Cargo.toml、requirements.txt、pyproject.toml、go.mod)执行对应的依赖安装或构建。
- 基线验证与报告:运行项目测试以确保 worktree 从干净状态开始;测试失败时报告失败并询问是否继续或排查;测试通过则报告就绪位置与就绪功能。
使用方式
开始时需声明:“I'm using the using-git-worktrees skill to set up an isolated workspace.” 随后按目录选择、安全验证、创建步骤(检测项目名、创建 worktree、运行项目设置、验证干净基线、报告位置)依次执行。
适用场景
被以下流程调用:brainstorming(第 4 阶段,设计获批且后续实施时必需)、subagent-driven-development(执行任何任务前必需)、executing-plans(执行任何任务前必需)、任何需要隔离工作区的技能。并与 finishing-a-development-branch 配对使用(工作完成后清理时必需)。
限制与注意事项
常见错误包括:跳过忽略验证(导致 worktree 内容被跟踪、污染 git 状态)、假设目录位置(造成不一致并违反项目约定)、在测试失败时继续(无法区分新缺陷与既有问题)、硬编码设置命令(在采用不同工具的项目上失效)。红线行为:绝不创建未验证忽略状态的项目本地 worktree、绝不跳过基线测试验证、绝不在未询问的情况下在测试失败时继续、绝不在目录不明确时臆断位置、绝不跳过 CLAUDE.md 检查。必须始终遵循目录优先级(已存在 > CLAUDE.md > 询问)、验证项目本地目录已被忽略、自动检测并运行项目设置、验证干净的测试基线。若项目中不存在 package.json/Cargo.toml 等文件,则跳过依赖安装。
暂未提供
除上述内容外,该技能的收费、价格、支持平台等具体信息暂未提供。