Superpowers Git工作树并行开发指南:如何不切分支让AI完成隔离开发
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是面向编码 Agent 的一套可组合技能框架,其中的 Git 工作树技能会自动创建隔离工作区、配置环境并验证基线后再开工。它针对的痛点很常见:多个分支来回切换,每次都要手动git stash,环境还得重新配一遍。
它到底解决什么问题
编码 Agent 常有"上来就写"的习惯:需求没问清就动手,环境没就绪就跑,测试基线是坏的还是先写代码。Superpowers 把一套软件开发方法论打包成可自动触发的技能,Agent 每做一个任务前先检查该激活哪条流程。它支持 Claude Code、Codex、Cursor、Gemini CLI 等多种 Agent 平台,技能随平台插件加载后自动生效。解决的是流程问题:让 Agent 按"明确需求 → 隔离工作区 → 拆解计划 → 实现并审查"的顺序推进,而不是跳步。
最快上手路径
先把仓库拉下来,再按所用平台装插件。以 Claude Code 为例:
git clone https://gitcode.com/GitHub_Trending/su/superpowers /plugin install superpowers@claude-plugins-officialCursor 在 Agent 对话里输入/add-plugin superpowers即可;OpenCode、Kimi Code 等其他平台的安装方式见 README。
装完无需额外配置:在会话里直接提出"开发一个用户登录功能",brainstorming 技能会先提问澄清需求,设计确认后工作树流程自动接管。第一个可见结果是 Agent 回报"工作区就绪、基线测试通过"。
核心能力逐个看
三步定下工作树目录:团队成员布局天然一致
using-git-worktrees 的目录选择优先级很明确:先看指令文件里是否声明了偏好目录,再找项目里已有的.worktrees/或worktrees/(两者并存时优先.worktrees/),都没有就默认在仓库根目录建.worktrees/。效果是第一个工作树落地后,所有人的布局保持一致,不需要口头约定。
创建前先校验忽略状态:避免工作树被误提交
对仓库内目录,创建前必须先确认它已被 Git 忽略:
git check-ignore -q .worktrees若未被忽略,技能会先把目录写进.gitignore并提交,然后才创建 worktree。目录没校验过,整棵工作树的内容都会出现在git status里污染仓库状态,这一步在源头掐掉了这种风险。
按项目类型初始化环境并验证基线:开发起点保证干净
工作树建好后,它依据package.json、Cargo.toml、requirements.txt、go.mod等文件自动识别项目类型,执行对应的安装或构建,再跑一遍完整测试套件。基线失败时逐项报告失败原因并询问是否继续,不静默开工。好处是后续任何测试失败都能归因到"这次改的东西",而不是"之前就是坏的"。
收尾时先验证后清理:分支有明确出口
finishing-a-development-branch 在功能完成时重跑全量测试,确认基分支无误后给出三个选项:本地合并、推送并建 PR、保留分支稍后处理。选择执行完,再清理工作树。整个过程主分支不受触碰。
一个登录功能开发场景走一遍
以"新增邮箱加密码登录"为例:
- 在主会话提出需求:"加一个登录功能,邮箱加密码。"
- brainstorming 技能先提问确认边界(是否需要忘记密码、与现有鉴权如何衔接),再分段输出设计文档供确认。
- 设计批准后,using-git-worktrees 激活:检测到项目已有
.worktrees/,校验忽略状态后建出feature/login分支,识别出 Node.js 项目并执行npm install。 - 基线
npm test全部通过,writing-plans 把工作拆成每个 2~5 分钟的任务,每个任务都带文件路径、代码和验证步骤。 - subagent-driven-development 为每个任务派发全新的子 Agent,按 TDD 先写失败测试再写最小实现;每个任务由审查子 Agent 做两级检查——先核对规格符合性,再看代码质量。
- 全部任务完成后重跑全量测试,给出合并选项,按选择执行并清理工作树。
全程人只需要做两类输入:确认设计、确认合并方式。
适合谁,什么情况下别用
适合:
- 已在用编码 Agent,想让单个功能跑长循环、少打断的人;
- 多分支并行开发、希望工作树布局在团队内统一的场景;
- 测试套件稳定、基线可信的项目。
不适合:
- 完全没有测试的项目:基线验证和 TDD 纪律都失去锚点,建议先补最小测试集;
- 只想快速验证一个想法:从头脑风暴到工作树再到计划的完整链路偏重,技能本身支持拒绝建工作树、直接在当前目录工作;
- Agent 平台不支持子 Agent 时,subagent-driven-development 会退化为 executing-plans 的批量执行模式,速度优势有限。
替代方案:如果只是想要分支隔离,一条git worktree add就够;Superpowers 提供的是叠加在其上"先澄清、再计划、后审查"的完整方法论。
结尾
Superpowers 把"切分支、配环境、跑基线测试"这条动作链变成 Agent 自动触发的技能,让人把注意力留给设计确认与代码审查。完整工作流与各技能细节,可从 README 和 skills 目录 逐篇查阅。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考