Superpowers 使用教程：3 步让 AI 编程助手按 TDD 流程自主开发
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一个面向 AI 编程助手的软件开发方法论框架：它让 Claude Code、Codex、Gemini CLI 等编码代理在动手写代码之前，先完成需求澄清、设计评审和任务拆解，再通过测试驱动开发（TDD）与自动代码审查推进实现。整个过程由技能（skills）自动触发，你不需要额外敲任何"流程命令"。
为什么 AI 编程助手需要一层"流程约束"
用过编码代理的人大概都有过这样的体验：你刚提完一个模糊的想法，它就径直开始写代码；没有和你确认边界条件，测试要么缺失要么走过场，最后还自信地宣称"已完成"。这类问题不是模型能力不够，而是缺少一层强制性的工程流程。
Superpowers 解决的就是这个问题。它把资深团队默认遵循的做法——先设计后编码、小步任务、红绿重构、按严重度审查——固化成一组可被代理自动调用的技能，而不是指望你每次手动提醒它。
核心机制：技能在会话开始时自动加载
Superpowers 的安装本质上包含两部分：
- 技能库：
skills/目录下 14 个开箱即用的技能，覆盖设计、计划、TDD、调试、审查等场景； - 启动引导：会话启动时通过
hooks/session-start钩子注入using-superpowers这个引导技能，它要求代理在任何响应之前先检查是否有技能适用于当前任务。
也就是说，技能不是"可选建议"，而是代理执行任务前必须走的检查项。当多个技能同时适用时，处理流程类技能（如 brainstorming、systematic-debugging）优先于实现类技能；技能加载顺序遵循"项目技能 > 个人技能 > Superpowers 内置技能"的优先级。
Superpowers 安装：3 条命令接入 Claude Code
以最常用的 Claude Code 为例，整个过程只需两条斜杠命令：
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace第一条把 Superpowers 的插件市场注册进来，第二条从该市场安装插件本体。装完后重启会话即可。
其他平台（Codex CLI、Cursor、Gemini CLI、OpenCode、Kimi Code 等）的安装方式各不相同，README 的 Quickstart 一节给出了每个平台的对应命令；各平台之间相互独立，用几个平台就装几份。如果某个平台只能通过克隆仓库的方式接入，仓库地址为：
git clone https://gitcode.com/GitHub_Trending/su/superpowers克隆后按照该平台的插件目录规范放置即可，OpenCode 平台的完整说明可参考 docs/README.opencode.md。
如何确认 Superpowers 已生效
安装后建议做一次验收测试，这也是项目自身为平台集成规定的通过标准：
- 开启一个干净会话，对助手输入一句话，例如"Let's make a react todo list"；
- 正常生效的 Superpowers 会让代理先触发 brainstorming 技能，开始追问你要解决什么问题，而不是直接开始写代码；
- 也可以直接问助手"Tell me about your superpowers"，它应当能列出当前可用的技能。
如果代理跳过了提问直接写代码，说明引导没有加载，先检查该平台的插件是否正确安装、会话是否已重启。仓库的tests/目录里还有一组现成的测试脚本（如tests/explicit-skill-requests/），可以用来手动模拟各种技能触发场景。
内置工作流：从想法到合并分支的 7 个阶段
安装完成后，一个典型的开发周期会按以下顺序自动流转：
| 阶段 | 技能 | 做什么 |
|---|---|---|
| 1 | brainstorming | 用苏格拉底式提问打磨模糊想法，分段展示设计供你确认，最后落一份设计文档 |
| 2 | using-git-worktrees | 在新分支上建立隔离工作区，运行项目初始化并确认测试基线是干净的 |
| 3 | writing-plans | 把工作拆成 2–5 分钟一个的任务，每个任务写明文件路径、完整代码和验证步骤 |
| 4 | subagent-driven-development 或 executing-plans | 每个任务派发一个全新子代理执行，先查规范符合性、再查代码质量；或按批次执行并设人工检查点 |
| 5 | test-driven-development | 严格执行 RED-GREEN-REFACTOR：先写失败测试、看着它失败、再写最小实现；测试之前写的代码会被直接删掉 |
| 6 | requesting-code-review | 任务之间按计划对照审查，问题按严重度报告，关键问题会阻塞后续进展 |
| 7 | finishing-a-development-branch | 验证全部测试通过后，给出合并/提 PR/保留/丢弃的选项并清理工作区 |
值得注意的是第 4 阶段：由于计划和测试纪律都已被前序阶段固化，代理经常能自主连续工作一两小时而不出轨。
技能库速览：按场景找对应技能
除工作流主线外，skills/下还有几类值得知道的存在：
- 调试：systematic-debugging（四阶段根因分析，附带根因追踪与防御式排查参考）、verification-before-completion（宣称修复前必须先验证）；
- 协作：dispatching-parallel-agents（并发子代理）、receiving-code-review（如何回应审查意见）、executing-plans（带检查点的批量执行）；
- 元能力：writing-skills（按最佳实践创建新技能）、using-superpowers（技能系统的入门引导）。
每个技能都是一个独立目录，入口为SKILL.md，比如 skills/test-driven-development/ 和 skills/systematic-debugging/，想深入了解某个流程可以直接读源码。
进阶：自定义、更新与隐私开关
- 写自己的技能：Superpowers 把"如何写好一个技能"本身也做成了技能，
skills/writing-skills/里附带测试方法论和反模式参考，你可以按同样标准沉淀团队自己的流程； - 更新：克隆安装的仓库直接
git pull后重启平台即可；走插件市场的安装则由各平台按自身机制更新； - 新平台移植：如果你要把 Superpowers 接到一个新代理环境，docs/porting-to-a-new-harness.md 描述了引导加载的关键点——没有 session-start 引导，技能就只是躺在磁盘上的死文件；
- 遥测：brainstorming 的可视化伴侣功能默认会从官网加载一个标识图片，其中仅包含 Superpowers 版本号，不含任何项目内容。介意的话设置环境变量
SUPERPOWERS_DISABLE_TELEMETRY为任意真值即可关闭，它同时也兼容 Claude Code 的DISABLE_TELEMETRY开关。
整个框架背后的理念可以概括为四点：测试先行、流程优于临时发挥、持续降低复杂度、用证据而非口嗨来宣布成功。它不改变你使用的代理，只是给代理套上了一套经过反复调校的工作纪律——装完之后，你负责的是确认设计，剩下的流程会自己跑起来。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
