Superpowers：给编程 Agent 装上完整开发方法论的开源技能框架

Superpowers 是一个面向编程 Agent 的开源技能框架和软件开发方法论。它的核心思路很直接：当你的编程 Agent 看到你准备做点什么时，不要立刻开始写代码，而是先停下来，问清楚你真正想解决什么问题。项目由 Jesse Vincent 和 Prime Radiant 团队构建，采用 MIT 许可证，主要语言为 Shell，仓库当前显示约 317,801 个 GitHub Star、28,304 个 Fork。

它解决什么问题

常见的编程 Agent 容易直接跳进编码，缺少需求澄清、设计确认和测试约束。Superpowers 通过一组可组合的技能（skills）和初始指令，把一套完整的开发流程嵌入到 Agent 的工作方式中。这些技能会自动触发，用户不需要额外操作，Agent 就“拥有”了 Superpowers。

核心工作流

Superpowers 把开发过程拆成几个阶段，每个阶段对应一个技能：

• brainstorming：在动手构建前激活，通过提问把你真正想要的东西和原因梳理出来，再把理解复述给你确认。小改动在对话中达成一致，较大的项目会形成一份可据此规划的设计文档。
• using-git-worktrees：设计确认后激活，在新分支上创建隔离工作区，运行项目初始化，并验证测试基线干净。
• writing-plans：把工作拆成 2–5 分钟粒度的小任务，每个任务都包含确切的文件路径、完整代码和验证步骤。
• subagent-driven-development 或 executing-plans：拿到计划后，前者为每个任务派发新的子 Agent，并在每个任务后做审查，通常更彻底；后者在当前会话中逐项实现，最后对整条分支做一次审查，成本更低。
• test-driven-development：在实现过程中强制 RED-GREEN-REFACTOR，即先写会失败的测试、看它失败、写最小代码、看它通过、提交，并删除在测试之前写的代码。
• requesting-code-review：任务之间按计划审查，按严重程度报告问题，关键问题会阻塞进度。
• finishing-a-development-branch：任务完成后验证测试，给出合并、提 PR、保留或丢弃等选项，并清理 worktree。

流程中还有一个明确约定：Agent 在执行任何任务前都会检查相关技能，这些是强制工作流，不是建议。

技能库内容

除上述流程技能外，仓库还包含测试、调试、协作和元技能等类别：

• 测试：test-driven-development，附带测试反模式参考。
• 调试：systematic-debugging 提供四阶段根因分析流程，包含根因追踪、纵深防御、条件等待等技巧；verification-before-completion 用于确认问题真的修好了；diagnosing-superpowers 用于分析某次会话中 Superpowers 哪里出了问题，可读取会话记录、给出带行级证据的报告，并可选打包脱敏材料用于提交 bug。
• 协作：brainstorming、writing-plans、executing-plans、dispatching-parallel-agents、requesting-code-review、receiving-code-review、using-git-worktrees、finishing-a-development-branch、subagent-driven-development 等。
• 元技能：writing-skills 用于按照最佳实践创建新技能，using-superpowers 是技能系统的入门说明。

支持哪些编程 Agent

Superpowers 需要针对不同的 Agent 运行环境分别安装。README 给出的安装方式覆盖 Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Devin CLI、Factory Droid、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Qwen Code、Hermes Agent 和 Muse。多数环境通过插件市场或从仓库安装插件/扩展，部分环境有额外的详细文档，例如 OpenCode 和 Kimi Code。如果你同时使用多个 Agent，需要为每一个单独安装。

适用人群与注意事项

Superpowers 适合希望把需求澄清、计划拆解、TDD 和代码审查固化到编程 Agent 工作流中的开发者，尤其是在使用支持技能/插件机制的 Agent 时。它强调“系统化优于临时发挥”“证据优于声明”“简单性优先”，并坚持测试先行。

需要注意几点：项目不一般接受新增技能的贡献，技能修改必须能在所有支持的 Agent 上工作；也不接受由 Agent 代写的、针对他人已提 issue 的修复 PR，遇到相同问题应补充到已有 issue。技能行为测试使用 superpowers-evals 中的 drill eval 工具，插件基础设施测试位于 tests/ 目录。更新方式因 Agent 而异，但通常是自动的。

另外，brainstorming 的可选可视化伴侣功能默认会从 Prime Radiant 网站加载一个带版本号的 logo，用于粗略统计使用人数和版本，不包含项目、提示词或 Agent 的详细信息。该功能完全可选，可通过设置环境变量 SUPERPOWERS_DISABLE_TELEMETRY 为任意真值来关闭，同时也遵循 Claude Code 的 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 退出选项。

项目主页

https://github.com/obra/superpowers

项目地址：superpowers