Superpowers-CC 使用教程

📖 项目简介

Superpowers 是由 Jesse Vincent（@obra，Keyboardio 创始人）发起的开源「AI 编程方法论框架」，MIT 协议完全免费。它在 GitHub 上已经狂揽 26 万+ Star、2.3 万 Fork，是当前最主流的 Agent 技能（Skills）框架，没有之一——2026 年 2 月它还只有 5.7 万星，半年翻了四倍多。

它的核心思路是「方法论即代码」：把资深工程师的完整开发流程写成十几个可组合的 Markdown 技能，装进 AI 编程工具后自动触发。AI 不再拿到需求就闷头写码，而是强制走完一套流程：头脑风暴澄清需求 → 写实现计划拆任务 → 派子代理分头执行 → 测试驱动开发（先写会失败的测试，RED→GREEN→REFACTOR）→ 自动代码审查，审查通过才允许合并。

对 Claude Code 用户来说，它已经进入 Claude 官方插件市场，一条命令就能装上；同时它是跨平台的——Codex、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode 等主流 AI 编程工具全部支持。一次学会，到处能用。它解决的就是 AI 编程最大的痛点：瞎写代码、不写测试、改一处坏三处。

📎 相关链接与下载地址（点击展开）

GitHub 项目： github.com/obra/superpowers
插件市场（Claude Code 相关插件合集）： github.com/obra/superpowers-marketplace
官方插件页： claude.com/plugins/superpowers
更多教程：关注公众号 / 抖音 / 视频号「IT小圈」

✨ 核心亮点

🧠

先想再做

写码前强制头脑风暴 + 实现计划，需求问清楚才动手，从源头杜绝瞎写

🧪

测试驱动开发

没有失败的测试就不许写实现，RED→GREEN→REFACTOR 循环强制执行

🛡️

自动审查改bug

代码写完自动做代码审查，内置 Spec 自审清单，约 30 秒揪出 4-5 个问题

🤖

子代理并行干活

计划拆成小任务后，每个任务派独立子代理执行，长任务不跑偏不丢上下文

🧩 它能做什么、输出什么

项目	说明
本质	一套可组合的 Markdown 技能（Skills）+ 初始指令，装进 AI 编程工具后自动触发，不用背命令
覆盖流程	头脑风暴 → 写实现计划 → 拆任务执行 → 派发子代理 → TDD 测试驱动 → 代码审查 → 分支收尾，完整软件开发生命周期
产出	设计文档、实现计划、测试用例、通过审查的代码、干净的 Git 分支
支持的工具	Claude Code（官方插件市场）、Codex CLI/App、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode、Factory Droid 等 10 个主流工具
体量 / 版本	26 万+ Star、2.3 万 Fork；最新版 v6.1.1（2026-07），几乎每周都有更新

🖥️ 环境要求

环境	建议配置
操作系统	Windows / macOS / Linux 均可（技能本身是 Markdown + 脚本，无平台限制）
前置工具	已装好 Claude Code（或 Codex / Cursor 等任一支持的 AI 编程工具）并能正常对话
硬件	无任何 GPU/显存要求——它不跑模型，只给你的 AI 工具「装脑子」
其他依赖	Git（子代理与分支流程会用到 worktree）；无需 Python / 无需数据库
费用	框架本身 MIT 免费；消耗的是你 AI 工具自己的额度

🚀 如何使用

💡

最省事路径：Claude Code 里敲一条 /plugin install 命令装上，之后什么都不用管——技能会在你提需求时自动触发。

前置：装好 Claude Code

确保 Claude Code 已安装并能正常对话（终端里能跑 claude）。已经在用的直接跳到第 2 步。

                        bash
                        npm install -g @anthropic-ai/claude-code
claude --version
                    

一条命令装上 Superpowers

它已经进了 Claude 官方插件市场，在 Claude Code 对话框里直接敲：

                        Claude Code
                        /plugin install superpowers@claude-plugins-official
                    

如果想装作者维护的插件合集（含 Superpowers 及周边插件），也可以先添加市场再装：

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

基础用法：直接提需求，技能自动触发

装完重启会话就生效。你只管像平常一样说需求，比如「帮我做一个待办清单应用」，它会先进入头脑风暴——用苏格拉底式提问把边界情况、数据存储、验收标准问清楚，确认后生成设计文档，然后才开始动手。

常用技能/命令一览：

