Superpowers快速入门指南：让AI编码代理变成有纪律的开发者
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers是面向AI编码代理的agentic技能框架和软件开发方法论。你只需说出需求，代理会先提问确认设计，再写计划，经你批准后才逐个任务执行TDD。全流程可追踪，结果可验证。
解决的痛点：别再反复重写代理的产出
几乎人人都遇到过这两个场景：你告诉代理"帮我做个登录功能"，它立刻吐出一堆代码，读下来发现方向完全不对，只能推倒重来；或者你让它自主跑几个小时，回来一看，它已经写了一大堆和需求无关的代码。
还有更隐蔽的问题：它写代码不写测试，让它"修个bug"就回一句"已修复"，却拿不出任何证据。
Superpowers把"先问清楚、再计划、后动手"这套纪律做成了技能，代理碰到对应场景会自动触发。代理动手前会先检查相关技能，这是强制流程，不是可选项。
3分钟完成安装：每个平台一条命令加验证方式
用Claude Code的话，先注册插件市场，再安装：
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace其他平台各有各的一条命令，写法都在仓库文档里：docs/README.codex.md讲Codex怎么装，docs/README.opencode.md讲OpenCode怎么装。
验证很简单：在Claude Code里输入 /help，能看到 /superpowers:brainstorm、/superpowers:write-plan、/superpowers:execute-plan 三条新命令，就说明装好了。
一次完整的开发流程：给报表系统加CSV导出
用一个真实任务从头走到尾：给内部报表系统加"导出CSV"功能。
第一步，提问与设计。你只输入一句"我想把报表导出成CSV"。此时代理不动代码，brainstorming 技能生效，它会一个个问：要哪些列、要不要流式导出、分隔符用逗号吗？问完给出两三个带取舍的实现方案，按你能一口气读完的短段落展示，你逐段点头后，设计文档存进 specs/ 目录。
第二步，隔离工作区。设计批准后，using-git-worktrees 技能在新分支上建隔离工作树，先跑一遍现有测试确认基线是绿的。这样后面出现失败时，能分清是新问题还是本来就坏的。
第三步，拆计划。writing-plans 把设计拆成一份任务清单，每个任务只花2到5分钟，任务里写死了具体文件路径、完整代码和验证方法，交给一个"热情但没判断力"的初级工程师也能照做。
第四步，执行。你说"开始"后，subagent-driven-development 给每个任务派一个全新子代理，每个任务过两阶段评审：先查规格合规，再看代码质量，遇到关键问题就停下不推进。
第五步，写码。实现过程受 test-driven-development 约束：先写一个失败的测试，亲眼看它失败，再写最少代码让它变绿，然后提交。测试之前写的代码会被要求删掉重来。
第六步，收尾。全部完成后，finishing-a-development-branch 跑测试做最终验证，给你合并、开PR、保留或丢弃四个选项，顺手把工作树清理掉。
整个过程你不用记流程，技能到点自动触发。
核心技能速查表
| 技能名 | 触发时机 | 作用 |
|---|---|---|
| brainstorming | 任何创造性工作开始前 | 逐个提问把想法收敛成设计文档，未获批准不碰代码 |
| using-git-worktrees | 设计批准后 | 新分支建隔离工作树，验证测试基线 |
| writing-plans | 设计定稿后 | 拆成2-5分钟的小任务，每个任务带路径、代码和验证方法 |
| subagent-driven-development | 计划就绪后 | 每任务一个子代理，两阶段评审（规格合规+代码质量） |
| executing-plans | 替代上者的选项 | 按批次执行并设人工检查点，适合想多盯一点的场景 |
| test-driven-development | 实现过程中 | 强制红-绿-重构循环，测试前写的代码删掉重来 |
| requesting-code-review | 任务之间 | 对照计划按严重程度报问题，关键问题阻断进度 |
| systematic-debugging | 遇到疑难问题 | 四阶段追根因，而不是碰运气打补丁 |
| verification-before-completion | 宣布"完成"之前 | 要求拿出证据，证明问题真的修好了 |
| finishing-a-development-branch | 全部任务完成后 | 验证测试、处理合并/PR/丢弃、清理工作树 |
| writing-skills | 你想加自己的技能时 | 按最佳实践创建并测试新技能 |
新手上手指南：第一次用的5条建议
- 先跑一个小而明确的完整任务—— 熟悉"提问→计划→执行"的节奏，比赶进度更重要。
- 认真回答代理的提问，少说"你看着办"—— 设计文档的质量直接由你回答的精度决定。
- 评审报出关键问题时别硬推—— 流程在这里刻意停住，此刻修问题的成本远低于合并后。
- 再赶时间也别跳过TDD—— 红绿循环是产出可追溯的主要原因，跳过等于白装。
- 先读一遍 using-superpowers 的介绍—— 它是整个技能体系的入口，省得自己摸索。
想动手就先git clone https://gitcode.com/GitHub_Trending/su/superpowers把仓库拉下来，让代理读 README.md 和 skills/ 目录，技能都是直白的文字写的，读源码本身也是一手资料。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
