大家好，我是何三，独立开发者。

最近在 GitHub 上发现了一个非常有趣的项目——Superpowers，这是一个为 AI 编程代理设计的完整软件开发工作流框架。说实话，第一次看到这个项目时，我被它的设计理念深深吸引了。它不是简单的工具集合，而是一套完整的、可组合的"技能"系统，让 AI 代理能够像经验丰富的工程师一样思考和行动。

为什么需要 Superpowers？

在 AI 编程工具日益普及的今天，我们经常遇到这样的问题：AI 虽然能写代码，但往往缺乏工程化的思维。它可能会直接跳进编码阶段，忽略需求分析、设计规划、代码审查等重要环节。这就导致生成的代码虽然能跑，但质量参差不齐，维护性差。

Superpowers 的核心思想就是：在写代码之前，先停下来思考。它通过一系列自动触发的"技能"，引导 AI 代理遵循完整的软件开发流程，从需求分析到最终交付，每一步都有章可循。

Superpowers 的核心工作流

Superpowers 的工作流程非常清晰，就像一个经验丰富的项目经理在指导工作：

Superpowers 核心工作流程

1. 头脑风暴阶段

当你告诉 AI "我要做一个功能"时，它不会马上开始写代码，而是会先问你几个问题，澄清你的真实需求。然后它会探索不同的实现方案，把设计文档拆分成小段展示给你确认。这个阶段确保了我们在正确的问题上工作。

2. 使用 Git Worktrees

设计确认后，AI 会创建一个独立的 Git 工作树，在新分支上进行开发。这样做的好处是不会影响主分支，可以随时丢弃重来。它还会运行项目设置，确保测试基线是干净的。

3. 编写详细计划

接下来，AI 会把整个工作拆分成 2-5 分钟就能完成的小任务。每个任务都有明确的文件路径、完整的代码、验证步骤。这个计划详细到即使是一个刚入门的工程师也能照着执行。

4. 子代理驱动开发

你说"开始"后，AI 会启动子代理驱动的开发过程。每个子代理负责一个任务，完成后会进行两轮审查：第一轮检查是否符合规范，第二轮检查代码质量。这个过程可以持续几个小时而不偏离计划。

5. 测试驱动开发

在实现过程中，Superpowers 强制执行 RED-GREEN-REFACTOR 循环：先写失败的测试，看它失败，写最少的代码让它通过，看它通过，提交。任何在测试之前写的代码都会被删除。

6. 代码审查

在任务之间，AI 会自动进行代码审查，对照计划检查实现，按严重程度报告问题。关键问题会阻止进度继续。

7. 完成开发分支

所有任务完成后，AI 会验证测试，然后给你几个选项：合并、创建 PR、保留分支或丢弃。最后清理工作树。

技术原理深度解析

Superpowers 的魔力来自于它的"技能"系统。这些技能就像是一系列预定义的行为模式，每个技能对应软件开发中的一个特定环节。当 AI 识别到某个场景时，相应的技能会自动触发。

Superpowers 技能系统架构

技能系统的设计理念

  • 可组合性：每个技能都是独立的，可以单独使用，也可以组合使用
  • 自动触发：不需要手动调用，AI 会根据上下文自动选择合适的技能
  • 强制性：这些是强制性的工作流，不是建议，确保质量标准

核心技能库

测试相关技能： - test-driven-development：RED-GREEN-REFACTOR 循环，包含测试反模式参考

调试相关技能： - systematic-debugging：4 阶段根因分析过程 - verification-before-completion：确保问题真正被解决

协作相关技能： - brainstorming：苏格拉底式设计优化 - writing-plans：详细的实现计划 - executing-plans：带检查点的批量执行 - dispatching-parallel-agents：并发子代理工作流 - requesting-code-review：预审查检查清单 - receiving-code-review：响应反馈 - using-git-worktrees：并行开发分支 - finishing-a-development-branch：合并/PR 决策工作流

实战演示：如何使用 Superpowers

让我用一个具体的例子来展示 Superpowers 的威力。假设我们要开发一个简单的待办事项管理功能。

实战演示流程

场景 1：需求澄清

你：帮我实现一个待办事项管理功能

AI（触发 brainstorming 技能）：好的，在开始之前，我需要了解一些细节： - 你需要支持哪些基本功能？（添加、删除、标记完成？） - 数据存储方式是什么？（本地存储、数据库？） - 需要用户界面吗？（命令行、Web、移动端？） - 有什么特殊要求吗？（截止日期、优先级、标签？）

你：支持添加、删除、标记完成，用本地存储，Web 界面

AI：明白了。让我展示一下设计方案：

设计方案（第一部分）： - 使用 HTML/CSS/JavaScript 构建 Web 界面 - 数据存储在 localStorage 中 - 基本的 CRUD 操作

设计方案（第二部分）： - 添加任务：输入框 + 添加按钮 - 列表展示：任务列表，每项有复选框和删除按钮 - 状态管理：使用简单的 JavaScript 对象数组

