Using Git Worktrees Skill

Using Git Worktrees 是 Superpowers 中的一个 Skill（Skill 源码）。当功能开发需要与当前检出隔离时运行，通常在设计获批之后、执行计划之前，确保智能体在独立工作区、独立分支上工作，并有干净的测试基线。

原则：先检测是否已隔离，再用原生工具，最后退回 git，不要与所用工具对着干。

核心功能

• 第 0 步，检测：比较 git rev-parse --git-dir 和 --git-common-dir，判断是否已在链接的 worktree 中，并防止把 git 子模块误判为 worktree。
• 征得同意：除非你的指令已写明偏好，智能体创建 worktree 前会先询问；你拒绝就在原地工作。
• 原生优先：工具自带 worktree 功能（如 /worktree 命令或 EnterWorktree 这类工具）时优先使用，因为手动创建的 worktree 会产生工具看不见的状态。
• git 兜底：否则在 .worktrees/（首选）或 worktrees/ 下执行 git worktree add <path> -b <branch>，并先用 git check-ignore 确认目录已被忽略。
• 初始化与基线：自动识别并运行 npm install、cargo build、pip install、poetry install 或 go mod download，然后跑测试报告基线。
• 沙箱兜底：沙箱禁止创建 worktree 时，智能体会说明情况并在当前目录工作。

适用场景

• 开发新功能时保持主检出不被改动。
• 在同一仓库的不同分支上同时运行多个智能体。
• 在 Executing Plans 或 Subagent-Driven Development 之前。

定价

免费开源，MIT 许可证。Superpowers 背后的公司 Prime Radiant 为企业提供商业支持。实际成本主要是 token：流程类 Skill 会增加提问、评审和子智能体运行。

快速开始

Superpowers 以一个插件整体安装，这个 Skill 会连同整套库一起装上（v6.4.1 共 15 个 Skill）。在 Claude Code 中运行 /plugin install superpowers@claude-plugins-official。Cursor 用 /add-plugin superpowers，Gemini CLI 用 gemini extensions install https://github.com/obra/superpowers，Codex、GitHub Copilot CLI、OpenCode、Pi 等工具的命令见 README。Skill 会自动触发，也可以直接点名调用。 工作流 Skill 会自动调用它，你也可以直接要求"为这个功能建一个隔离的 worktree"。

局限：每个 worktree 都要单独安装依赖，大型项目会占用更多磁盘和时间。清理工作由 Finishing a Development Branch 负责。

常见问题

为什么创建 worktree 前要先问？

它会改变你的文件系统布局，所以除非你已表明偏好，Skill 把决定权留给你。

基线测试失败怎么办？

智能体会报告失败并询问是否继续。

替代方案

• Conductor：在隔离副本中并行运行多个 Claude Code 的 Mac 应用。
• Orca ADE：在 worktree 中并排运行多个编程智能体。
• cmux：专为同时管理多个智能体会话设计的终端。

总结

小而谨慎，并且懂得配合所用工具，让智能体的工作远离你的主分支。更多见 skills 分类。