已收录317 条资讯/102 个 AI 工具/399 个开源项目/74 个学习资源
首页资讯开源榜单模型榜AI 工具学习资源
首页 / 开源榜单 / superpowers

superpowers

一个可组合的技能库，为 AI 编程智能体提供规范的、测试驱动的开发方法论。

ShellMITskill
⭐ GitHubhttps://github.com/obra/superpowers
272,614
Star 数
+0
Star 增速
2026年8月13日
最后更新
4
点击数

1. 项目概述

Superpowers 是一套面向 AI 编程智能体的开源软件开发方法论——它是一个由“技能”组成的可组合库，能够引导 Claude Code、Cursor 和 Codex CLI 等工具遵循规范、基于证据的工作流，而不是让它们直接跳入随意的编码过程。

2. 背景与定位

Superpowers 的诞生旨在解决 AI 编程智能体常见的一种失败模式：先写代码后思考，跳过设计评审，忽略测试，并在未经真正验证的情况下就宣布任务“完成”。其核心使命是为智能体提供一套可重复的专业级流程——包括头脑风暴、规划、隔离执行、测试驱动开发和代码评审——从而确保智能体生成的软件能够达到人类工程团队所期望的同等标准。

与单一用途的提示词库或一次性的“编程智能体”封装不同，Superpowers 明确定位为方法论加技能库，而非单一工具。它在设计上不依赖于特定智能体：同一套技能集可以安装到 13 种以上的不同编程智能体中（包括 Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、Devin 等），而不局限于某个供应商的生态系统。它还推崇“系统化优于随意化”的决策方式和“证据优于断言”的原则，这使其有别于那些不强制执行流程纪律的轻量级提示词工程合集。

3. 功能分类

  • 🧪 测试 — 1 项技能。test-driven-development 强制执行严格的 RED-GREEN-REFACTOR（红-绿-重构）循环，确保智能体在编写实现代码之前先编写失败的测试。
  • 🐞 调试 — 2 项技能。systematic-debugging 推动根本原因分析而非凭空猜测；verification-before-completion 阻止智能体在没有实际证据证明有效的情况下将工作标记为“完成”。
  • 🤝 协作 — 9 项技能。包括 brainstorming（编码前与用户进行设计验证）、writing-plans / executing-plans（任务分解与执行）、dispatching-parallel-agents（将工作分发给子智能体）、requesting-code-review / receiving-code-review（请求/接收代码评审）、using-git-worktrees（隔离、安全的开发分支）、finishing-a-development-branch（完成开发分支）以及 subagent-driven-development（子智能体驱动开发）。
  • 🧩 元技能 — 2 项技能。writing-skills 记录了如何编写新技能；using-superpowers 解释了框架本身应如何被调用和组合。

4. 核心亮点

  • 七阶段开发工作流 — 每个任务都会经历设计头脑风暴、Git Worktree 隔离、任务分解、带评审周期的子智能体执行、TDD、基于规范的代码评审以及分支清理，赋予智能体驱动的开发以一致的形态。
  • 不依赖特定智能体的安装方式 — 适用于 13 种以上的编程智能体（Claude Code、Cursor、Codex CLI、Gemini CLI、GitHub Copilot CLI、Devin、Antigravity、Factory Droid、Grok Build CLI、Kimi Code、OpenCode、Pi、Hermes Agent），使团队不会被锁定在单一供应商中。
  • 默认采用测试驱动开发 — test-driven-development 技能将 RED-GREEN-REFACTOR 设为默认循环，而非可选的纪律要求。
  • 重证据轻断言的验证机制 — verification-before-completion 专门用于阻止智能体在没有证明的情况下自行报告成功。
  • Git Worktree 隔离 — 开发在隔离的 Worktree 中进行，防止实验性或进行中的智能体工作破坏主分支的稳定性。
  • 可组合、可扩展的技能库 — 技能是基于 Markdown 的模块化单元（SKILL.md），writing-skills 为希望添加自定义技能的团队记录了相关模式。

5. 按角色划分的使用场景

  • 通用开发者 — 将 Superpowers 安装到您选择的编程智能体中，即可在日常的智能体辅助编码会话中获得结构化规划、TDD 强制执行和内置的代码评审。
  • 项目经理 / 技术负责人 — 利用头脑风暴和规划技能，让智能体在实现开始前揭示设计权衡并生成可评审的计划，减少意外的返工。
  • 开源维护者 — using-git-worktrees 和 finishing-a-development-branch 技能有助于保持智能体提交的分支隔离且整洁，减轻维护者的评审负担。

（DevOps/SRE、安全工程和数据/研究科学并非本项目的重点关注领域，故未包含在内。）

