Superpowers：给AI编码代理装上完整开发工作流的新手指南
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一套为AI编码代理打造的开发工作流框架，通过可组合的技能（Skills）和初始指令，让AI代理开发时不再随意写代码，而是按流程自主完成设计、编码、测试与评审。如果你正在用 Claude Code 或 Codex 做AI代理开发，这篇指南能帮你在几分钟内跑通它的完整工作流。
痛点：为什么你的AI代理写的代码总在返工？
问一个常见场景：你让AI代理做一个功能，它没有确认需求，直接开写；写完测试没跑过，也没告诉你哪里不确定；中途偏离方向，等你发现时已经改了一堆文件。
这类问题的根源不是模型不够聪明，而是缺少一套约束它的流程。Superpowers 解决的正是这件事：它把"先问清楚、再设计、再写代码、最后验证"这套人类工程师的习惯，固化成AI代理可以自动执行的技能，让AI编码代理工作流从"碰运气"变成"照章办事"。
一句话定位：Superpowers 是什么、给谁用
Superpowers 由两部分组成：
- 一组可组合的技能（Skills）：每个技能定义一类行为的完整流程，比如头脑风暴、写计划、测试驱动开发
- 一套初始指令：让代理在会话开始时就知道这些技能的存在，并在合适的时机自动启用它
你可以把它理解成"给AI代理的SOP手册"。它不替代模型本身，而是规范模型做事的顺序和标准。适用对象是任何使用AI编码代理（Claude Code、Codex、OpenCode 等）做实际开发的人——不管你是新手还是老手，只要不想让AI"裸写代码"，它就是为你准备的。
Claude Code、Codex、OpenCode：Superpowers安装方法对比
三个平台的安装路径不同，但都能在几分钟内完成。
| 平台 | 安装方式 | 验证方法 |
|---|---|---|
| Claude Code | 在对话框输入/plugin marketplace add obra/superpowers-marketplace，再输入/plugin install superpowers@superpowers-marketplace | 输入/help，确认出现/superpowers:brainstorm、/superpowers:write-plan、/superpowers:execute-plan三个命令 |
| Codex | 让代理抓取并遵循官方 INSTALL.md 中的安装指令 | 安装后询问代理是否已加载 Superpowers 技能 |
| OpenCode | 同样让代理抓取并遵循官方 INSTALL.md 中的安装指令 | 安装后让代理列出已加载的技能 |
以 Claude Code 为例，两条命令就够了：
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace如果更习惯本地方式，也可以直接克隆仓库后按平台说明配置：
git clone https://gitcode.com/GitHub_Trending/su/superpowers提示：安装成功后，代理会在会话开始时自动检查可用技能。你不需要手动"调用"某个技能，它会在合适的节点自己激活。
工作流拆解：动手前、设计期、实现期、收尾期四阶段
理解 Superpowers 的关键不是记住步骤数量，而是看清每个阶段"由什么技能负责、产出什么、谁确认"。整个AI代理开发过程被切成四个阶段，代理在每阶段进入前都会检查对应技能。
阶段一：动手前——先问清楚，不碰键盘
代理识别到你正在构建项目时，不会立刻写代码，而是先通过提问理解真实需求。这一步由brainstorming技能接管：它追问边界条件、探索替代方案，把想法打磨成初步方案。很多"返工"其实源于这一步被跳过，所以它是整个流程的起点。
阶段二：设计期——分模块确认，落成计划
需求梳理清楚后，代理会把方案拆成容易阅读理解的模块，逐个展示给你确认。设计获批后，两件事紧接着发生：
- 隔离环境：
using-git-worktrees技能创建独立的工作树（worktree，即 Git 的并行工作区，同一仓库可以同时有多个互不干扰的分支目录），运行项目设置，并验证干净的测试基线——确保后续改动不会污染主干。 - 拆解任务：
writing-plans技能把工作拆成 2-5 分钟粒度的小任务，每个任务写明确切文件路径、完整代码和验证步骤。
计划阶段强调三个原则：TDD（测试驱动开发，先写测试再写实现）、YAGNI（不要写现在用不上的功能）、DRY（不要重复写相同逻辑）。一份合格的计划，应该让执行者没有任何"自由发挥"的空间。
阶段三：实现期——子代理分工执行，边做边评
计划确认后，流程进入最耗时的部分。这里有两种执行模式可选：
subagent-driven-development（子代理驱动开发）：每个任务派一个全新的子代理（subagent，即独立执行单个任务的代理实例）去完成，做完后经过两阶段评审——先查是否符合规格，再查代码质量。任务之间由requesting-code-review技能按严重程度报告问题，关键问题会直接阻止进度。executing-plans：按批次执行，批次之间设人工检查点，由你亲自过目。
实现过程中，test-driven-development技能强制执行红-绿-重构循环：先写一个会失败的测试，亲眼看到它失败，再写最少量的代码让它通过，最后提交。如果代理在写测试前先写了实现代码，这套流程会要求删掉重来——这正是它和"随手写点测试"的本质区别。
模式上，Claude 这类模型可以连续自主工作数小时而不偏离计划，原因在于：计划颗粒度足够小、每个任务都有明确验收标准、评审环节会自动拦截偏差。
阶段四：收尾期——验证测试，决定去留
任务全部完成后，finishing-a-development-branch技能先验证测试，然后给你四个选项：合并、提 PR、保留分支或丢弃。选定后它负责清理工作树，把环境恢复干净。
收尾阶段的价值在于：它强制回答"这个分支的结局是什么"，避免仓库里积累一堆无人问津的半成品分支。
技能体系速查表：Superpowers 有哪些能力，何时激活
以下是核心技能的完整清单，按"触发时机"理解最直观：
| 技能名 | 作用 | 激活时机 |
|---|---|---|
brainstorming | 提问完善想法、分块展示设计、保存设计文档 | 准备写代码前，自动激活 |
using-git-worktrees | 创建隔离分支工作区，验证干净测试基线 | 设计方案批准后 |
writing-plans | 把工作拆成 2-5 分钟小任务，含路径、代码与验证步骤 | 设计批准后 |
subagent-driven-development | 每个任务派新子代理，做规格合规性→代码质量两阶段评审 | 计划确认后 |
executing-plans | 按批次执行计划，设人工检查点 | 计划确认后（与上者二选一） |
test-driven-development | 强制红-绿-重构循环，先写失败测试再写最小代码 | 实现每个功能时 |
requesting-code-review | 按严重程度报告问题，关键问题阻止推进 | 任务与任务之间 |
finishing-a-development-branch | 验证测试，提供合并/PR/保留/丢弃选项，清理工作树 | 任务全部完成后 |
另有几个按需触发的配套技能，遇到对应场景时会自动介入：
| 场景 | 技能 | 说明 |
|---|---|---|
| 遇到难以定位的 bug | systematic-debugging | 四阶段根因分析流程，附带根因追踪与防御式排查方法 |
| 代理声称"修好了" | verification-before-completion | 要求拿出验证证据，而不是口头声明 |
| 有多个互不依赖的任务 | dispatching-parallel-agents | 并发派发给多个子代理同时处理 |
| 收到评审反馈 | receiving-code-review | 规范地响应和落实反馈意见 |
| 想扩展框架本身 | writing-skills | 按最佳实践编写新技能 |
技能的完整定义可以查看 skills/brainstorming/SKILL.md 这类文件，每个目录下的 SKILL.md 就是该技能的全部行为规范。
适合谁用，以及新手上手的四条建议
适合人群：正在用 Claude Code、Codex、OpenCode 等AI编码代理做实际开发的人；尤其是希望AI代理能长时间自主工作、又不想全程盯着屏幕的新手——Superpowers 恰好把"盯屏幕"的工作分摊给了评审环节。
新手上手的四条建议：
- 从简单项目开始。选一个小型、边界清晰的项目跑完整流程，比一上来做复杂项目更能帮你建立对节奏的感觉。
- 认真回答代理的提问。头脑风暴阶段的问题就是Superpowers为你内置的"需求澄清"，敷衍回答会直接体现在后续计划的质量上。
- 用工作树保持环境隔离。让
using-git-worktrees自动管理分支，你的主干始终干净，随时可以放弃一次失败的尝试。 - 把测试当交付标准。
verification-before-completion的技能逻辑是：没有验证证据，就不算完成。这个标准建议你直接内化到自己的日常开发中。
熟悉基本流程后，再尝试dispatching-parallel-agents这类高级技能，收益会更大。
Superpowers 的本质，是把"好的开发流程"变成AI代理默认的执行方式——装上它，你的AI代理开发就从"看模型心情"变成"看流程办事"。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
