通用工具通用通用工具
SU

Superpowers

obra · 2026年5月24日

AI 编程方法论框架,让 agent 按「构思→计划→TDD→审查」的结构化流程写代码,而不是直接乱写。

Superpowers 是一套完整的 AI 编程方法论,包含 14 个可安装的 skill。它强制 agent 按照「构思→计划→测试驱动→代码审查」的流程工作,而不是拿到需求就直接写代码。204K GitHub stars,是最流行的 agent 编程框架之一。

Claude CodeCodexCursorGemini CLI写作整理分析处理编程方法论TDD代码审查任务规划

适用场景

适用场景

  • 让 Claude Code / Codex 按结构化流程开发,避免写出来的东西不可用。
  • 用 brainstorming skill 在写代码前先理清需求和设计方案。
  • 用 TDD skill 确保先写测试再写实现。
  • 用 code-review skill 在每个任务完成后自动审查代码质量。

不适用场景

不适用场景

  • 不适合一次性小脚本或简单修改,流程太重。
  • 不适合不需要测试的快速原型。

安装

安装

安装

安装

2

Claude Code

仓库克隆已验证

复制命令

npx skills add obra/superpowers@brainstorming -g -y

安装

  1. 1安装单个 skill:`npx skills add obra/superpowers@brainstorming -g -y`
  2. 2安装全部 skill:克隆仓库后复制到 ~/.claude/skills/ 目录
  3. 3推荐从 brainstorming 和 writing-plans 开始使用

信息

安装后 agent 会自动在合适时机触发对应 skill。

Codex

仓库克隆已验证

复制命令

npx skills add obra/superpowers@brainstorming -g -y

安装

  1. 1使用 skills CLI 安装:`npx skills add obra/superpowers@brainstorming -g -y`
  2. 2或手动克隆仓库到 ~/.codex/skills/ 目录

核心说明

核心说明

  • Superpowers 不是一个单一工具,而是一套编程方法论,由 14 个相互配合的 skill 组成。它的核心理念是:AI agent 不应该拿到需求就直接写代码,而应该按照结构化的流程工作。
  • 1. Brainstorming(构思)— 通过苏格拉底式提问澄清需求,探索多种方案,产出设计文档 2. Writing Plans(写计划)— 把工作拆成 2-5 分钟的小任务,每个任务指定具体文件和验证方式 3. Test-Driven Development(测试驱动)— 强制 RED-GREEN-REFACTOR 循环,先写测试再写代码 4. Subagent Development(子 agent 开发)— 每个任务用独立子 agent 执行,两轮审查 5. Code Review(代码审查)— 每个任务完成后自动审查,关键问题会阻断进度。

SKILL.md

SKILL.md

SKILL.md

SKILL.md

ZH

这是什么

Superpowers 不是一个单一工具,而是一套编程方法论,由 14 个相互配合的 skill 组成。它的核心理念是:AI agent 不应该拿到需求就直接写代码,而应该按照结构化的流程工作。

核心流程

  1. Brainstorming(构思)— 通过苏格拉底式提问澄清需求,探索多种方案,产出设计文档
  2. Writing Plans(写计划)— 把工作拆成 2-5 分钟的小任务,每个任务指定具体文件和验证方式
  3. Test-Driven Development(测试驱动)— 强制 RED-GREEN-REFACTOR 循环,先写测试再写代码
  4. Subagent Development(子 agent 开发)— 每个任务用独立子 agent 执行,两轮审查
  5. Code Review(代码审查)— 每个任务完成后自动审查,关键问题会阻断进度

包含的 14 个 Skill

Skill用途
brainstorming需求澄清与方案设计
using-superpowers框架入门指南
systematic-debugging4 阶段系统化调试
writing-plans详细实现计划
requesting-code-review提交审查前的自查清单
test-driven-developmentTDD 循环
subagent-driven-development子 agent 快速迭代
executing-plans批量执行与人工检查点
dispatching-parallel-agents并行子 agent
receiving-code-review回应审查反馈
using-git-worktrees并行开发分支
finishing-a-development-branch合并/PR 决策
writing-skills创建新 skill
verification-before-completion完成前验证

为什么值得用

大多数 AI 编程工具的问题是:agent 直接写代码,写完就交差,质量不可控。Superpowers 通过强制流程来解决这个问题——构思阶段避免方向错误,计划阶段拆解复杂度,TDD 阶段保证正确性,审查阶段保证质量。