技能 / 命令	作用
`/brainstorm`	头脑风暴澄清需求，产出设计文档（写码前必经）
`/write-plan`	把需求拆成一个个小任务的实现计划，精确到文件
`executing-plans`	按计划分批执行，带检查点，不跑偏
`test-driven-development`	强制 TDD：先写失败测试（RED），再写实现（GREEN），最后重构
`requesting-code-review`	写完自动做代码审查，通过才允许合并

进阶：子代理并行 + Git worktree 隔离

大任务用「子代理驱动开发」：实现计划里的每个小任务派一个全新的子代理去干，配合 Git worktree 把每条改动隔离在独立分支，互不污染。长达数小时的自主开发任务也不会上下文漂移。

                        Claude Code
                        # 对话里直接说即可，例如：
# 「用 subagent-driven-development 执行这份计划，每个任务开独立 worktree」
                    

不止 Claude Code：Codex、Cursor 也能装

同一套技能跨平台通用：Codex 在其插件市场直接安装；Cursor 里用 /add-plugin superpowers；Gemini CLI、GitHub Copilot CLI、OpenCode 也都有官方安装入口（见折叠链接里的项目主页 README）。

✅

装完的效果：AI 从「拿到需求就闷头写码」变成「先想清楚、测试先行、自审后交付」，像雇了个流程严格的资深工程师。

🎯 典型应用场景

🚀

从零起新项目

头脑风暴把需求问透，设计文档 + 实现计划一步到位再动工

🐛

修祖传老bug

先写复现 bug 的失败测试，修完测试变绿，永不复发

🏗️

大型重构

拆成小任务派子代理分头干，worktree 隔离，改一半不怕崩

🌙

长时间自主开发

挂机数小时的任务不跑偏：计划检查点 + 子代理防上下文漂移

👥

团队规范统一

把团队的开发规范写成技能，每个人的 AI 都按同一套流程干活

🎓

新手学最佳实践

跟着它的流程走一遍，等于资深工程师手把手带你做项目

📈 项目热度与实际收益

指标	表现
GitHub 热度	26 万+ Star、2.3 万 Fork（2026-07）；2 月还是 5.7 万星，半年翻 4 倍多，agent 技能框架领域断层第一
自审效率	内置 Spec Self-Review 清单，约 30 秒揪出 4-5 个规格问题，在写码前就拦截
执行提速	v5 系列把子代理审查循环改为内联自审后，典型任务执行时间缩短约 25 分钟
更新频率	最新 v6.1.1（2026-07-02），仓库几乎每周有推送，40+ 贡献者活跃维护

🧠

原理一句话：它不改模型、不耗算力，只是把「资深工程师的工作流程」变成 AI 每次干活前必须遵守的规则——先想、先测、后写、必审，质量自然就上来了。

❓ 常见问题

Q: 它和我自己写提示词/规则文件有什么区别？

提示词是「建议」，Superpowers 是「流程」。它的技能会在对应环节自动触发并强制执行——比如没有失败的测试就不写实现代码，这是提示词很难稳定约束住的。而且 26 万星社区在持续打磨这套流程，比自己维护一份规则省心得多。

Q: 支持哪些 AI 编程工具？

Claude Code（官方插件市场直装）、Codex CLI/App、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode、Factory Droid、Kimi Code 等 10 个主流工具，安装方式见项目 README（各工具一条命令）。

Q: 装完没反应/技能没触发怎么办？

先重启 Claude Code 会话（技能在会话启动时注入）；再用 /plugin 确认插件已启用；仍不行就检查版本是否过旧，升级 Claude Code 后重装插件。

Q: 对电脑配置有要求吗？会多花钱吗？

没有任何硬件要求，它不跑模型。框架免费，但「先想再做 + 测试先行」的流程会比裸写多消耗一些对话额度——换来的是返工大幅减少，总账通常更省。

Q: 小需求也要走完整流程吗？太重了怎么办？

不用。技能是按需触发的，改一行文案这类小事不会强制走头脑风暴；你也可以在对话里明确说「跳过 brainstorm 直接改」。大需求才建议走全流程。

Q: 我在用 Codex，能用它吗？

能。Codex 有官方插件市场入口，装上后同一套技能照常触发；我们之前也专门介绍过 Codex + Superpowers 的组合，工作流完全一致。

Q: 它是 Anthropic 官方出品吗？

不是。它是 Jesse Vincent（@obra）发起的社区开源项目，但已被收录进 Claude 官方插件市场，是事实上的主流标准；MIT 协议，代码完全公开。

Q: 可以商用吗？

可以。MIT 协议，个人和商业项目都能自由使用、修改、分发，无需授权费；注意你产出代码的合规性由你自己的项目决定，与框架无关。