6. 快速入门

查找所需内容
在仓库的 skills/ 目录中按类别（测试、调试、协作、元技能）浏览技能库，或阅读 docs/ 获取针对特定智能体的设置说明。

安装 / 集成
安装只需一条针对您所用编程智能体的命令，例如：

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

# Cursor
/add-plugin superpowers

# Gemini CLI
gemini extensions install https://github.com/obra/superpowers

# GitHub Copilot CLI
copilot plugin install superpowers@superpowers-marketplace

请参阅仓库 README 中的完整表格，了解所有 13 种以上受支持智能体的详细信息。

贡献
Fork 本仓库，从 dev 分支开始工作，并在发起 Pull Request 之前遵循 skills/writing-skills/SKILL.md 中记录的方法论。请注意，维护者表示通常不接受全新技能的贡献——修复错误和改进现有技能是主要的贡献途径。

7. 项目结构

superpowers/
├── .claude-plugin/     # Claude Code 插件清单
├── .cursor-plugin/     # Cursor 插件清单
├── .devin-plugin/      # Devin 插件清单
├── .kimi-plugin/       # Kimi Code 插件清单
├── .opencode/          # OpenCode 扩展 + INSTALL.md
├── .pi/extensions/     # Pi 扩展清单
├── .agents/plugins/    # 共享智能体插件定义
├── skills/             # 核心技能库（每个技能对应一个 SKILL.md）
├── docs/               # 针对特定智能体及通用的文档
├── hooks/              # 工作流钩子
├── scripts/            # 辅助自动化脚本
├── assets/             # 静态资源（Logo、遥测像素等）
└── tests/              # 测试套件 / 评估框架

skills/ 目录是本项目的核心——每项技能都是一个独立的 SKILL.md 文件，描述了智能体应在何时以及如何应用该技能。.{agent}-plugin/ 目录则将同一套技能库适配为每种受支持编程智能体的插件格式。

8. 相关生态

Superpowers 依赖于其所安装的编程智能体平台——Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、Codex CLI、Devin、Antigravity、Factory Droid、Grok Build CLI、Kimi Code、OpenCode、Pi 和 Hermes Agent——这些平台各自提供了底层的 LLM 运行时以及插件/扩展机制，Superpowers 的技能正是运行于其上。它通过在这些原生能力之上叠加一套共享的开发方法论，起到了补充（而非替代）作用。

9. 许可证

  • ✅ 允许免费使用、复制、修改、合并、发布和分发，包括用于商业目的（MIT 许可证）。
  • ✅ 允许免费安装到任何受支持的编程智能体中，无论是个人还是组织使用。
  • ❌ 不提供任何保证——软件按“原样”提供。
  • ℹ️ 原始版权声明和许可声明必须保留在软件的副本或重要部分中。
  • ℹ️ 本项目包含可选的、可选择退出的遥测功能（通过 Logo 加载信标追踪版本采用情况）；可通过环境变量禁用。

10. 常见问题解答

问：Superpowers 适用于我的编程智能体吗？
答：它支持 13 种以上的智能体，包括 Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、Codex CLI 和 Devin——请查阅 README 中的安装表以获取适用于您智能体的确切命令。

问：Superpowers 是一个单一工具还是一组提示词？
答：严格来说都不是——它是一套以可组合技能库（skills/）形式实现的结构化方法论，旨在让智能体在整个开发工作流中持续调用，而非一次性使用的提示词。

问：我可以贡献新技能吗？
答：您可以发起 Pull Request，但维护者指出他们通常不接受全新技能的贡献；改进现有技能、文档或智能体集成的贡献更有可能被合并。所需格式请参阅 skills/writing-skills/SKILL.md。

问：它会收集我的数据吗？
答：它包含仅限于版本采用情况追踪的可选遥测功能，并支持通过环境变量选择退出。

问：安装后如何更新 Superpowers？
答：更新遵循您的编程智能体正常的插件/扩展更新机制；具体细节请参阅仓库 README 中的“更新”部分。

11. 快速链接

  • 仓库地址：https://github.com/obra/superpowers
  • 贡献指南：skills/writing-skills/SKILL.md（位于仓库内）
  • 特定智能体文档：docs/ 目录（位于仓库内）
  • 社区：仓库的 GitHub Issues 和 Discussions

12. 总结

Superpowers 将随意的 AI 辅助编码转变为规范的、基于证据的工程流程——涵盖头脑风暴、规划、TDD 和代码评审——并可安装到团队已使用的任何编程智能体中。对于希望 AI 编程智能体表现得像严谨的工程师而非快速但粗糙的自动补全工具，同时又不想被锁定在单一智能体供应商的开发者及团队而言，它最具价值。