第2篇：入门级——Superpowers：14个技能的流程框架
给AI配上项目经理和QA
2.1 概念：什么是Superpowers？
如果说Karpathy解决的是“AI怎么做”的行为纪律，Superpowers解决的是“AI怎么推进”的流程管理。
Superpowers由obra维护，提供14个核心skill，覆盖从头脑风暴到代码审查的完整开发流程。它像给AI配备了一个项目经理：强制你思考→写计划→写测试→审查→验证→收尾。
2.2 核心理念：技能库模式
Superpowers采用技能库（Skills）架构：
- 每个skill是一个
SKILL.md文件 - 定义该技能的角色、任务、步骤
- AI根据用户指令，按需调用相应skill
与Karpathy不同，Superpowers是主动调用的——你需要明确触发某个技能，而Karpathy是被动生效的——始终在后台。
2.3 核心Skills解析
Skill 1：brainstorming（头脑风暴）
作用：探索技术方案，对比优缺点。
使用场景：需求明确但不知道用什么技术实现。
输出示例：
markdown
## 方案A：LangChain + Yahoo Finance
- 优点：社区成熟，文档丰富
- 缺点：依赖重，学习曲线陡
## 方案B：轻量级顺序Agent
- 优点：5天可完成，每个模块独立
- 缺点：未来扩展需重构
## 方案C：现成框架OpenClaw
- 优点：零代码
- 缺点：不可追溯，无法定制
建议选方案B
Skill 2：writing-plans（写计划）
作用：将需求拆解为可执行的任务清单。
输出示例：
markdown
## 实施计划
- [ ] 1. 创建项目结构
- [ ] 2. 实现API调用模块
- [ ] 3. 添加错误处理
- [ ] 4. 编写单元测试
- [ ] 5. 集成到主流程
Skill 3：test-driven-development（TDD）
作用：强制先写测试，再写代码。
执行流程：
- 写一个失败的测试（RED）
- 运行测试确认失败
- 写最少代码让测试通过（GREEN）
- 运行测试确认通过
- （可选）重构
价值：杜绝“写了一大堆最后发现方向错了”。
Skill 4：requesting-code-review（代码审查）
作用：在关键节点进行质量审查。
审查维度：
- 是否符合需求？
- 代码是否简洁？
- 是否有测试覆盖？
- 是否影响其他模块？
Skill 5：verification-before-completion（验证后完成）
作用：确保“完成”不是口头声称，而是有证据。
要求：
- 必须运行测试
- 必须输出测试结果
- 只有通过才能标记完成
Skill 6：finishing-a-development-branch（收尾）
作用：规范分支收尾流程。
步骤：
- 确认所有测试通过
- 更新文档
- 决定合并/PR/保留
2.4 解决什么问题？
| 问题 | Superpowers如何解决 |
|---|---|
| 跳过设计直接写代码 | writing-plans强制拆解任务 |
| 不写测试 | test-driven-development强制RED-GREEN |
| 代码质量无保障 | requesting-code-review强制审查 |
| 虚假完成 | verification-before-completion强制验证 |
| 收尾不规范 | finishing-a-development-branch规范流程 |
2.5 安装方法
在Antigravity中安装
bash
# 克隆Superpowers仓库
git clone https://github.com/obra/superpowers.git ~/.antigravity/skills/superpowers
# 或在项目内创建软链接
ln -s ~/.antigravity/skills/superpowers .agent/skills/superpowers
调用方式
在Agent面板中输入：
text
@superpowers/test-driven-development
或直接说：
text
使用TDD方式实现fetch_news函数
2.6 验证是否生效
执行：
text
@superpowers/brainstorming
需求：做一个股票新闻检索系统
预期输出：3个技术方案的对比表格，而非直接写代码。
2.7 今天对话中的干货
为什么要主动调用而非自动触发？
问：为什么不把Superpowers做成自动触发？
答：Superpowers的设计哲学是按需启用。不是每个任务都需要full TDD，比如写一个临时调试脚本就没必要。但核心功能的开发，建议始终调用。
Skill与Workflow的关系
| 维度 | Skill | Workflow |
|---|---|---|
| 粒度 | 单个技能 | 技能的有序组合 |
| 例子 | test-driven-development | 先调用brainstorming→writing-plans→TDD→review |
| 复用性 | 可在多个workflow中调用 | 特定场景的完整流程 |
核心洞见
“Superpowers的本质是把‘最佳实践’变成‘可调用的函数’。”——每个skill封装了一个开发环节的最佳实践，AI只需调用，不需要重新理解。
