Superpowers Git 工作树实战:3 步搭好隔离开发区,告别来回切分支
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一个可装进 Claude Code 的技能库,它的 Git 工作树技能(using-git-worktrees)能把每个新功能搬进独立工作区:不用切分支、不用重新克隆仓库,依赖安装和基线测试都会自动完成。
深夜被临时叫去修 bug,你的分支怎么办
周五晚上,你刚在 main 上跑完一轮长测试,同事突然发消息:线上接口挂了,得马上查。切过去?未提交的改动先搁置,依赖和环境可能还得重跑一遍。来回切分支不仅打断思路,还容易把两个功能的改动搅在一起。Git 工作树(worktree)的思路是:同一个仓库开多份工作目录,每个目录挂一个独立分支,互不踩踏。Superpowers 把这件事流程化了——先确认你是否已在隔离环境里,不在就自动选目录、建分支、装依赖、跑基线测试,全程基本不用你动手。
传统切分支 vs 工作树方案,差在哪
| 对比项 | 传统做法 | Superpowers 工作树方案 |
|---|---|---|
| 并行开发 | git checkout 来回切换,环境反复重建 | 每个功能一个独立目录,互不干扰 |
| 目录位置 | 手动挑、手动建,各写各的 | 优先沿用 .worktrees/ 或 worktrees/,再问偏好 |
| 忽略检查 | 容易忘,工作区文件混进提交 | 自动检查 .gitignore,缺了就补上并提交 |
| 环境配置 | 新目录里手动装一遍依赖 | 按项目类型自动跑 npm install、cargo build 等 |
| 基线状态 | 凭感觉开工,失败难归因 | 先跑测试,红了先报告再决定 |
上手步骤:三步进入隔离工作区
整个流程只有三步:
- 检查是否已在隔离环境,没有就按优先级选定目录
- 创建 worktree,把新分支挂上去
- 自动装依赖、跑基线测试,全绿才算就绪
第 1–2 步:选目录,挂分支
选目录有固定优先级:项目里已有 .worktrees、worktrees 任一目录就直接沿用,两个都有则选 .worktrees;其次参考 CLAUDE.md 里声明的偏好,最后才问你一次。确认后它会执行类似这样的命令:
git worktree add .worktrees/auth -b feature/auth作用:在项目根下建一个隔离目录,让新分支 feature/auth 直接挂上去,之后的改动全发生在隔离区里。
第 3 步:装依赖,验基线
目录建好后按项目类型自动配置:Node 跑 npm install,Rust 跑 cargo build,Python 装依赖,Go 跑 go mod download。最后先跑一遍完整测试,全绿才算基线干净;有失败就停下报告明细,让你决定是先查还是继续。
进阶技巧与避坑:现象 → 处理 💡
- git status 里冒出一堆工作区文件:说明目录没被忽略。Superpowers 会先跑 git check-ignore 确认,没忽略就写进 .gitignore 并提交,再继续创建。
- 新工作区一建好测试就红:先别开发。基线不干净会让后面每个失败都说不清来源,等它报告失败明细,再决定排查或跳过。
- 权限受限导致创建失败:它会回退到当前目录直接开发,照常配置环境、跑基线,流程不断。
- 功能做完了,分支和目录还留着:用 finishing-a-development-branch 技能收尾——测试全绿后给"本地合并 / 推送提 PR / 先保留"三个选项,合并成功后自动移除工作树并清理分支。
- 工作区越攒越多:用 git worktree list 看全量,定期清掉不再用的。
完整规则在 skills/using-git-worktrees/,收尾细节在 skills/finishing-a-development-branch/。遇到"我好像已经在 worktree 里了"这种模糊状态,它也会先跑命令确认,而不是靠猜。
下一步
下次开新功能之前,先让 Superpowers 用 Git 工作树技能搭一个隔离区:目录规范、环境配置、基线验证都替你兜底。现在就跑一次三步流程,从 .worktrees 目录开始,体会不切分支的并行开发。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考