ZhenYu's 知识库

外观

Superpowers - AI 编程技能框架与开发方法论

约 1641 字大约 5 分钟

AIClaude Code开发工具工作流

2026-03-26

简介

Superpowers 是由 Jesse Vincent（GitHub: obra）创建的 AI 编程代理技能框架，为 Claude Code、Gemini CLI、Cursor 等 AI 编码工具提供结构化的软件开发工作流。项目于 2025 年 10 月首次发布，目前已获得超过 11 万 GitHub Stars，是 Claude Code 官方插件市场中最受欢迎的插件之一。

Superpowers 的核心理念是：AI 编码代理不应该随意写代码，而应该遵循严格的工程实践 —— 从需求分析、方案设计、任务拆解到 TDD 开发、代码审查、验证完成，每一步都有对应的 skill 来约束和指导。框架的核心准则是 "如果某个 skill 适用于你的任务，你没有选择，必须使用它"。

项目采用 MIT 许可证，支持个人和商业使用。

解决什么问题？

AI 编码代理在没有约束的情况下，容易产生以下问题：

  • 缺乏规划直接动手 —— 代理往往跳过设计阶段直接写代码，导致架构混乱、返工频繁
  • 忽略测试纪律 —— 代理倾向于跳过 TDD，先写实现再补测试（甚至不补），代码质量难以保证
  • 需求理解偏差 —— 代理容易误解用户意图，做出来的东西不是用户想要的
  • 任务粒度过大 —— 一次尝试完成过多工作，失败时难以定位问题
  • 调试靠猜测 —— 遇到 bug 时随意尝试修复，而非系统性地排查根因
  • 缺少代码审查 —— 写完就算完成，没有质量把关环节

Superpowers 通过 强制性的 7 阶段开发流程 解决上述问题，将每个阶段封装为可组合的 skill，确保 AI 代理遵循工程最佳实践。

核心概念

指令优先级

Superpowers 定义了三层指令优先级：

优先级来源说明
最高用户显式指令CLAUDE.md、GEMINI.md、直接请求
中等Superpowers skills覆盖默认系统行为
最低默认系统提示词兜底行为

14 个内置 Skills

Skill类型功能
brainstorming灵活苏格拉底式对话，细化需求和设计方案
writing-plans灵活将设计拆解为 2-5 分钟的微任务，含文件路径和完成标准
executing-plans灵活执行计划，设置人工检查点
subagent-driven-development灵活分派专业子代理并行工作
dispatching-parallel-agents灵活协调多个代理同时工作
test-driven-development严格强制 RED-GREEN-REFACTOR 循环
systematic-debugging严格4 阶段调试：根因调查、模式分析、假设验证、实施修复
requesting-code-review灵活发起代码审查
receiving-code-review灵活处理审查反馈，按严重程度分级
verification-before-completion严格完成前确保所有测试通过、需求满足
finishing-a-development-branch灵活合并/PR 决策工作流
using-git-worktrees灵活创建隔离的 Git 工作树进行开发
using-superpowers元技能定义所有 skill 的调用方式
writing-skills灵活创建自定义 skill 的指南

Skills 分为两类：严格型（TDD、调试 —— 必须严格遵守）和 灵活型（可根据上下文调整）。

开发流程

brainstorming → writing-plans → executing-plans → TDD → code-review → verification → finishing

每个阶段都有对应的 skill 来确保质量，形成完整的开发闭环。

安装与配置

前置要求

  • 已安装 Claude Code、Gemini CLI、Cursor 等支持插件的 AI 编码工具

Claude Code 安装（推荐）

通过官方插件市场安装：

/plugin install superpowers@claude-plugins-official

或通过 Obra 市场：

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

安装后执行 /exit 重启 Claude Code 使插件生效。

Gemini CLI 安装

gemini extensions install https://github.com/obra/superpowers
gemini extensions update superpowers

Cursor 安装

在 Cursor 插件市场中搜索 "superpowers" 进行安装。

使用方式

基本用法

安装后，Superpowers 会自动在会话开始时激活。当你给出任务时，AI 代理会自动判断应该使用哪些 skill。

常用命令：

# 激活 Superpowers（通常自动完成）
/using-superpowers

# 开始头脑风暴，细化需求
/superpowers:brainstorm

# 生成实施计划
/superpowers:write-plan

# 执行计划
/superpowers:execute-plan

# 更新插件
/plugin update superpowers

进阶用法

自定义 Skill： 使用 /superpowers:writing-skills 可以创建项目专属的 skill，扩展框架能力。

并行开发： 对于包含多个独立任务的计划，Superpowers 会自动分派子代理并行工作，大幅提升效率。

Git Worktree 隔离： 开发时自动创建独立的 Git 工作树，避免影响主分支，完成后可选择合并或创建 PR。

实际示例

以"构建一个 Notion 风格的笔记应用"为例，展示 Superpowers 的完整工作流：

1. 头脑风暴阶段

用户：帮我构建一个 Notion 风格的笔记应用

Superpowers 触发 brainstorming skill，通过苏格拉底式提问细化需求：

  • 需要哪些核心功能？（富文本编辑、页面层级、协作？）
  • 技术栈偏好？（推荐 Next.js 14 + Tailwind + Supabase 并给出理由）
  • 部署方式？

2. 计划阶段

确认需求后，writing-plans skill 将项目拆解为 30-40 个微任务，每个任务包含：

  • 具体要修改的文件路径
  • 2-5 分钟的预估时间
  • 明确的完成标准

3. 执行阶段

executing-plans 和 subagent-driven-development 协作，分派多个子代理并行开发。每个子代理遵循 TDD 流程：先写失败的测试，再写实现让测试通过，最后重构。

4. 验证阶段

verification-before-completion 确保所有测试通过、功能符合预期后才宣布完成。整个过程约 45-60 分钟，测试覆盖率可达 ~87%。

如何更好地利用

  • 复杂项目优先使用 —— Superpowers 在微服务架构、SaaS 平台等复杂项目中价值最大，简单脚本或一次性工具可以跳过
  • 配合 CLAUDE.md 使用 —— 在 CLAUDE.md 中定义项目规范，Superpowers 会自动遵守，两者互补
  • 善用头脑风暴 —— 需求不明确时，先 /superpowers:brainstorm 充分讨论，避免方向错误导致返工
  • 信任但验证 —— Superpowers 的 TDD 和验证流程能捕获大部分问题，但关键业务逻辑仍需人工审查
  • 编写自定义 Skill —— 针对团队特有的工作流（如特定的部署流程、代码规范），编写自定义 skill 可以进一步提升效率

相关链接