一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | superpowers | 独立 GitHub 仓库名 |
| 作者/维护者 | Jesse Vincent(blog.fsck.com)与 Prime Radiant 团队 | 官方 README |
| 来源链接 | https://github.com/obra/superpowers | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 253,273 / 22,623 | GitHub API(gh api repos/obra/superpowers) |
| 最新版本 | v6.1.1(2026-07-02 发布) | GitHub Releases API,与官方 README 交叉核对一致 |
| 最近提交 | 2026-07-10(本次运行前 3 天),非 archived 状态 | GitHub API |
| 安装方式 | 各平台一条命令/插件市场安装,见第十章 | 官方 README |
二、功能介绍与亮点
superpowers 是一套面向编码 Agent 的“可组合技能框架 + 软件工程方法论”,把资深工程师的标准工作流拆成 14 个互相衔接的技能:brainstorming(编码前的需求澄清与方案探讨)、writing-plans(生成可执行的分步计划)、executing-plans(按计划执行)、test-driven-development(测试先行)、systematic-debugging(系统化排障)、requesting-code-review/receiving-code-review(代码评审的发起与应对)、subagent-driven-development/dispatching-parallel-agents(拆解任务给多个子 Agent 并行处理)、using-git-worktrees(工作区隔离)、finishing-a-development-branch(收尾与合并决策)、verification-before-completion(收尾前用证据验证而非空口断言)、writing-skills(编写新技能)、using-superpowers(总纲,指导何时调用哪个技能)。
亮点:① 官方认可——已被 Claude Code 官方插件市场(claude-plugins-official)、Codex 官方插件市场、Kimi Code 市场同时收录;② 完全开源(MIT);③ 跨平台覆盖广——README 明确列出 Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Factory Droid、GitHub Copilot CLI、Kimi Code、OpenCode、Pi 共 10 个 Agent 平台的安装方式;④ 维护极活跃——最近一次提交在本次评估 3 天前,最新版本发布仅一周。
三、适用场景
固定分类:元技能与 Agent 增强
适用于:希望编码 Agent 在动手写代码前先做需求澄清与设计评审、避免“话赶话式”返工的开发者;中大型功能开发、多文件重构、长会话易发生上下文漂移的场景;需要把测试驱动开发、代码评审等工程纪律固化为 Agent 默认行为的团队;初中级用户尤其受益——不必自己设计一套工作流规范,直接复用这套已被验证的方法论。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方插件市场收录,/plugin install superpowers@claude-plugins-official 一条命令安装 |
| Codex | 原生支持 | README 明确列出 Codex App 与 Codex CLI 两种安装方式,且已上架 Codex 官方插件市场 |
| OpenClaw | 未验证 | 已抓取材料(README、仓库目录结构)未提及 OpenClaw 专属支持,本次未为兼容性单独发起搜索 |
| Hermes Agent | 未验证 | 同上 |
补充:仓库还包含 .cursor-plugin、.kimi-plugin、.opencode、.pi 等目录及 gemini-extension.json,说明 Cursor、Kimi Code、OpenCode、Pi、Gemini 生态均有专门适配,但这些不在本报告固定评估的四个 Agent 范围内,仅作背景信息记录。
五、推荐理由
编码 Agent 常见的问题不是“跑得不够快”,而是缺乏工程纪律——跳过澄清直接写代码、长任务里上下文漂移、完成后不做验证就宣称“搞定了”。superpowers 把“头脑风暴 → 写计划 → 执行 → 测试驱动 → 评审 → 验证收尾”这一整套流程固化成可自动触发的技能链,且这套方法论已经过大规模社区检验(25 万+ star)与三家官方市场的审核收录,权威性和实操验证都很充分。对初中级用户而言,价值尤其明显:不需要自己摸索“该怎么指挥 Agent”,直接安装即获得一套现成的最佳实践。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 10 | GitHub 253,273 星,远超 5k 门槛;同时被 Claude Code、Codex、Kimi Code 三家官方插件市场收录,满足“官方/一线机构出品”档位 |
| 可用性 | 9 | 多数平台一条命令安装;README + 每个技能自带 SKILL.md 文档完整;3 天前有代码推送,维护极活跃;核心功能无付费依赖 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 9.0 | 三项均值 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 仓库含 hooks(如 SessionStart 自动注入技能引导)与构建/版本管理脚本,均在本地文件系统内操作;已抓取 hooks/session-start 全文,逻辑为读取本地 SKILL.md 并格式化为 JSON 输出,作用域清晰可审计 |
| ② 运行时联网外发 | README 明确披露一项可选遥测:brainstorming 技能的可视化组件默认从官方网站加载 Logo 图片并附带版本号,不含项目/代码/提示词内容;可通过环境变量 SUPERPOWERS_DISABLE_TELEMETRY 关闭,且遵循 Claude Code 的 DISABLE_TELEMETRY 标准开关 |
| ③ API Key/凭据 | 核心功能不需要任何 API Key;仅商业支持提供联系邮箱,非强制 |
| ④ 可疑指令排查 | 已完整抓取 session-start hook 脚本与 using-superpowers SKILL.md 正文,逻辑均为工作流引导与 JSON 格式化,未发现 prompt injection 或隐藏指令迹象 |
| ⑤ 作者/组织信誉 | Jesse Vincent(知名开源开发者)与 Prime Radiant 团队;已通过三家官方市场的收录审核 |
| ⑥ License | MIT,明确 |
| ⑦ 最近维护 | 最近一次提交在评估前 3 天,最新版本发布 1 周前,无弃置风险 |
因存在本地代码执行(范围明确可审计)及一项已披露且可关闭的可选外联,未达“无代码执行无外联”的 9-10 档,定为 8 分(“有代码执行但范围明确、可审计;外联目标透明;License 清晰”档位)。
七、跟同类 Skills 相比的优势
| 对比对象 | Stars | 定位 | 与本 skill 的差异 |
|---|---|---|---|
| github/spec-kit | 120,124 | GitHub 官方“规范驱动开发”工具包 | 侧重需求转规范模板,不含测试驱动、子 Agent 并行调度等完整工程闭环 |
| bmad-code-org/BMAD-METHOD | 50,472 | 12+ 智能体角色的敏捷开发框架 | License 为 NOASSERTION(未明确开源条款),安全性证据弱于本 skill;模块更多但配置更复杂 |
| openai/skills | 23,602 | Codex 官方技能目录(含 System/Curated/Experimental 三层) | 定位是“技能分发平台”而非单一方法论产品,License 字段缺失 |
anthropics/skills 内 skill-creator |
合集仓库,按规则不计整体星数 | Anthropic 官方“如何写技能”的元技能 | 只解决“怎么写一个技能”,不覆盖 superpowers 提供的完整开发生命周期 |
核心差异化:superpowers 是唯一把“设计-计划-执行-测试-评审-验证”整合成一条完整、可自动触发技能链的方案,且是本轮候选中星标最高、官方市场收录数最多的一个。
八、用户评价
本次完成 2 次专门检索,均成功:
- Anil Mathew(BitVoice Solutions 联合创始人,Medium),评价该框架“用 7 阶段流水线强制先规划后编码”,认为其解决了编码 Agent“速度快但缺乏纪律”的根本问题,建议“计划生成后手动检查而非盲目信任”。
- andrew.ooo(独立技术博主),2026-03-30:中立偏正面评测,指出优势为“强制 TDD、规范优先设计、子 Agent 隔离上下文”,但也提醒“不适合快速修复类任务”,并有用户报告在 OpenCode 平台存在技能冲突。
九、其他补充
版本迭代活跃:近期版本号为 v6.0.3 → v6.1.0 → v6.1.1,均在近期发布;社区贡献通过标准 GitHub PR/Issue 流程进行;仓库同时提供 AGENTS.md、CLAUDE.md、GEMINI.md 等多份面向不同 Agent 的说明文档。
十、安装使用方式
- Claude Code(官方市场):
/plugin install superpowers@claude-plugins-official - Codex CLI:
/plugins中搜索安装 - Cursor:
/add-plugin superpowers - Kimi Code:
/plugins install https://github.com/obra/superpowers - Antigravity:
agy plugin install https://github.com/obra/superpowers - Pi:
pi install git:github.com/obra/superpowers
安装后注意事项:无需重启,安装后新会话开始时会自动通过 SessionStart hook 注入 using-superpowers 技能说明;其余技能(如 brainstorming、writing-plans)在对应场景下按需触发或可显式调用。
十一、注意事项
- 默认开启的可视化组件遥测仅上报版本号,如需完全禁网请设置环境变量
SUPERPOWERS_DISABLE_TELEMETRY; - 社区评价提示该框架的强流程约束更适合中大型功能开发,对“快速修复”类小任务可能显得规划开销过大;
- 有用户在 OpenCode 平台报告过技能冲突,具体表现未经本次核实,建议在该平台谨慎测试;
- 强制的测试驱动开发流程对完全没有测试基础设施的项目可能产生摩擦;
- Codex、OpenClaw、Hermes Agent 中,仅 Codex 有官方明确支持证据,OpenClaw 与 Hermes Agent 的兼容性本次未获得可验证材料。