信息卡

一句话定位

Superpowers 是为 AI 编程代理设计的完整软件开发方法论，由一组可自动触发、可自由组合的技能和初始指令构成。它强制代理先通过对话提炼规格、制定计划并获得用户确认后再动手写码，并以真红绿 TDD 和子代理驱动开发支撑数小时的自主连续工作，目前已在约 15 种主流编程代理上通用，总星标近二十八万居本榜单之首。

趋势解读：为什么火

裸奔的大模型代理会"自信地写出垃圾代码"，约束代理的工作流框架因此成为刚需品类。Superpowers 把资深工程师的心智习惯——先问为什么、写小步计划、测试先行、互相审查——固化为技能并跨代理一致生效，几乎成了该品类默认答案，庞大基数下仍月增一万八千星印证其地位。

核心功能拆解

• 七步主工作流：brainstorming 头脑风暴（设计分节呈现并存档）→ using-git-worktrees 隔离工作区 → writing-plans（任务拆到 2–5 分钟粒度，含精确路径、完整代码与验证步骤）→ subagent-driven-development/executing-plans 子代理逐任务执行 → test-driven-development 红-绿-重构 → requesting-code-review（严重问题阻塞进度）→ finishing-a-development-branch 收尾。
• 调试双技能：systematic-debugging 提供四阶段根因分析，verification-before-completion 要求完成前必须实证。
• 协作与元技能：dispatching-parallel-agents 并行派工、receiving-code-review 接收反馈的标准姿势，以及 writing-skills 元技能用于沉淀新方法论。
• 口味的工程化表达：计划的验收标准细到"热情但品味差的初级工程师也能照做"。
• 反向保护：YAGNI/DRY 原则内置，删除任何测试先行时代码是被禁止的反模式。

架构与技术栈浅析

实现上是纯 Markdown SKILL.md 技能文件集，靠各代理平台的插件/扩展机制装载，无运行时依赖；"技能自动触发、完成前置检查"是其区别于普通提示词合集的关键机制。作者一般不接受新技能贡献，以保证跨十五个平台的行为兼容性，这也使其更像被精心维护的方法论发行版而非大众共创库。

安装与环境要求

任选所用代理对应的插件命令即可，多工具共用需分别安装。Claude Code 用官方市场一键安装；其余平台均走 GitHub 地址装载，无额外运行环境要求。

/plugin install superpowers@claude-plugins-official        # Claude Code
gemini extensions install https://github.com/obra/superpowers # Gemini CLI
droid plugin install superpowers@superpowers               # Factory Droid

快速上手示例

装好后正常开工即可：你描述想构建的东西，代理会主动发问澄清真实意图，随后逐节展示提炼后的规格请确认；回复确认生成实施计划，再说一声 go，子代理便按任务清单推进并相互审查：

你：帮我做一个导出 PDF 的命令行工具
代理：[brainstorming] 先问清用途、格式要求与边界…（分节确认设计）
你：go
代理：[writing-plans → subagent-driven-development] 按 RED-GREEN-REFACTOR 逐任务实施

进阶使用要点

• 不想要某环节时可显式指示跳过 brainstorming，走轻量流程。
• 企业批量部署可用 SUPERPOWERS_DISABLE_TELEMETRY 关闭默认遥测。
• 自研领域技能建议用 writing-skills 元技能生成骨架再调优措辞。
• Codex CLI 内输入 /plugins 即可搜索安装，无需命令行参数。

典型应用场景

• 个人长周期项目：worktree 隔离加子代理流水线让你睡觉时代码照样推进。
• 团队规范落地：把 code review 与 TDD 纪律强制注入每个人的 AI 编程环境。
• 复杂重构：先用 systematic-debugging 定位根因再按计划分步执行避免大爆炸式修改。

同类生态位对比

对比 mattpocock/skills 的精巧工具箱风格，Superpowers 是接管全程的强约束操作系统，二者分别代表"给原则"与"给纪律"两种流派；对比 Spec-Kit 则更侧重执行期质量控制而非前期规格产物本身。

资源导航

• 仓库：https://github.com/obra/superpowers
• 安装指南：各代理平台章节（见 README）