Superpowers Git Worktree 实战指南让 AI 编码代理在隔离分支里安心干活【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一套给编码代理用的技能框架其中的 git worktree 相关技能解决一个很具体的问题让 AI 在隔离的工作空间里改代码而不污染你的主分支。装好之后你不用再手动切分支、清 stash——代理会自己建工作树、装依赖、跑基线测试干完活再干净收场。先说一个常见的翻车现场想象这个场景你正在 main 分支上工作区还有几个没提交的文件。你让编码代理帮我实现登录功能它二话不说直接在你当前目录里开干。问题立刻出现想临时切到另一个分支对不起得先 stash还得记住自己改到哪了。两个任务并行每个任务都要等编译、等测试目录只有一个互相挤占。代理中途出错回滚你原本干净的主分支也一起脏了。传统解法是手动 clone 一份仓库或者反复 stash/checkout每一步都靠人肉记忆。Superpowers 的思路不一样它给代理装了一个前置流程——skills/using-git-worktrees/SKILL.md 里定义的隔离工作区技能在动第一行代码之前先把战场圈出来。动手之前先确认我在哪这个技能的第一步不是创建任何东西而是检测当前是否已经处在隔离环境里。跳过这一步是新手最容易犯的错。用三个 Git 变量判断现状技能会先执行一段检测命令核心是比对两个路径GIT_DIR$(cd $(git rev-parse --git-dir) pwd -P) GIT_COMMON$(cd $(git rev-parse --git-common-dir) pwd -P)两者相等说明你在普通仓库检出里两者不等说明你已经在某个关联 worktree 中直接跳过创建步骤。这里有个隐蔽的坑git submodule 里这两个值也不等所以技能还会额外跑一条git rev-parse --show-superproject-working-tree排除子模块的干扰。肉眼判断我好像不在 worktree 里并不可靠命令给出的结论才算数。有原生工具就先用原生工具如果你的代理平台自带 worktree 工具比如EnterWorktree之类的命令技能会优先用它而不是直接调git worktree add。原因是原生工具负责目录放置、建分支和清理的全生命周期绕过它自己用 git 建会造出宿主工具看不到的幽灵状态后面没法统一回收。只有确认手头没有任何原生工具时才会走 git 原生命令这条路。目录怎么选、环境怎么配真正落到git worktree add这一步时技能内置了一套确定性的选择规则省掉你拍板的功夫。目录选择有明确的优先级按顺序找你明确说过的偏好 项目里已有的.worktrees或worktrees目录两个都在时.worktrees优先 默认的.worktrees/。也就是说项目约定一次之后每次创建工作树的位置都一致。安全校验先确认目录被 Git 忽略项目本地目录在创建前必须通过一条检查git check-ignore -q .worktrees 2/dev/null || git check-ignore -q worktrees这条命令在验证工作树目录是否已被 Git 忽略。如果没被忽略技能会先把目录写进 .gitignore 并提交再继续创建。不做这一步的后果是整个工作树的文件会被误提交进主仓库比切错分支麻烦得多。创建完自动配环境、跑基线工作树建好后技能会根据项目类型自动执行初始化有package.json就npm install有Cargo.toml就cargo buildPython 和 Go 项目同理。最后跑一遍完整测试套件确认基线是绿的。git worktree add .worktrees/auth -b feature/auth这一条命令完成建目录、建分支、检出代码三件事后面的依赖安装和基线测试由技能接着做。基线测试如果红了技能会停下来报告失败项并问你要不要继续——带着一个脏基线开工之后每个失败都说不清是谁引入的所以这一步不跳过。收尾分支合并与工作树清理干完活怎么收场由 skills/finishing-a-development-branch/SKILL.md 定义流程是验证测试 → 检测环境 → 给出选项 → 执行 → 清理。它不会自作主张合并而是给你一张明确的菜单本地合并回基分支合并后先验证测试绿了才删分支、删工作树推送并创建 Pull Request此时工作树保留方便你在上面改 PR 反馈分支原样保留工作树保留只有第 1 种和明确的丢弃请求才会触发清理且只清 Superpowers 自己在.worktrees/或worktrees/下建的工作树git worktree remove $WORKTREE_PATH git worktree prune第一条移除工作树目录第二条清掉任何残留的过期注册记录。宿主管着的工作树不碰避免误删别人或平台的隔离环境。从 0 到跑起来的最短路径照着做十分钟内能体验到完整流程克隆 Superpowers 仓库按仓库 README 给你的代理安装Claude Code、Cursor、Gemini CLI 等各有对应的安装命令git clone https://gitcode.com/GitHub_Trending/su/superpowers这一步把技能库装进你的环境README 里按你使用的代理类型找对应安装段即可。打开你自己的项目对代理说一句开始做 XX 功能。技能会自动触发代理会先宣告正在使用 using-git-worktrees 技能然后完成检测、建树、装依赖、跑基线。用git worktree list确认工作树出现在预期位置开始正常开发。功能完成后说完成这个分支代理会跑完整测试然后出示合并/PR/保留的选项由你拍板。✅ 全程你只说了两句话剩下的检测和命令都由技能代劳。团队场景下的真实收益这套流程的价值在多分支、多人协作时会放大并行不互扰每个任务一条独立工作树两个代理同时跑两个 feature 互不阻塞主仓库工作区保持干净。环境一致性每个工作树走同一套初始化脚本不会出现A 机器上能跑、B 机器上缺依赖的漂移。切换成本趋近于零不用重新 clone、不用 stash/checkout 来回倒腾上下文切换从分钟级变成一句命令。可追溯的清理只有自家目录会被回收git worktree list随时能看到全局状态过期工作树用 prune 一键清干净。三个容易踩的误区误区一我明显不在 worktree 里不用检测建议永远先跑 Step 0 的检测命令。宿主工具建的隔离环境和子模块都会骗过肉眼只有GIT_DIR与GIT_COMMON的比对结果可靠。误区二工作区是新的基线测试可以省建议基线测试现在跑花几分钟脏基线留着后面每次失败都要花时间排查归因。跳过它是把现在的便宜换成以后的账。误区三那个工作树看着没用顺手删了建议只清理.worktrees/或worktrees/下、且确认属于你自己的工作树。宿主环境或别人平台管理的目录删错了恢复成本很高。写在最后Superpowers 做的事情本质是把隔离开发 环境自举 干净收尾这三件老程序员都懂、但懒得每次都做的事固化成了代理的默认行为。你得到的是一个始终在主分支外作业、自带基线验证、收场不烂尾的 AI 搭档。下一步克隆仓库按 README.md 给你的代理装上技能然后在下一次开新 feature 时让代理先把工作树建起来再动手。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Superpowers Git Worktree 实战指南：让 AI 编码代理在隔离分支里安心干活
Superpowers Git Worktree 实战指南让 AI 编码代理在隔离分支里安心干活【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一套给编码代理用的技能框架其中的 git worktree 相关技能解决一个很具体的问题让 AI 在隔离的工作空间里改代码而不污染你的主分支。装好之后你不用再手动切分支、清 stash——代理会自己建工作树、装依赖、跑基线测试干完活再干净收场。先说一个常见的翻车现场想象这个场景你正在 main 分支上工作区还有几个没提交的文件。你让编码代理帮我实现登录功能它二话不说直接在你当前目录里开干。问题立刻出现想临时切到另一个分支对不起得先 stash还得记住自己改到哪了。两个任务并行每个任务都要等编译、等测试目录只有一个互相挤占。代理中途出错回滚你原本干净的主分支也一起脏了。传统解法是手动 clone 一份仓库或者反复 stash/checkout每一步都靠人肉记忆。Superpowers 的思路不一样它给代理装了一个前置流程——skills/using-git-worktrees/SKILL.md 里定义的隔离工作区技能在动第一行代码之前先把战场圈出来。动手之前先确认我在哪这个技能的第一步不是创建任何东西而是检测当前是否已经处在隔离环境里。跳过这一步是新手最容易犯的错。用三个 Git 变量判断现状技能会先执行一段检测命令核心是比对两个路径GIT_DIR$(cd $(git rev-parse --git-dir) pwd -P) GIT_COMMON$(cd $(git rev-parse --git-common-dir) pwd -P)两者相等说明你在普通仓库检出里两者不等说明你已经在某个关联 worktree 中直接跳过创建步骤。这里有个隐蔽的坑git submodule 里这两个值也不等所以技能还会额外跑一条git rev-parse --show-superproject-working-tree排除子模块的干扰。肉眼判断我好像不在 worktree 里并不可靠命令给出的结论才算数。有原生工具就先用原生工具如果你的代理平台自带 worktree 工具比如EnterWorktree之类的命令技能会优先用它而不是直接调git worktree add。原因是原生工具负责目录放置、建分支和清理的全生命周期绕过它自己用 git 建会造出宿主工具看不到的幽灵状态后面没法统一回收。只有确认手头没有任何原生工具时才会走 git 原生命令这条路。目录怎么选、环境怎么配真正落到git worktree add这一步时技能内置了一套确定性的选择规则省掉你拍板的功夫。目录选择有明确的优先级按顺序找你明确说过的偏好 项目里已有的.worktrees或worktrees目录两个都在时.worktrees优先 默认的.worktrees/。也就是说项目约定一次之后每次创建工作树的位置都一致。安全校验先确认目录被 Git 忽略项目本地目录在创建前必须通过一条检查git check-ignore -q .worktrees 2/dev/null || git check-ignore -q worktrees这条命令在验证工作树目录是否已被 Git 忽略。如果没被忽略技能会先把目录写进 .gitignore 并提交再继续创建。不做这一步的后果是整个工作树的文件会被误提交进主仓库比切错分支麻烦得多。创建完自动配环境、跑基线工作树建好后技能会根据项目类型自动执行初始化有package.json就npm install有Cargo.toml就cargo buildPython 和 Go 项目同理。最后跑一遍完整测试套件确认基线是绿的。git worktree add .worktrees/auth -b feature/auth这一条命令完成建目录、建分支、检出代码三件事后面的依赖安装和基线测试由技能接着做。基线测试如果红了技能会停下来报告失败项并问你要不要继续——带着一个脏基线开工之后每个失败都说不清是谁引入的所以这一步不跳过。收尾分支合并与工作树清理干完活怎么收场由 skills/finishing-a-development-branch/SKILL.md 定义流程是验证测试 → 检测环境 → 给出选项 → 执行 → 清理。它不会自作主张合并而是给你一张明确的菜单本地合并回基分支合并后先验证测试绿了才删分支、删工作树推送并创建 Pull Request此时工作树保留方便你在上面改 PR 反馈分支原样保留工作树保留只有第 1 种和明确的丢弃请求才会触发清理且只清 Superpowers 自己在.worktrees/或worktrees/下建的工作树git worktree remove $WORKTREE_PATH git worktree prune第一条移除工作树目录第二条清掉任何残留的过期注册记录。宿主管着的工作树不碰避免误删别人或平台的隔离环境。从 0 到跑起来的最短路径照着做十分钟内能体验到完整流程克隆 Superpowers 仓库按仓库 README 给你的代理安装Claude Code、Cursor、Gemini CLI 等各有对应的安装命令git clone https://gitcode.com/GitHub_Trending/su/superpowers这一步把技能库装进你的环境README 里按你使用的代理类型找对应安装段即可。打开你自己的项目对代理说一句开始做 XX 功能。技能会自动触发代理会先宣告正在使用 using-git-worktrees 技能然后完成检测、建树、装依赖、跑基线。用git worktree list确认工作树出现在预期位置开始正常开发。功能完成后说完成这个分支代理会跑完整测试然后出示合并/PR/保留的选项由你拍板。✅ 全程你只说了两句话剩下的检测和命令都由技能代劳。团队场景下的真实收益这套流程的价值在多分支、多人协作时会放大并行不互扰每个任务一条独立工作树两个代理同时跑两个 feature 互不阻塞主仓库工作区保持干净。环境一致性每个工作树走同一套初始化脚本不会出现A 机器上能跑、B 机器上缺依赖的漂移。切换成本趋近于零不用重新 clone、不用 stash/checkout 来回倒腾上下文切换从分钟级变成一句命令。可追溯的清理只有自家目录会被回收git worktree list随时能看到全局状态过期工作树用 prune 一键清干净。三个容易踩的误区误区一我明显不在 worktree 里不用检测建议永远先跑 Step 0 的检测命令。宿主工具建的隔离环境和子模块都会骗过肉眼只有GIT_DIR与GIT_COMMON的比对结果可靠。误区二工作区是新的基线测试可以省建议基线测试现在跑花几分钟脏基线留着后面每次失败都要花时间排查归因。跳过它是把现在的便宜换成以后的账。误区三那个工作树看着没用顺手删了建议只清理.worktrees/或worktrees/下、且确认属于你自己的工作树。宿主环境或别人平台管理的目录删错了恢复成本很高。写在最后Superpowers 做的事情本质是把隔离开发 环境自举 干净收尾这三件老程序员都懂、但懒得每次都做的事固化成了代理的默认行为。你得到的是一个始终在主分支外作业、自带基线验证、收场不烂尾的 AI 搭档。下一步克隆仓库按 README.md 给你的代理装上技能然后在下一次开新 feature 时让代理先把工作树建起来再动手。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考