超级能力(Superpowers)
超级能力是一套完整的软件开发方法论,专为你的编码代理(coding agents)设计,构建于一组可组合的技能(composable skills)之上,并辅以一些初始指令,确保你的代理能够正确使用它们。
快速开始
为你的编码代理赋予超级能力:Claude Code、Codex CLI、Codex App、Factory Droid、Gemini CLI、OpenCode、Cursor、GitHub Copilot CLI。
工作原理
这一切从你启动编码代理的那一刻开始。一旦它发现你在构建某个项目,它不会直接跳入编写代码的环节。相反,它会退一步,询问你真正想要实现的目标。
当它从对话中梳理出一份规格说明(spec)后,会将其分成足够短小的片段展示给你,让你能够真正阅读和理解。在你确认设计后,你的代理会制定一份实现计划,这份计划清晰到足以让一位热情但品味不佳、缺乏判断力、没有项目背景、且厌恶测试的初级工程师也能遵循。它强调真正的红/绿 TDD(测试驱动开发)、YAGNI(你不会需要它)和 DRY(不要重复自己)。
接下来,一旦你说“开始”,它会启动一个子代理驱动开发(subagent-driven-development)流程,让代理们逐一处理每个工程任务,检查并评审它们的工作,然后继续推进。Claude 能够自主工作数小时而不偏离你共同制定的计划,这并不罕见。
当然,还有更多细节,但以上是系统的核心。而且由于这些技能会自动触发,你无需做任何特殊操作。你的编码代理天生就拥有“超级能力”。
赞助
如果超级能力帮助你创造了收入,并且你愿意的话,我将非常感谢你考虑赞助我的开源工作。谢谢! —— Jesse
安装
安装方式因不同的运行环境(harness)而异。如果你使用多个环境,请为每个环境分别安装超级能力。
Claude Code
超级能力可通过官方的 Claude 插件市场获取。
官方市场 从 Anthropic 的官方市场安装插件: /plugin install superpowers@claude-plugins-official
超级能力市场 超级能力市场为 Claude Code 提供超级能力及其他相关插件。 注册市场: /plugin marketplace add obra/superpowers-marketplace 从该市场安装插件: /plugin install superpowers@superpowers-marketplace
Codex CLI
超级能力可通过官方的 Codex 插件市场获取。 打开插件搜索界面: /plugins 搜索超级能力: superpowers 选择“安装插件”(Install Plugin)。
Codex App
超级能力可通过官方的 Codex 插件市场获取。 在 Codex 应用中,点击侧边栏的“插件”(Plugins)。你应该会在“编码”(Coding)部分看到超级能力。点击超级能力旁边的 + 并按照提示操作。
Factory Droid
注册市场: droid plugin marketplace add https://github.com/obra/superpowers 安装插件: droid plugin install superpowers@superpowers
Gemini CLI
安装扩展: gemini extensions install https://github.com/obra/superpowers 后续更新: gemini extensions update superpowers
OpenCode
OpenCode 使用其自身的插件安装方式;即使你在其他环境中已安装,也需单独为 OpenCode 安装超级能力。 告知 OpenCode: Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md 详细文档:docs/README.opencode.md
Cursor
在 Cursor Agent 聊天中,从市场安装: /add-plugin superpowers 或者在插件市场中搜索“superpowers”。
GitHub Copilot CLI
注册市场: copilot plugin marketplace add obra/superpowers-marketplace 安装插件: copilot plugin install superpowers@superpowers-marketplace
基本工作流程
- brainstorming(头脑风暴) - 在编写代码前激活。通过提问完善粗略想法,探索替代方案,分部分展示设计以供验证。保存设计文档。
- using-git-worktrees(使用 Git 工作树) - 在设计批准后激活。在新分支上创建隔离的工作空间,运行项目设置,验证干净的测试基线。
- writing-plans(编写计划) - 在设计批准后激活。将工作分解为小任务(每个 2-5 分钟)。每个任务包含精确的文件路径、完整代码和验证步骤。
- subagent-driven-development(子代理驱动开发)或 executing-plans(执行计划) - 在计划就绪后激活。为每个任务分派一个全新的子代理,进行两阶段审查(先检查规格符合性,再检查代码质量),或者批量执行并设置人工检查点。
- test-driven-development(测试驱动开发) - 在实现过程中激活。强制执行红-绿-重构(RED-GREEN-REFACTOR)循环:编写会失败的测试,观察其失败,编写最简代码,观察其通过,然后提交。删除在测试之前编写的代码。
- requesting-code-review(请求代码审查) - 在任务之间激活。对照计划进行审查,按严重程度报告问题。关键问题会阻止后续进度。
- finishing-a-development-branch(完成开发分支) - 在任务完成时激活。验证测试,提供选项(合并/PR/保留/丢弃),清理工作树。
代理在任何任务之前都会检查相关技能。这些是强制性工作流程,而非建议。
内部构成
技能库
测试
- test-driven-development - 红-绿-重构循环(包含测试反模式参考)
调试
- systematic-debugging - 四阶段根因分析流程(包含根因追踪、纵深防御、基于条件的等待技术)
- verification-before-completion - 确保问题真正修复
协作
- brainstorming - 苏格拉底式设计完善
- writing-plans - 详细的实现计划
- executing-plans - 带检查点的批量执行
- dispatching-parallel-agents - 并发子代理工作流
- requesting-code-review - 审查前检查清单
- receiving-code-review - 回应反馈
- using-git-worktrees - 并行开发分支
- finishing-a-development-branch - 合并/PR 决策工作流
- subagent-driven-development - 带两阶段审查(先检查规格符合性,再检查代码质量)的快速迭代
元技能
- writing-skills - 遵循最佳实践创建新技能(包含测试方法论)
- using-superpowers - 技能系统介绍
Phi