An agentic skills framework & software development methodology that works.
💡 Use Cases
最适合需要结构化开发流程、确保代码质量和降低复杂任务实施风险的AI辅助编程场景。
复杂项目需求梳理
Problem: 开发者有一个模糊的想法,但不知道如何拆解成具体的实现方案,直接写代码容易偏离目标。
Solution: 使用项目的brainstorming技能,通过对话逐步澄清需求,生成分块的设计文档供开发者审阅确认。
Example: 想开发一个任务管理应用但不确定功能边界,Superpowers会询问具体需求(是否需要协作、通知等),然后生成模块化设计方案供确认。
大型重构任务规划
Problem: 需要重构一个复杂模块,但担心遗漏依赖关系或破坏现有功能,手动规划耗时且容易出错。
Solution: 项目自动创建git worktree隔离环境,生成详细的实施计划,将重构分解为2-5分钟的小任务,每个任务都有明确的验证步骤。
Example: 重构用户认证系统时,Superpowers会创建独立分支,规划出“提取接口→迁移登录逻辑→更新依赖→测试验证”等具体任务序列。
确保代码质量与测试
Problem: 开发时容易跳过测试或写出过度设计的代码,导致技术债务积累。
Solution: 强制执行TDD流程:先写失败测试→写最小实现→重构,自动删除没有测试的代码,遵循YAGNI和DRY原则。
Example: 添加新API端点时,系统会强制先写测试用例,验证失败后才允许实现功能代码,避免未测试的代码进入代码库。
并行开发任务管理
Problem: 同时处理多个功能开发时,上下文切换成本高,容易忘记任务进度和依赖关系。
Solution: 使用subagent-driven-development,为每个任务分配独立子代理执行,自动进行两阶段代码审查(规范符合性→代码质量)。
Example: 同时开发用户注册和支付功能,系统会为每个功能创建独立执行代理,自动检查代码是否符合设计规范和质量标准。
📊 Project Info
- Language
- Shell
- Stars
- ⭐ 26,020
- Forks
- 1,936
- Today
- +1,961
- Ranking
- #1
- Collection
- Overall
- Trending Date
- January 16, 2026
🏷️ Topics
5分钟上手 Superpowers:为AI编程助手赋能
本指南将帮助你在Claude Code中快速安装Superpowers插件,并体验AI驱动的结构化开发工作流。
🖥️ OS
🔧 Tools
📝 Steps
注册插件市场
在Claude Code中打开终端,注册Superpowers插件市场
注册Superpowers插件市场源
$ claude plugins marketplace register https://raw.githubusercontent.com/obra/superpowers/main/marketplace.json安装Superpowers插件
从刚注册的市场中安装Superpowers插件
安装Superpowers插件
$ claude plugins install superpowers验证安装
检查Superpowers技能是否已成功加载
列出已安装的插件
$ claude plugins list查看可用的技能列表
$ claude skills list开始第一个项目
启动一个简单的编码任务,触发Superpowers工作流
✅ 验证成功
确认Superpowers已正确安装并开始工作
- ✓AI助手在开始编码前先询问详细需求
- ✓看到设计规格文档被生成和展示
- ✓AI助手制定详细的实施计划
- ✓技能列表中出现Superpowers相关技能
⚡ Quick Tips
🔍 Troubleshooting
❓ 插件市场注册失败
→ 检查网络连接,确保URL正确:https://raw.githubusercontent.com/obra/superpowers/main/marketplace.json
❓ 安装后看不到Superpowers技能
→ 重启Claude Code,或运行'claude plugins reload'重新加载插件
❓ AI助手没有触发brainstorming流程
→ 确保你的请求是开发任务(如'创建一个...'),而不是简单的代码片段请求
🎯 Next Steps
查看详细文档
访问项目GitHub页面了解更多高级功能和配置选项
尝试完整工作流
让AI助手完成一个完整的小项目,体验从设计到代码审查的全过程
探索其他技能
试用test-driven-development、systematic-debugging等高级技能
Difficulty
初级
Est. Time
2-3小时
Target Audience
希望利用AI编程助手(如Claude Code)进行更结构化、高质量软件开发的开发者,尤其是对AI辅助编程感兴趣但缺乏系统化工作流经验的新手。
🎯 What You'll Learn
学会如何为你的AI编程助手安装并配置Superpowers,理解其核心工作流,并能够利用它引导AI完成从需求澄清、设计、计划到自动化实施和审查的完整软件开发过程。
📋 Prerequisites
项目本身是Shell脚本,安装和部分配置需要在终端中操作。
项目工作流中会使用Git进行分支管理和代码提交。
Superpowers是一个运行在AI编程助手之上的工作流系统,你需要至少拥有其中一个助手的使用经验。
📚 Resources
项目README
最核心的文档,包含了概述、工作原理、安装指南、基础工作流和技能库介绍。
docs/ 目录下的平台专属文档
针对Codex或OpenCode的详细安装、配置和使用说明。
GitHub Issues 和 Discussions
查看其他用户遇到的问题、使用技巧以及未来的开发计划。
🗺️ Learning Phases
环境准备与安装
选择并确认你的AI编程助手
根据README,确认你使用的是Claude Code、Codex还是OpenCode。这将决定你的安装方式。
按照对应平台指南安装
根据你选择的助手,严格遵循README中的安装步骤。例如,对于Claude Code,需要先注册插件市场,然后安装Superpowers插件。
查阅详细文档
如果你的助手是Codex或OpenCode,前往项目docs目录下阅读对应的详细文档(README.codex.md或README.opencode.md)。
快速入门:体验核心工作流
启动一个简单的编码任务
在你的AI编程助手中,提出一个明确的、小型的编码需求(例如:“帮我写一个Python函数,计算斐波那契数列”)。
观察并参与“brainstorming”阶段
注意AI助手不会立即写代码,而是会开始提问以澄清需求。积极回答这些问题,帮助它生成一个清晰的设计规格。
批准设计并观察“writing-plans”
在AI展示设计规格并征得你同意后,观察它如何将任务分解成详细的、分步的实施计划。
下达“go”指令,观察自动化执行
同意计划后,告诉AI“go”。观察它如何自动创建Git工作区、按计划执行任务、进行测试和代码审查。
理解与探索核心技能
浏览“The Basic Workflow”列表
回到README,仔细阅读从“brainstorming”到“finishing-a-development-branch”的每个技能描述。
探索“Skills Library”
了解除了基础工作流外,项目还提供了哪些可组合的技能,如“systematic-debugging”、“dispatching-parallel-agents”等。
进行一次包含调试的完整练习
启动一个故意包含一个小bug的编码任务(例如:“写一个函数处理用户输入,但假设输入可能格式错误”)。
⚠️ Common Mistakes
❌ 在需求澄清(brainstorming)阶段提供过于简单或模糊的指令
✅ 即使任务简单,也尽量像与真人同事沟通一样描述背景、边界条件和期望。这能帮助Superpowers生成更精准的设计和计划。
❌ 不仔细阅读AI生成的设计规格和计划就直接批准
✅ Superpowers会将设计分块展示以便阅读。花几分钟时间确认计划符合你的预期,特别是任务分解和验证步骤,这是保证后续自动化执行不偏离方向的关键。
❌ 在AI自动化执行期间频繁打断或给出新指令
✅ 信任工作流。在子代理开发阶段,AI会按照既定计划工作并进行自我审查。频繁打断可能会破坏其上下文和状态。如有必要,可在计划中设置的检查点进行干预。
❌ 忽略安装验证步骤,导致技能未正确加载
✅ 安装后务必执行README中的验证命令,确保Superpowers的技能命令已成功注册到你的AI助手,否则整个工作流无法触发。
🚀 Next Steps
尝试将Superpowers应用于你真实的小型项目;探索如何组合使用不同的技能(如并行调度+代码审查)来处理更复杂的工程任务;关注项目更新,了解新技能的加入;如果你有特定需求,可以研究其可组合技能的设计思路,思考如何定制或扩展自己的工作流。