版本6.1.1 许可证MIT 作者Jesse Vincent 与 Prime Radiant 团队 官方仓库GitHub - obra/superpowers: An agentic skills framework software development methodology that works. · GitHub一、这是什么Superpowers超能力是一套面向编码智能体Coding Agent的完整软件开发方法论。它不是一个库、也不是一个应用而是一组可组合的技能Skills 启动引导指令Bootstrap让 AI 编码助手在写代码之前先停下来思考按照严谨的工程流程需求澄清 → 设计 → 计划 → TDD 实现 → 评审 → 收尾自动完成开发工作。核心理念是当你让 AI 帮你做一个东西时它不会立刻埋头写代码而是先弄清楚你到底想要什么形成规格 → 拆解成计划 → 用测试驱动的方式逐步实现并在每一步做代码评审。由于这些技能会自动触发用户无需做任何特殊操作编码助手就自带超能力了。二、设计哲学测试驱动开发TDD永远先写测试遵循 RED-GREEN-REFACTOR 循环。系统化胜过随意用固定流程代替猜测。降低复杂度以简单性作为首要目标YAGNI、DRY。证据胜过声明完成前必须验证而非口头宣称已修复。零依赖设计核心插件不引入任何第三方依赖需要外部工具的功能应做成独立插件。三、核心工作流Superpowers 把一次开发任务串成一条自动化流水线各阶段由对应技能负责阶段技能作用1. 头脑风暴brainstorming写代码前触发通过一问一答澄清意图分段呈现设计并获取确认保存设计文档2. Git 工作树using-git-worktrees设计确认后创建隔离的分支工作区运行环境初始化验证测试基线3. 编写计划writing-plans把工作拆成 2-5 分钟粒度的小任务每个任务含精确文件路径、完整代码、验证步骤4. 执行计划subagent-driven-development/executing-plans为每个任务派发全新子智能体做两阶段评审规格符合性 代码质量或分批执行并设人工检查点5. 测试驱动test-driven-development实现阶段强制 RED-GREEN-REFACTOR先写失败测试 → 看它失败 → 写最小代码 → 看它通过 → 提交6. 请求评审requesting-code-review任务之间对照计划评审按严重程度报告问题严重问题会阻断进度7. 收尾分支finishing-a-development-branch所有任务完成后验证测试给出合并/PR/保留/丢弃选项清理工作树关键点智能体在执行任何任务前都会检查是否有可用技能——这些是强制流程不是建议。四、技能库全景技能位于skills/目录每个技能是一个含SKILL.md的文件夹测试类test-driven-development— RED-GREEN-REFACTOR 循环附测试反模式参考testing-anti-patterns.md调试类systematic-debugging— 4 阶段根因分析流程含根因追踪、纵深防御、基于条件的等待等技巧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— 快速迭代 两阶段评审元技能Metawriting-skills— 遵循最佳实践创建新技能含测试方法论using-superpowers— 技能系统的入门介绍会话启动时被注入技能优先级当多个技能可能适用时的顺序流程类技能优先brainstorming、debugging——决定如何着手实现类技能其次——指导具体执行例如我们来做 X → 先 brainstorming 再实现修这个 bug → 先 debugging 再具体处理。五、运行机制技能如何自动触发这是 Superpowers 的技术核心位于hooks/目录会话启动钩子SessionStart Hookhooks/hooks.json声明在会话startup|clear|compact时执行run-hook.cmd session-start。跨平台包装器hooks/run-hook.cmd是一个多语言polyglot脚本——在 Windows 上 cmd.exe 会去查找并调用 Git Bash在 Unix 上则直接作为 shell 脚本运行。这保证了 Windows / macOS / Linux 通用。上下文注入hooks/session-start脚本读取using-superpowers/SKILL.md的完整内容转义成 JSON并根据不同平台Cursor / Claude Code / Copilot CLI 等以对应字段additional_context/hookSpecificOutput.additionalContext/additionalContext注入到会话上下文。这样从会话的第一条消息开始智能体就知道我有超能力、必须先检查技能。这也是所有集成必须满足的验收标准发送Lets make a react todo list时brainstorming技能必须自动触发。六、目录结构superpowers/ ├── skills/ # 技能库核心资产每个子目录一个技能 ├── hooks/ # 会话启动钩子与跨平台包装器 │ ├── hooks.json # Claude Code 钩子声明 │ ├── hooks-cursor.json # Cursor 钩子声明 │ ├── run-hook.cmd # 跨平台 polyglot 包装器 │ └── session-start # 上下文注入脚本无扩展名 ├── scripts/ # 维护脚本版本号、shell lint、Codex 插件打包与同步 ├── docs/ # 文档 │ ├── superpowers/ # 设计规格specs/与实现计划plans/ │ ├── windows/ # Windows 相关文档 │ ├── porting-to-a-new-harness.md # 移植到新宿主的指南 │ ├── README.kimi.md / README.opencode.md │ └── testing.md ├── tests/ # 各宿主集成测试claude-code / codex / cursor / kimi / opencode / pi 等 ├── assets/ # 图标等资源 ├── package.json # Pi 包与 OpenCode 插件入口声明 ├── README.md # 安装与使用总说明 ├── CLAUDE.md # 贡献者指南尤其针对 AI 智能体的严格要求 └── LICENSE # MIT七、支持的宿主HarnessSuperpowers 需要为每个使用的编码助手分别安装目前支持Claude Code官方插件市场 / Superpowers 市场Antigravityagy plugin installCodex App / Codex CLI官方 Codex 插件市场Cursor/add-plugin superpowersFactory DroidGitHub Copilot CLIKimi CodeOpenCode独立安装Pi作为 Pi 包原生支持技能不同宿主对技能的加载方式略有差异但共同点是必须在会话启动时加载using-superpowers引导否则技能虽然在磁盘上却永远不会被调用。八、测试与评估插件基础设施测试位于tests/通过各run-*.sh或npm test运行覆盖各宿主集成、钩子、shell lint、brainstorm 服务器等。技能行为评估使用独立仓库 superpowers-evals 的 drill eval 框架克隆到evals/通过真实 tmux 会话驱动 Claude Code / Codex 并用 LLM 裁判判断技能是否被正确遵循。九、一句话总结Superpowers 通过会话启动注入 自动触发的技能库把一套经过实战调优的软件工程方法论头脑风暴 → 设计 → 计划 → TDD → 评审 → 收尾固化进编码智能体让 AI 不再上来就写代码而是像一名有纪律、有判断力的资深工程师那样系统化地完成开发任务。
