Superpowers Skill:让 AI 编程 Agent 学会”先思考再动手”的开发方法论

Superpowers 是一个为 AI 编程 Agent 打造的开源技能框架与完整软件开发方法论。它不只是一个 Skill 集合,而是一套让 AI Agent 从”拿到需求就写代码”转变为”先理解、先设计、先计划”的系统性开发流程。核心理念:TDD、YAGNI、DRY,支持 Claude Code、Codex、Cursor、Devin 等 13+ 主流 Agent 平台,2026-08-13 刚发布 v6.3.0,当前 GitHub 达 274.5k Stars,是近期最火的 Agent 开发框架之一。

功能与原则

Superpowers 提供了一套强制触发的技能工作流,覆盖软件开发全生命周期:

  • brainstorming:编码前先 Socratic 式追问,明确真正要解决的问题
  • writing-plans:将设计方案拆解为 2-5 分钟粒度的可执行任务
  • subagent-driven-development:每个任务派独立 Agent 执行,双阶段 review(是否符合规范 → 代码质量)
  • test-driven-development:强制 RED-GREEN-REFACTOR 循环,先写测试再写实现
  • using-git-worktrees:隔离分支开发,避免污染主工作树
  • finishing-a-development-branch:任务完成后提供 merge/PR/保留/丢弃决策

设计原则:TDD 优先、系统化优于随机化、降低复杂度是首要目标、以验证代替声明。

认可度

  • GitHub Star:274.5k(截至 2026-08-20),近 557 颗 Stars 今日新增
  • Fork:24.6k
  • 贡献者:49 人
  • 最新版本:v6.3.0(2026-08-13,支持 Devin CLI 和 Hermes Agent)
  • 发布频率:12 个 release,最近一个月内保持活跃更新
  • 社区Discord 社区活跃,有明确商业支持渠道(Prime Radiant 公司)

链接

GitHub:https://github.com/obra/superpowers

原作者

Jesse Vincent(GitHub @obra),Prime Radiant 公司创始人。资深开源开发者,历史上参与过多个知名基础设施项目(如 RT)——这次将二十年软件工程经验浓缩进 Superpowers 的技能框架设计。

介绍

Superpowers 起源于一个观察:大多数 AI 编程 Agent 拿到需求就开写,结果代码写得快、回头改得更多。它从启动 Agent 的那一刻就介入——当感知到你正在开发某个项目时,Agent 会先停下来,通过 Socratic 追问弄清楚你真正想解决什么问题,把粗略想法打磨成可验证的设计文档,分段展示给你确认后再行动。

设计审批通过后,Agent 才会拿出一个足够清晰的实现计划——足够让一个”没有品味、缺乏上下文、对测试有抵触情绪的热情初级工程师”也能照着执行。计划粒度极细(每步 2-5 分钟),包含精确文件路径、完整代码和验证步骤。

最后,它以 subagent 驱动的方式推进:每个工程任务派一个独立 Agent 处理,完成后经过两阶段 review,再继续下一步。一个 Agent 自主工作数小时不偏离计划是常态。

特点

  • 跨平台支持:Claude Code、Codex App/CLI、Cursor、Devin CLI、Antigravity、Factory Droid、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、HMeres Agent,一个框架覆盖市面所有主流 AI 编程工具
  • 强制触发机制:技能不是建议,是强制执行——Agent 在执行任何任务前都会自动检查是否有相关技能,无缝嵌入现有工作流
  • 子 Agent 并行开发:subagent-driven-development 技能支持多 Agent 并行处理不同任务,大幅提升复杂项目的执行效率
  • TDD 强制循环:test-driven-development 技能强制 RED-GREEN-REFACTOR,不允许在测试通过前写实现代码,从源头保证代码质量
  • 技能可扩展:writing-skills 技能提供完整的技能创建指南,团队可基于 Superpowers 构建自己的专有技能库
  • 跨平台一致性:同一套技能在不同 Agent 平台(Claude Code、Codex、Cursor 等)上行为统一,不因工具切换而失效

使用方法

以 Claude Code 为例,安装方式:

# 方式一:官方插件市场
/plugin install superpowers@claude-plugins-official

# 方式二:Superpowers 社区市场
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

其他平台安装方式:

# Codex CLI
/plugins → 搜索 superpowers → Install Plugin

# Cursor
/add-plugin superpowers

# Devin CLI
devin plugins install obra/superpowers

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

安装后,在项目目录下启动 Agent,Superpowers 会自动检测并从第一个消息起激活所有技能。

使用场景与人群

  • 适用场景:中大型软件开发项目、需要多轮迭代的复杂功能开发、团队协作的代码规范建设、AI 编程 Agent 的能力增强
  • 目标用户:对代码质量有要求的专业开发者、使用 AI 编程工具(Claude Code/Codex/Cursor/Devin 等)的工程师、追求 AI Agent 可预测性和可控性的技术负责人

不适合的场景:简单脚本或一次性工具生成(引入成本过高)。

输入与输出案例

案例一:功能开发

Input(用户):”帮我做一个用户登录模块,包含邮箱和密码校验”

Superpowers 触发流程:
1. brainstorming 技能启动:追问”用户登录后要做什么?要不要支持 OAuth?session 时长要求?”
2. 用户回答后,生成结构化设计文档分段展示
3. 用户审批设计 → writing-plans 技能生成 12 个子任务(如:建 User 模型、写密码校验测试、写 JWT 生成代码……)
4. subagent-driven-development 逐个执行任务,每个任务先 TDD,再 code review

Output:完整登录模块代码,符合设计规范,测试覆盖率完整。


案例二:修复 Bug

Input(用户):”线上支付接口偶发性超时,怎么排查?”

Superpowers 触发流程:
1. systematic-debugging 技能激活,按四阶段根因分析:复现 → 定位 → 修复 → 验证
2. 引导用户提供超时日志片段、环境信息、复现频率
3. 制定调查计划(查看超时时间分布、检查连接池配置、分析重试逻辑……)
4. 执行每步前先写测试,修复后验证问题消失

Output:修复方案 + 对应测试用例 + 根因分析报告。


GitHub: https://github.com/obra/superpowers

评论区

0 条评论

登录后可评论。

Skill超级捕获手 11 阅读