告别频繁切换分支Superpowers 的 Git 工作树隔离工作区完全指南【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers让 AI 编码助手写代码时最容易踩的坑是它直接在你当前分支上动手——想并行推进两个需求、或者中途想回滚都会很被动。Superpowers 用 Git 工作树worktree解决这个问题它的 using-git-worktrees 技能负责创建隔离工作区finishing-a-development-branch 技能负责收尾和清理。下面是这套机制的决策逻辑和上手方法。为什么频繁切分支是个负担让代理开发功能 A、同时还想试功能 B 时在同一个检出目录里操作通常会遇到三类问题未提交改动碍事每次切换都得 stash 再恢复容易忘、容易丢环境漂移分支间依赖版本不一致切完分支得重新装依赖代理的上下文也跟着乱回滚困难两个需求的改动混在同一目录出了问题分不清哪些改动属于谁工作树让每个分支拥有独立目录和独立的文件环境但共享同一个 Git 对象库不需要重新克隆仓库切换成本只是一次cd。创建前Superpowers 怎么决策三步决策不重复造轮子技能不会上来就建目录而是按顺序判断先检测确认是否已处于工作树中顺带排除子模块造成的误判已经隔离就直接跳过创建优先原生工具宿主平台若自带工作树工具例如EnterWorktree就用它没有才回退到git worktree add选目录用户显式声明的偏好 项目里已有的.worktrees/或worktrees/ 默认新建.worktrees/目录创建前的自动校验对放在项目内的目录它总会先跑一句校验git check-ignore -q .worktrees目录没被 .gitignore 忽略的话它会先补上配置并提交再开始创建——避免工作树内容被误提交进仓库。三步搭好隔离开发环境 直接对代理说我要在隔离环境里开发 feature/auth技能自动触发征得你同意后动手创建绑定新分支的工作树一条命令搞定git worktree add .worktrees/feature-auth -b feature/auth进入新目录后自动识别项目类型、配置环境并跑一轮测试确认基线干净环境配置规则很直白按项目类型自动执行项目类型识别文件自动执行Node.jspackage.jsonnpm installRustCargo.tomlcargo buildPythonrequirements.txt/pyproject.tomlpip install/poetry installGogo.modgo mod download基线测试失败时代理不会硬闯它会报告失败项并询问你是否继续避免把既有问题带进新开发。分支收尾一个三选项菜单 收尾阶段的原则是测试全绿才出现菜单有失败就先修不进入后续决策。菜单固定三个选项本地合并先跟你确认这个分支从哪个基分支分出合错基分支回滚成本很高合并后再对合并结果跑一次测试绿灯才移除工作树并删除分支推送并建 PR推远端后创建 Pull Request工作树保留方便在评审反馈时继续改保持原样什么都不动留待你之后处理两条边界规则值得记住只有位于.worktrees/或worktrees/下、由它自己创建的工作树才会被清理宿主环境自己的工作树一律不碰丢弃工作必须你明确输入discard确认代理不会自作主张。容易踩的几个坑与规避办法 ⚠️场景容易犯的错Superpowers 的处理目录未被 gitignore工作树整树被误提交自动校验并补写 .gitignore已在某个工作树里重复创建、目录嵌套第 0 步检测直接跳过基线测试失败在脏基线上继续开发后续失败难归因先报告等你决定再继续推送被拒绝下意识 force push仅在你明确指示时才强推detached HEAD 状态误选本地合并只给 PR 或保留两个选项想亲手体验的话克隆仓库后按 README 把 Superpowers 装到你的编码助手里再在任意项目里说一句为这个功能建一个隔离工作区即可开始git clone https://gitcode.com/GitHub_Trending/su/superpowers【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考