你：方案看起来不错，开始吧

场景 2：创建工作树

AI（触发 using-git-worktrees 技能）：

# 创建新的工作树
git worktree add ../todo-app-feature feature/todo-app

# 进入工作目录
cd ../todo-app-feature

# 安装依赖（如果需要）
npm install

# 运行测试基线
npm test

场景 3：编写实现计划

AI（触发 writing-plans 技能）：

任务 1：创建 HTML 结构（预计 3 分钟） - 文件：index.html - 内容：基本的 HTML5 结构，包含输入框、按钮和任务列表容器 - 验证：在浏览器中打开，看到基本布局

任务 2：添加 CSS 样式（预计 5 分钟） - 文件：styles.css - 内容：现代化的 UI 样式，响应式设计 - 验证：界面美观，在不同屏幕尺寸下正常显示

任务 3：实现 JavaScript 逻辑（预计 10 分钟） - 文件：app.js - 内容：添加任务、删除任务、标记完成的逻辑 - 验证：所有功能正常工作

任务 4：添加本地存储（预计 5 分钟） - 文件：app.js（修改） - 内容：使用 localStorage 持久化数据 - 验证：刷新页面后数据仍然存在

任务 5：编写测试（预计 8 分钟） - 文件：app.test.js - 内容：单元测试和集成测试 - 验证：所有测试通过

场景 4：执行开发

AI（触发 subagent-driven-development 技能）：

现在开始执行任务 1...

子代理 1：正在创建 HTML 结构...

（子代理完成 HTML 结构，进行自我审查）

审查结果：符合设计规范，代码质量良好

任务 1 完成！继续任务 2...

（重复这个过程，直到所有任务完成）

场景 5：代码审查

AI（触发 requesting-code-review 技能）：

正在对照计划审查代码...

审查报告： - ✅ 所有功能都已实现 - ✅ 代码遵循最佳实践 - ⚠️ 发现一个潜在问题：localStorage 容量限制未处理 - ⚠️ 建议添加输入验证

修复建议： 1. 添加 localStorage 错误处理 2. 验证输入不为空

是否需要修复这些问题？

你：修复吧

（AI 修复问题，重新审查）

场景 6：完成分支

AI（触发 finishing-a-development-branch 技能）：

所有任务已完成，测试全部通过。请选择下一步操作：

  1. 合并到主分支：直接合并 feature/todo-app 到 main
  2. 创建 Pull Request：创建 PR 进行团队审查
  3. 保留分支：继续在此分支上工作
  4. 丢弃分支：删除此分支和工作树

你：创建 PR

AI：

# 创建 PR
gh pr create --title "Add todo app feature" --body "实现了待办事项管理功能"

# 清理工作树
git worktree remove ../todo-app-feature

Superpowers 的优势

通过上面的实战演示，我们可以看到 Superpowers 的几个核心优势：

1. 强制工程化思维

AI 不再是"写代码机器"，而是遵循完整的软件工程流程。这意味着生成的代码质量更高，可维护性更好。

2. 自动化质量保证

每个环节都有内置的质量检查，从需求澄清到代码审查，确保最终交付的软件符合标准。

3. 可扩展的技能系统

Superpowers 的技能系统是开放的，你可以根据需要添加自定义技能，扩展 AI 的能力。

4. 平台无关

Superpowers 可以在多个平台上使用，包括 Claude Code、Cursor、Codex、OpenCode、Gemini CLI 等。

如何安装和使用

Superpowers 的安装非常简单，支持多种平台：

Claude Code 官方市场

/plugin install superpowers@claude-plugins-official

Claude Code（通过插件市场）

# 注册市场
/plugin marketplace add obra/superpowers-marketplace

# 安装插件
/plugin install superpowers@superpowers-marketplace

Cursor

在 Cursor Agent 聊天中：

/add-plugin superpowers

Gemini CLI

# 安装
gemini extensions install https://github.com/obra/superpowers

# 更新
gemini extensions update superpowers

总结

Superpowers 不仅仅是一个工具，它代表了一种新的 AI 辅助开发范式。通过将软件工程的最佳实践封装成可组合的技能，它让 AI 代理能够像经验丰富的工程师一样思考和行动。

核心要点：

  1. 在写代码之前，先思考：Superpowers 强制要求进行需求分析和设计规划
  2. 小步快跑，持续验证：将大任务拆分成小任务，每个任务都有明确的验证步骤
  3. 质量优先：通过测试驱动开发和代码审查确保代码质量
  4. 自动化流程：技能自动触发，无需手动干预

适用场景： - 个人项目开发 - 快速原型验证 - 学习软件工程最佳实践 - 提高 AI 编程工具的输出质量

如果你也在使用 AI 编程工具，强烈建议试试 Superpowers。它可能会彻底改变你与 AI 协作的方式，让开发过程更加高效、更加规范。