Claude Code 超级能力:核心技能库
Superpowers 是一个为AI编程助手(如Claude Code)构建的完整软件开发工作流系统。其核心在于一套可组合的“技能”库和预设指令,旨在引导AI助手更系统、更专业地参与开发过程。当用户启动编码任务时,助手不会立即开始写代码,而是先与用户沟通以明确真实需求,并生成易于理解的设计规格。在获得用户确认后,系统会制定一个清晰的实施计划,该计划强调测试驱动开发、避免过度设计等工程最佳实践。随后,系统能启动一个由子代理驱动的开发流程,自动执行各项工程任务,并进行代码审查,使得AI助手能够按照既定计划自主工作数小时而不偏离方向。该项目通过自动化触发这些核心技能,显著提升了AI编程助手的结构化协作能力和产出质量,适用于希望利用AI进行更可靠、更系统化软件开发的团队或个人开发者。
💡 应用场景
最适合需要结构化开发流程、确保代码质量和降低复杂任务实施风险的AI辅助编程场景。
复杂项目需求梳理
问题:开发者有一个模糊的想法,但不知道如何拆解成具体的实现方案,直接写代码容易偏离目标。
方案:使用项目的brainstorming技能,通过对话逐步澄清需求,生成分块的设计文档供开发者审阅确认。
示例:想开发一个任务管理应用但不确定功能边界,Superpowers会询问具体需求(是否需要协作、通知等),然后生成模块化设计方案供确认。
大型重构任务规划
问题:需要重构一个复杂模块,但担心遗漏依赖关系或破坏现有功能,手动规划耗时且容易出错。
方案:项目自动创建git worktree隔离环境,生成详细的实施计划,将重构分解为2-5分钟的小任务,每个任务都有明确的验证步骤。
示例:重构用户认证系统时,Superpowers会创建独立分支,规划出“提取接口→迁移登录逻辑→更新依赖→测试验证”等具体任务序列。
确保代码质量与测试
问题:开发时容易跳过测试或写出过度设计的代码,导致技术债务积累。
方案:强制执行TDD流程:先写失败测试→写最小实现→重构,自动删除没有测试的代码,遵循YAGNI和DRY原则。
示例:添加新API端点时,系统会强制先写测试用例,验证失败后才允许实现功能代码,避免未测试的代码进入代码库。
并行开发任务管理
问题:同时处理多个功能开发时,上下文切换成本高,容易忘记任务进度和依赖关系。
方案:使用subagent-driven-development,为每个任务分配独立子代理执行,自动进行两阶段代码审查(规范符合性→代码质量)。
示例:同时开发用户注册和支付功能,系统会为每个功能创建独立执行代理,自动检查代码是否符合设计规范和质量标准。
📊 项目信息
- 语言
- Shell
- Stars
- ⭐ 55,352
- Forks
- 4,189
- 今日新增
- +889
- 排名
- #1
- 收录
- 总榜
- 趋势日期
- 2026年2月19日
- 最后推送
- 2026/2/19
🏷️ 标签
5分钟上手 Superpowers:为AI编程助手赋能
本指南将帮助你在Claude Code中快速安装Superpowers插件,并体验AI驱动的结构化开发工作流。
🖥️ 操作系统
🔧 工具
📝 操作步骤
注册插件市场
在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相关技能
⚡ 快速提示
🔍 常见问题排查
❓ 插件市场注册失败
→ 检查网络连接,确保URL正确:https://raw.githubusercontent.com/obra/superpowers/main/marketplace.json
❓ 安装后看不到Superpowers技能
→ 重启Claude Code,或运行'claude plugins reload'重新加载插件
❓ AI助手没有触发brainstorming流程
→ 确保你的请求是开发任务(如'创建一个...'),而不是简单的代码片段请求
🎯 下一步
查看详细文档
访问项目GitHub页面了解更多高级功能和配置选项
尝试完整工作流
让AI助手完成一个完整的小项目,体验从设计到代码审查的全过程
探索其他技能
试用test-driven-development、systematic-debugging等高级技能
难度
初级
预计时间
2-3小时
目标人群
希望利用AI编程助手(如Claude Code)进行更结构化、高质量软件开发的开发者,尤其是对AI辅助编程感兴趣但缺乏系统化工作流经验的新手。
🎯 学完你将掌握
学会如何为你的AI编程助手安装并配置Superpowers,理解其核心工作流,并能够利用它引导AI完成从需求澄清、设计、计划到自动化实施和审查的完整软件开发过程。
📋 前置知识
项目本身是Shell脚本,安装和部分配置需要在终端中操作。
项目工作流中会使用Git进行分支管理和代码提交。
Superpowers是一个运行在AI编程助手之上的工作流系统,你需要至少拥有其中一个助手的使用经验。
📚 学习资源
项目README
最核心的文档,包含了概述、工作原理、安装指南、基础工作流和技能库介绍。
docs/ 目录下的平台专属文档
针对Codex或OpenCode的详细安装、配置和使用说明。
GitHub Issues 和 Discussions
查看其他用户遇到的问题、使用技巧以及未来的开发计划。
🗺️ 学习阶段
环境准备与安装
选择并确认你的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的编码任务(例如:“写一个函数处理用户输入,但假设输入可能格式错误”)。
⚠️ 常见错误
❌ 在需求澄清(brainstorming)阶段提供过于简单或模糊的指令
✅ 即使任务简单,也尽量像与真人同事沟通一样描述背景、边界条件和期望。这能帮助Superpowers生成更精准的设计和计划。
❌ 不仔细阅读AI生成的设计规格和计划就直接批准
✅ Superpowers会将设计分块展示以便阅读。花几分钟时间确认计划符合你的预期,特别是任务分解和验证步骤,这是保证后续自动化执行不偏离方向的关键。
❌ 在AI自动化执行期间频繁打断或给出新指令
✅ 信任工作流。在子代理开发阶段,AI会按照既定计划工作并进行自我审查。频繁打断可能会破坏其上下文和状态。如有必要,可在计划中设置的检查点进行干预。
❌ 忽略安装验证步骤,导致技能未正确加载
✅ 安装后务必执行README中的验证命令,确保Superpowers的技能命令已成功注册到你的AI助手,否则整个工作流无法触发。
🚀 后续方向
尝试将Superpowers应用于你真实的小型项目;探索如何组合使用不同的技能(如并行调度+代码审查)来处理更复杂的工程任务;关注项目更新,了解新技能的加入;如果你有特定需求,可以研究其可组合技能的设计思路,思考如何定制或扩展自己的工作流。