2.1.Superpowers
Superpowers 入门到精通:AI 编码的"工程操作系统"完全指南
一份从零开始的实战教程,目标:30 分钟跑通,半天入门,一周精通。

目录
- 第 0 章:在开始之前——你需要知道 Superpowers 到底是什么
- 第 1 章:环境准备(10 分钟跑通)
- 第 2 章:第一次握手——
/brainstorm(20 分钟) - 第 3 章:5 步工作流全景——Superpowers 的核心骨架
- 第 4 章:技能库全解——12 个核心 Skill
- 第 5 章:TDD 铁律——红绿重构实战
- 第 6 章:子代理驱动开发——大规模任务的并行化
- 第 7 章:跨平台安装——Codex / Cursor / OpenCode
- 第 8 章:进阶玩法——写你自己的 Skill
- 第 9 章:对比 gstack——两个项目怎么选
- 第 10 章:常见争议与陷阱
- 第 11 章:精通路径与学习资源
- 附录:初始化检查清单
第 0 章:在开始之前——你需要知道 Superpowers 到底是什么
0.1 一句话定义
Superpowers = 一套 Claude Code 插件,把"软件工程方法论"封装成可自动触发的 Skill,让你的 AI 编码代理像训练有素的工程师一样工作。
它不是:
- ❌ 新的 AI 模型
- ❌ 一组命令清单(虽然有
/superpowers:*命令) - ❌ 强调"角色扮演"的项目
它是:
- ✅ 核心是一组
SKILL.md(用户感知层都是 Markdown 方法论) - ✅ 但不是纯 Markdown 项目——为了让 Claude Code 之外的平台(Codex、Cursor、OpenCode 等)也用上,它带了一套跨平台适配层:
lib/skills-core.js(Node 核心库)、.opencode/plugins/superpowers.js(系统提示注入)、.codex/superpowers-codex(Shell bootstrap CLI)、hooks/(如find-polluter.sh)、agents/code-reviewer.md(独立角色定义)、tests/e2e/(真实的 Go + Svelte 端到端测试项目) - ✅ 强调自动触发(基于上下文,而非手动命令)
- ✅ 内置 TDD、YAGNI、DRY 三大工程原则
- ✅ MIT 开源,GitHub:https://github.com/obra/superpowers(145k+ stars)
0.2 谁搞出来的?
作者是 Jesse Vincent (@obra),资深开源贡献者,曾参与 Perl、PostgreSQL、Kubernetes 等核心项目维护。
和 gstack 的关键区别:
| Superpowers | gstack | |
|---|---|---|
| 驱动方式 | 技能驱动(Skills) | 角色驱动(Roles) |
| 触发方式 | 自动触发(上下文感知) |
手动命令(/plan-ceo-review 等) |
| 平台支持 | Claude Code、Codex、Cursor、OpenCode、Copilot、Gemini | 主要 Claude Code |
| 核心哲学 | Systematic over ad-hoc(系统优于临时) | Think → Plan → Build |
| 比喻 | "AI 工程师培训手册" | "AI 虚拟工程团队" |
一句话区分:
- Superpowers 让 AI 更像一个训练有素的工程师(能力内嵌)
- gstack 让 AI 看起来像一个组织良好的团队(流程外显)
0.3 核心 5 步工作流
任何任务都按这个顺序走:
brainstorm(头脑风暴)
↓ 设计文档确认
using-git-worktrees(隔离分支)
↓
writing-plans(编写计划)
↓
subagent-driven-development(子代理执行)
↓ TDD 铁律
finishing-a-development-branch(收尾交付)
0.4 三大工程原则
- TDD(Test-Driven Development):先写失败测试 → 写最小代码 → 重构
- YAGNI(You Aren't Gonna Need It):不写暂时不需要的功能
- DRY(Don't Repeat Yourself):不重复自己
0.5 适合谁?不适合谁?
| ✅ 适合 | ❌ 不适合 |
|---|---|
| 想让 AI 严格遵循工程流程的人 | 只想快速写个脚本的人(过度工程) |
| 中大型项目、重构、复杂功能 | 一次性 demo / 临时原型 |
| 团队需要统一编码规范 | 一个人 + 小项目 |
| 跨平台用户(Codex/Cursor 用户) | 不愿意被流程约束的人 |
0.6 你需要准备什么
| 项目 | 要求 |
|---|---|
| Claude Code | Pro/Max 订阅或 API Key |
| 或者 | Cursor / Codex / OpenCode 任一 |
| Git | 已装 |
| 项目 | 任意 Git 仓库 |
第 1 章:环境准备(10 分钟跑通)
1.1 装 Claude Code(若未装)
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | sh
claude --version
1.2 通过官方插件市场安装(推荐)
在 Claude Code 里输入:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
或者更简单的一行:
/plugin install superpowers@claude-plugins-official
1.3 验证安装
重启 Claude Code,输入:
/help
你应该看到这三个命令:
/superpowers:brainstorm - 交互式设计细化
/superpowers:write-plan - 创建实施计划
/superpowers:execute-plan - 批量执行计划
如果看到了,✅ 安装成功。
1.4 手动安装(备选)
如果插件市场有问题:
# 1. 克隆仓库
git clone https://github.com/obra/superpowers.git ~/.claude/plugins/cache/superpowers
# 2. Claude Code 会自动发现本地插件
# 重启 claude 即可
1.5 更新
/plugin update superpowers
第 2 章:第一次握手——/brainstorm(20 分钟)
2.1 不要直接说"帮我写代码"
Superpowers 最反直觉的地方:它不让 AI 直接写代码。
你输入:
帮我做一个用户登录功能
它会先停下来反问你,而不会直接动手。这就是 brainstorm skill 在起作用。
2.2 brainstorm 在做什么
它扮演一个苏格拉底式的导师,通过结构化提问帮你想清楚:
- 这是给谁用的?
- 解决什么痛点?
- 现有的替代方案是什么?为什么不够好?
- 验收标准是什么?
- 边界在哪里(MVP / 完整版)?
- 有哪些风险?
2.3 实战演练
输入:
/superpowers:brainstorm 我想做一个命令行工具,把 Markdown 文件转成带样式的 PDF
AI 会问(示例,实际取决于你的输入):
1. 目标用户是谁?(技术写作者?博客作者?普通用户?)
2. 用哪个 Markdown 引擎?(pandoc?markdown-it?marked?)
3. 需要哪些样式选项?(代码高亮?主题?字体?)
4. 平台支持?(macOS only / 跨平台?)
5. 性能要求?(单文件 / 批量?)
6. 验收标准?(转换时间?输出质量?)
每回答一个,它会分块展示设计,而不是一次性输出大段方案。等你确认后才进入下一步。
2.4 输出:设计文档
确认完所有问题后,brainstorm 会把设计保存为文档(通常在 .claude/designs/ 或项目根目录),里面包含:
- 目标用户
- 功能列表(MVP / 后续)
- 技术选型
- 数据模型
- 接口设计
- 验收标准
关键:这份文档是后续所有步骤的"事实来源",不要急着写代码,先确认它对。
第 3 章:5 步工作流全景——Superpowers 的核心骨架
完整流程图
┌──────────────────────────────────────────────────┐
│ 1. /superpowers:brainstorm │
│ 头脑风暴 + 设计文档 │
│ ↓ (设计确认) │
│ 2. using-git-worktrees │
│ 创建隔离分支(worktree) │
│ ↓ │
│ 3. /superpowers:write-plan │
│ 把工作拆成 2-5 分钟的小任务 │
│ ↓ (计划批准) │
│ 4. subagent-driven-development │
│ (或 /superpowers:execute-plan) │
│ 每个任务分配新子代理,两阶段审查 │
│ ↓ (期间强制 TDD) │
│ 5. finishing-a-development-branch │
│ 验证测试 + 合并 / PR / 保留 / 丢弃 │
└──────────────────────────────────────────────────┘
3.1 Step 1: brainstorming(已完成)
见第 2 章。核心:先想清楚再动手。
3.2 Step 2: using-git-worktrees
目的:不污染主分支,在隔离环境工作。
git worktree add ../myproject-feature feature/login
cd ../myproject-feature
为什么用 worktree 而不是普通分支?
- ✅ 可以同时跑多个分支(并行任务)
- ✅ 主分支始终保持可发布状态
- ✅ 不会因为某次实验搞坏主分支
AI 做的事:
- 创建 worktree
- 跑项目设置(
npm install等) - 验证测试基线干净
- 后续所有工作都在这里进行
3.3 Step 3: writing-plans
输入:/superpowers:write-plan
输出:plans/<feature-name>.md,包含:
# Task 1: 创建用户模型
- 文件: src/models/user.ts
- 验证: typecheck 通过 + 测试通过
- 预计耗时: 3 分钟
- 完整代码:
```typescript
export interface User { ... }
```
# Task 2: 实现密码哈希
- 文件: src/utils/hash.ts
- 验证: 单测覆盖 100%
- ...
# Task 3: ...
关键设计:
- 每个任务 2~5 分钟可完成(防漂移)
- 每个任务包含精确文件路径
- 每个任务给出完整代码(不是伪代码)
- 每个任务有验证步骤(如何知道完成了)
为什么要这么细?
- 子代理是 fresh context(见第 6 章),它们没"印象",必须给精确指令
- 细粒度任务 = 可验证 + 可回滚 + 可并行
3.4 Step 4: subagent-driven-development
输入:/superpowers:execute-plan(批量)或 subagent-driven-development(逐个)
核心机制:
- 主代理分配任务给全新子代理(每个任务一个)
- 子代理有 fresh context(不带历史包袱)
- 每个任务结束后,两阶段审查:
- 规范合规性(代码符合 plan 吗?)
- 代码质量(有没有反模式?)
- 关键问题会阻塞进度
3.5 Step 5: finishing-a-development-branch
输入:/finishing-a-development-branch 或 AI 自动调用
做的事:
- 跑全部测试,确保通过
- 提供选项:
- Merge:合并到主分支
- PR:创建 Pull Request
- Keep:保留 worktree 不动
- Discard:丢弃(worktree 删除)
- 清理 worktree
第 4 章:技能库全解——12 个核心 Skill
Superpowers 的核心资产是它的 Skill 库。下面是分类详解。
4.1 基础工作流(必学)
| Skill | 作用 | 何时用 |
|---|---|---|
| brainstorming | 苏格拉底式提问 + 设计文档 | 任何新功能 / 改动的起点 |
| using-git-worktrees | 创建隔离工作区 | 设计批准后,写代码前 |
| writing-plans | 任务拆解成 2-5 分钟步骤 | 设计批准后 |
| subagent-driven-development | 子代理逐任务执行 | 有 plan 后 |
| executing-plans | 批量执行 plan(带检查点) | 想保留更多控制时 |
| test-driven-development | 强制 TDD 铁律 | 实施任何功能时 |
| requesting-code-review | 对照 plan 做审查 | 每个任务完成后 |
| finishing-a-development-branch | 验证 + 合并选项 | 所有任务完成后 |
4.2 测试技能
| Skill | 作用 |
|---|---|
| test-driven-development | RED → GREEN → REFACTOR 循环 |
| test-anti-patterns | 识别和避免测试反模式(假测试、脆弱测试等) |
| verification-before-completion | 完成前必须验证(不轻信"完成了") |
4.3 调试技能
| Skill | 作用 |
|---|---|
| systematic-debugging | 4 阶段根本原因分析(假设 → 验证 → 修复 → 回归) |
| root-cause-tracing | 顺藤摸瓜找上游源头 |
4.4 协作技能
| Skill | 作用 |
|---|---|
| dispatching-parallel-agents | 同时调度多个子代理 |
| receiving-code-review | 接收 AI 给你的代码审查时如何回应 |
| writing-skills | 创建自定义 Skill(元技能) |
4.5 元技能
| Skill | 作用 |
|---|---|
| using-superpowers | Superpowers 本身的使用说明 |
| writing-skills | 编写自己的 Skill(最佳实践) |
4.6 项目的真实结构(不只是 Skill)
superpowers/
├── .claude-plugin/ # Claude Code 插件元数据
│ ├── plugin.json
│ └── marketplace.json
├── .codex/ # OpenAI Codex 适配层
│ ├── INSTALL.md
│ └── superpowers-codex # Shell bootstrap CLI(find-skills/use-skill/bootstrap)
├── .cursor-plugin/ # Cursor 插件定义
│ └── plugin.json
├── .opencode/ # OpenCode 适配层
│ └── plugins/
│ └── superpowers.js # JS:系统提示注入 + 技能目录注册
├── agents/ # Agent 角色定义
│ └── code-reviewer.md
├── hooks/ # Hook 脚本(如 find-polluter.sh)
├── lib/ # 跨平台共享逻辑
│ └── skills-core.js # Codex/OpenCode 共用的 Node 核心库
├── docs/
├── tests/ # 测试基础设施
│ ├── e2e/ # 真实 Go + Svelte 项目跑端到端验证
│ └── skill-tests/ # 技能触发测试(防止"朴素提示"无法触发)
└── skills/ # ⭐ 14 个核心 skill,用户感知层
├── brainstorming/
│ ├── SKILL.md # 主入口,Markdown 格式
│ ├── checklist.md # 检查清单(可选)
│ └── examples/ # 示例(可选)
├── test-driven-development/
│ └── SKILL.md # 包含 DOT/Graphviz 决策流程图
└── ...
关键认知:
- 用户主要打交道的是
skills/*/SKILL.md(方法论层) - 但要让这套方法论真的能跑在 6 个平台上,必须靠
.codex/、.opencode/、lib/skills-core.js这些适配层 - 想验证 skill 写得好不好,
tests/提供了测试驱动的开发流程——skill 本身也有"测试",这是 Superpowers 元层面的 TDD
SKILL.md 的标准结构:
---
name: brainstorming
description: 在做任何事之前,先和用户澄清意图
---
# 你必须做的事
1. 永远不要跳过这一步,除非用户明确说"跳过 brainstorm"
2. 通过提问细化模糊的想法
3. 每次只展示一个设计块,等用户确认
4. 把最终设计保存为文档
# 决策框架
- 如果用户给出了具体需求,先确认范围(MVP?)
- 如果用户没明确,问:谁会用?解决什么痛点?
- 探索至少 2 个替代方案
# 输出格式
设计文档必须包含:
- 目标用户
- 核心功能(MVP)
- 后续功能(可选)
- 技术选型 + 理由
- 数据模型
- 验收标准
# 不要做的事
- 不要直接跳到写代码
- 不要一次展示所有内容
- 不要假设用户已经想清楚了
第 5 章:TDD 铁律——红绿重构实战
Superpowers 最核心的"硬约束"之一:TDD 必须严格遵循。
5.1 三步循环
RED - 写一个失败的测试
GREEN - 写最少的代码让它通过
REFACTOR - 重构代码,保持测试通过
5.2 实战:为"用户密码哈希"写代码
Step 1: RED
// test/hash.test.ts
import { hashPassword } from '../src/utils/hash';
describe('hashPassword', () => {
it('应该返回不同的哈希值即使密码相同(因为 salt)', () => {
const h1 = hashPassword('secret');
const h2 = hashPassword('secret');
expect(h1).not.toBe(h2); // ← 故意失败
});
});
跑测试:npm test → 失败(因为 hash 函数还没写)。
Step 2: GREEN
写最少代码让它通过:
// src/utils/hash.ts
import bcrypt from 'bcrypt';
export function hashPassword(password: string): string {
return bcrypt.hashSync(password, 10);
}
跑测试 → 通过。✅
Step 3: REFACTOR
看代码有没有可改进的地方(命名、可读性、重复),改完后跑测试确保仍然通过。
5.3 TDD 反模式(必须避免)
| 反模式 | 为什么坏 | 怎么修 |
|---|---|---|
| 测试 mock 到测的是 mock 而不是代码 | 测试永远绿但代码是坏的 | 写集成测试,关键路径不 mock |
| 一个测试断言太多东西 | 失败时不知道哪里坏了 | 一个测试一个行为 |
| 测试依赖顺序 | 并行跑或单独跑会挂 | 每个测试独立 setup |
| 为了覆盖率写假测试 | 100% 覆盖但 0% 信心 | 测真实行为 |
| 先写实现再补测试 | 违反 TDD | 强制先写失败测试 |
5.4 TDD 的真实价值
不要以为 TDD 是"为了写测试"。它真正的价值:
- 设计先行:写测试时,你在想"这个函数怎么用",而不是"这个函数怎么实现"
- 回归保护:以后改东西,测试告诉你有没有破坏
- 文档作用:测试就是"这个函数应该做什么"的活文档
- 重构信心:有测试罩着,你敢大刀阔斧改
第 6 章:子代理驱动开发——大规模任务的并行化
6.1 什么是子代理?
子代理(subagent)是 Claude Code 启动的全新 agent 实例,它:
- 有独立的 context(不知道主代理的历史对话)
- 只能访问你给的工具和文件
- 完成后返回结果,主代理继续
6.2 为什么用子代理?
主代理的问题:
- 上下文会越来越长,开始"漂移"
- 太多任务挤在一个对话里,容易遗漏
- 失败重试成本高
子代理的好处:
- ✅ Fresh context,每次都是干净起点
- ✅ 任务边界清晰,失败容易重试
- ✅ 可以并行(节省时间)
- ✅ 审查机制独立
6.3 两阶段审查
每个子代理完成任务后,会有两个审查代理接力:
Phase 1: 规范合规性审查
- 代码和 plan 完全一致吗?
- 所有验收标准都满足了吗?
- 测试都通过了吗?
Phase 2: 代码质量审查
- 有没有反模式?
- 命名、抽象、可维护性?
- 有没有"看起来工作但很脆弱"的代码?
关键问题会阻塞进度(必须先解决),次要问题只是建议。
6.4 实战:并行开发 3 个功能
假设 plan 里有 3 个独立任务:
# Task 1: 用户注册 API
# Task 2: 用户登录 API
# Task 3: 用户登出 API
可以这样调度:
/dispatching-parallel-agents 启动 3 个子代理并行执行 Task 1/2/3
每个子代理:
- 读 plan 里对应任务
- 用 TDD 实现
- 跑测试
- 提交
主代理:
- 收集 3 个子代理结果
- 整合
- 整体跑回归
- 进入收尾
时间节省:3 倍(如果 API 是瓶颈)。
第 7 章:跨平台安装——Codex / Cursor / OpenCode
Superpowers 最大的优势之一:多平台通用。
7.1 Codex CLI
快速安装(在 Codex 里输入):
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
手动安装:
mkdir -p ~/.codex/superpowers
git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
# 创建符号链接让 Codex 发现
mkdir -p ~/.agents/skills
ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers
使用:
~/.codex/superpowers/.codex/superpowers-codex find-skills
~/.codex/superpowers/.codex/superpowers-codex use-skill superpowers:brainstorming
7.2 Cursor
在 Cursor 的 Agent 聊天里:
/plugin-add superpowers
7.3 OpenCode
告诉 OpenCode:
Clone https://github.com/obra/superpowers to ~/.config/opencode/superpowers,
then create directory ~/.config/opencode/plugin,
then symlink ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js
to ~/.config/opencode/plugin/superpowers.js, then restart opencode.
或者手动:
git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
mkdir -p ~/.config/opencode/plugin
ln -sf ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js ~/.config/opencode/plugin/superpowers.js
7.4 GitHub Copilot CLI
支持方式类似 Codex,通过 ~/.agents/skills/ 暴露 skill。
7.5 Gemini CLI
同样通过 skill 目录机制集成。
第 8 章:进阶玩法——写你自己的 Skill
8.1 为什么要写自己的 Skill?
默认 Skill 是通用最佳实践。但你的团队可能有特定规范:
- 特定框架的使用规范
- 特定命名约定
- 特定部署流程
- 特定安全审查要求
8.2 一个 Skill 的最小结构
skills/
└── my-team-conventions/
└── SKILL.md
8.3 SKILL.md 模板
---
name: my-team-conventions
description: 团队特定规范,任何修改 .ts/.tsx 文件时自动触发
---
# 角色
你是一个 [前端 / 后端 / 全栈] 工程师,严格遵循本团队的编码规范。
# 强制规范
## 文件结构
- 组件放 `src/components/`
- 工具函数放 `src/utils/`
- 类型定义放 `src/types/`
## 命名
- 组件: PascalCase
- 函数: camelCase
- 常量: UPPER_SNAKE_CASE
- 私有函数: 以下划线开头
## 测试
- 每个组件必须有 `*.test.tsx`
- 测试覆盖率不低于 80%
- E2E 测试用 Playwright
## 代码审查必查项
- 没有 TODO 注释留在代码里
- 没有 console.log
- 没有注释掉的代码
- 错误处理必须显式
# 不要做的事
- 不要用 any(除非加注释解释)
- 不要写超过 50 行的函数
- 不要在循环里 await
8.4 自动触发的秘密
Skill 能"自动触发"靠的是 description 字段。Claude Code 会基于当前任务的语义匹配 description,决定是否加载。
写好 description 的技巧:
- ✅ 明确触发场景:"任何修改 .ts/.tsx 文件时"
- ✅ 包含关键词:用户提到"测试"、"重构"、"性能"时
- ❌ 别太宽泛:"任何时候都用" → 会一直加载,污染 context
8.5 测试你的 Skill
写完后,试试触发场景:
重构 src/components/Button.tsx,加上 size 属性
如果 AI 自动开始按你的规范工作,说明 description 写得对。
第 9 章:对比 gstack——两个项目怎么选
你可能已经装了 gstack(我之前也写过它的教程)。两个项目能不能一起用?怎么选?
9.1 核心差异
| 维度 | Superpowers | gstack |
|---|---|---|
| 核心思想 | AI 应该按方法论工作 | AI 应该是虚拟团队 |
| 触发方式 | 自动(上下文感知) | 手动(显式命令) |
| 平台 | 6 个(Claude/Codex/Cursor 等) | 主要 Claude Code |
| 架构 | Markdown skills + JS/Shell 跨平台适配层 | TypeScript daemon + Markdown skills |
| 强项 | 流程纪律、TDD、子代理 | 角色视角、浏览器测试 |
| 弱项 | 没有真实浏览器测试 | 流程不够自动 |
9.2 选 Superpowers 如果…
- ✅ 你更在意执行质量(复杂后端 / 重构 / 大型项目)
- ✅ 你希望 AI 自动遵循流程,不用每次提醒
- ✅ 你跨平台(用 Codex 或 Cursor)
- ✅ 你想做 TDD 严格的工程实践
9.3 选 gstack 如果…
- ✅ 你更在意团队式决策(产品 / 架构 / 设计多视角)
- ✅ 你做 Web 应用,需要真实浏览器测试
- ✅ 你喜欢显式管理每个步骤
- ✅ 你常做独立项目 / 创业
9.4 组合使用(进阶)
两个不是互斥的。最强组合:
Superpowers 负责: 想清楚、做扎实(执行层)
- brainstorming
- writing-plans
- TDD
- 子代理
- code review
gstack 负责: 验真、交付(操作层)
- /plan-ceo-review (高层决策)
- /review (代码审查的另一个视角)
- /qa (真实浏览器测试)
- /ship (发布)
典型场景:
-
/superpowers:brainstorm想清楚需求 -
/superpowers:write-plan拆任务 - 子代理执行 + TDD
-
/review(gstack) 做独立视角审查 -
/qa(gstack) 做浏览器测试 -
/ship(gstack) 发布
如果你做的是复杂 Web 产品,这套组合非常厉害。
第 10 章:常见争议与陷阱
10.1 "太重了,我只是想写个小脚本"
确实,Superpowers 不适合 1 小时搞定的 demo。流程成本 > 收益。
判断标准:
- 任务 < 30 分钟 → 直接写
- 任务 30 分钟 ~ 2 小时 → brainstorm + 直接写
- 任务 > 2 小时 → 走完整 5 步
10.2 "AI 太严格了,我只是想… "
TDD 强制有时代价很大(UI 设计、探索性编程)。
解法:在 brainstorm 时明确说"这是一个实验性任务,不需要严格 TDD"。AI 会按你的意图调整。
10.3 "子代理失败了,怎么 debug"
子代理失败常见原因:
- Plan 不够细(给不出精确指令)
- 任务拆得太大(超过 5 分钟)
- 上下文依赖没传递
调试方法:
- 看子代理的返回(它会说明卡在哪)
- 调整 plan 重新分配
- 或者 fallback 到
executing-plans(批量执行而非子代理)
10.4 "和别的插件冲突"
装多个 skills 框架时,可能一个 skill 被两个项目都定义了。
解决:用职责分离原则:
- Superpowers 管"思考和流程"
- gstack 管"操作和验证"
- 别让两边都覆盖同一阶段
10.5 "AI 一直在反问我,我不耐烦"
Brainstorm 阶段 AI 会问很多问题。如果觉得太多:
- 用
/superpowers:brainstorm时输入更完整的初始需求 - 或者在 brainstorm 过程中说"其他方面按默认即可"
- AI 会尊重你的边界
10.6 心理陷阱:别把"完成"当"工作"
Superpowers 强调 verification-before-completion:
- ❌ "我觉得差不多了" → 不是完成
- ✅ "测试全过 + 审查通过 + 用户验收" → 完成
AI 倾向于说"完成了"。你的工作是不信,验证。
第 11 章:精通路径与学习资源
11.1 学习路线图
Day 1 (2 小时)
├─ 装环境,跑 /superpowers:brainstorm 一次
├─ 读 brainstorming 和 writing-plans 的 SKILL.md
└─ 完成一个真实小任务的 5 步流程
Week 1 (每天 30 分钟)
├─ 每天用一个新 skill
├─ 写一个自定义 skill
└─ 尝试 dispatching-parallel-agents
Week 2 (每天 1 小时)
├─ 跨平台测试(Codex / Cursor)
├─ 完整跑一个中等规模功能
├─ 和 gstack 组合使用
└─ 给团队做一次分享
Month 1
├─ 沉淀团队特定 skills
├─ 集成到 CI / PR 流程
└─ 总结内部最佳实践
11.2 推荐阅读(按优先级)
- 官方仓库:https://github.com/obra/superpowers(必读)
- 掘金:Claude Superpowers 结构化工作流插件(中文实战)
- CSDN:从 claude skills 到 superpowers 项目(源码分析)
- CSDN:Superpowers 与 gstack 深度解析(对比)
- No Priors 播客 obra 那期(英文访谈)
- 官方博客:superpowers.work(若有)
11.3 三个里程碑(完成 = 算精通)
- L1:完成一个真实功能,严格走完 5 步,记录每个步骤的耗时和卡点
- L2:写 3 个自定义 skill,被至少 2 个同事采用,处理 1 次跨平台问题
- L3:把 Superpowers 集成到 CI,PR 自动触发 brainstorming 和 TDD 检查
附录:初始化检查清单
## Superpowers 启动清单
### 环境
- [ ] Claude Code 已装且登录(或 Cursor/Codex/OpenCode)
- [ ] 插件市场已添加
- [ ] superpowers 已安装
- [ ] /help 能看到 3 个 /superpowers:* 命令
### 第一次跑通
- [ ] /superpowers:brainstorm 跑过一次真实需求
- [ ] 产出了设计文档
- [ ] 走过 git worktrees
- [ ] 走过 write-plan
- [ ] 子代理完成过至少 1 个任务
- [ ] finishing-a-development-branch 跑过
### 进阶
- [ ] 写过至少 1 个自定义 skill
- [ ] 至少用过 1 次 dispatching-parallel-agents
- [ ] 试过 TDD 严格流程
- [ ] 跨平台测试过(Codex / Cursor)
- [ ] 和 gstack 组合使用过(可选)
### 心法
- [ ] 记住:"先想清楚,再动手"
- [ ] 记住:"AI 说完成 ≠ 完成"
- [ ] 记住:"2-5 分钟拆任务,别让 AI 漂"
写在最后
Superpowers 是工具,但它背后是一种工程哲学:
Systematic over ad-hoc. 系统优于临时。
它的价值不在"提高速度",而在提高可预期性。
- 当你下班前让 AI 跑一个重构,明天回来它不会"忘了自己在干嘛"
- 当你让 AI 写支付代码,它不会跳过"先写测试"
- 当你让 5 个 AI 同时干活,它们不会互相污染 context
不要把它当"加速器",把它当"工程纪律的执行者"。
去用起来,改起来,写你自己的 skill 库。
——
版本:基于 Superpowers 2026 年 3 月发布版本撰写。 反馈:发现错漏或想补充实战案例,直接改这份文档就行。
- 本文作者:zhangxue
- 本文链接:https://lucksnow1989.github.io/article/21.机器学习/4.AI工程/2.1.Superpowers.html
- 版权声明:本文为本人原创文章,遵循 CC 4.0 BY-NC-SA版权协议,转载请附上原文出处链接和本声明。