Superpowers使用教程：免费AI编程技能库，让AI代码助手按团队流程交付的完整指南-开发者社区

Superpowers使用教程：免费AI编程技能库，让AI代码助手按团队流程交付的完整指南

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers

把一个任务丢给AI编程助手，它不确认方向就直接开写，来回改几轮，结果还是不对。Superpowers 是一个免费的 AI编程技能库，它给 AI代码助手叠加「头脑风暴→计划→测试→审查」的完整开发流程，让助手先问清楚需求再动手，从源头减少返工。

这个AI编程技能框架解决什么问题

普通 AI代码助手接到任务就直接写代码，方向错了要推倒重来；Superpowers 强制它先澄清需求、再写方案、最后才动手，把"个人习惯"变成"固定流程"。它不替代任何编程工具，而是作为技能层装在 Claude Code、Codex、OpenCode 等十多种主流 AI编程助手之上。无论你是写个人小工具，还是维护一个多人协作的项目，装好之后用法完全一样。

3分钟装好：Claude Code 一条命令接入技能库

推荐从 Claude Code 入手，两条命令即可：

/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace

装完后输入/help，能看到完整的技能命令列表就说明生效了。其他平台的安装都是一句话的事：

平台	安装方式
Codex	把仓库克隆到本地`~/.codex/superpowers`即可使用
OpenCode	克隆仓库后建一个插件符号链接，docs/README.opencode.md 有逐步说明
Cursor / Gemini CLI / Kimi Code 等	在各自工具里执行一行插件安装命令

注意：如果你同时用几个助手，需要在每个工具里各装一次，它们之间不共享。

跟着一项完整任务走一遍：从想法到交付

装好之后你不需要记任何命令，正常用自然语言下任务就行：

我们来做一个命令行待办事项工具

接下来会发生的事，每一步都有对应的技能自动介入：

头脑风暴先于写码。brainstorming 技能会在这句话之后立即触发：助手不写代码，而是反过来问你用途、输出形式、怎样算失败，再把设计拆成一小段一小段给你逐段确认。这一步帮你避免"写了两百行代码才发现方向错了"。
设计批准后开独立工作区。助手自动建新分支和隔离的工作树，并先跑一遍现有测试确认基线是绿的，保证这次改动不会污染主分支。
计划被拆到可执行的粒度。writing-plans 把设计拆成每个 2-5 分钟的小任务，每个任务写清楚涉及哪些文件、怎么验证，标准是"没有任何项目背景的人也能照着做对"。
子代理逐个任务执行。subagent-driven-development 为每个任务派一个全新的子代理，完成后做两阶段审查：先查是否符合计划，再查代码质量。期间 test-driven-development 全程生效——先写一个失败的测试，再写最少的代码让它通过，没写测试就写下的代码会被要求删掉。
出 bug 时自动切换调试模式。systematic-debugging 走四阶段根因分析，定位到根因而不是改表象；verification-before-completion 要求给出证据才算修好，防止"我觉得修好了"式交付。
任务间隙自动审查，收尾时给出选项。requesting-code-review 在任务之间发起审查，关键问题会直接阻塞流程直到修复；全部完成后，finishing-a-development-branch 验证测试、给你合并/提 PR/保留/丢弃的选择，并清理临时工作区。

整个流程里你只说了开头那一句，以及中间几次确认。这也是它和"自己盯着助手改代码"最大的区别：流程是内置的，不是你记性好的时候才执行的。

开始之前要知道的 4 个坑

技能有优先级，不用你手动挑。项目级自定义技能 > 个人技能 > Superpowers 内置技能；多个技能同时适用时，流程类（头脑风暴、调试）先于实现类。规则细节见 skills/using-superpowers/SKILL.md。
跨平台行为有差异。不同助手的工具映射和注入方式不同，比如 OpenCode 会在上下文压缩后重新注入技能说明，Codex 有专门的工具适配参考，具体以对应平台的文档为准。
更新方式很直接。Claude Code 这类插件市场安装的一般自动更新；手动克隆安装的平台，进入目录git pull再重启工具即可。测试方法参考 docs/testing.md。
环境要求不高，但有一处默认行为要留意。Node.js 建议 v18 以上；头脑风暴的可视化伴侣功能默认会回传版本号做匿名统计，介意的话设置环境变量SUPERPOWERS_DISABLE_TELEMETRY即可关闭。