我把 AI 助手武装成了高级开发工程师,效率翻了 10 倍
前言:你的 AI 助手是不是也这样?
你有没有遇到过这样的场景:
你:帮我写个用户登录功能AI:好的![直接开始 dumping 代码,没有任何前期分析]你:等等,我还没说要用什么认证方式...AI:抱歉,我重新写...[第二次还是没问清楚,又返工]你:算了,我自己来吧...
或者:
你:这个 bug 帮我修一下AI:修好了![你一测,根本没好]AI:呃...我再看看...[反复 5 轮,最后还是没解决]
问题出在哪里?
AI 很聪明,但它缺乏系统化的工作方法。它像一个才华横溢但毫无纪律的初级工程师——有热情,没流程;能写代码,不懂协作。
Superpowers就是为了解决这个问题而生的。
一、什么是 Superpowers?
1.1 项目简介
Superpowers是由Jesse Vincent创建的开源项目,它是一个完整的 AI 编码代理工作流框架,通过一系列可组合的「技能」(Skills),让 AI 助手具备专业的软件开发方法论。
项目地址:https://github.com/obra/superpowersStar 数:116k+许可证:MIT
1.2 核心理念
Superpowers 的核心哲学可以概括为:
AI 不应该直接写代码,而应该先思考、再计划、后执行、最后验证。
它强制 AI 遵循以下流程:
1. 头脑风暴(Brainstorming)→ 澄清需求2. 设计确认(Design Sign-off)→ 分块呈现设计文档3. 计划制定(Writing Plans)→ 拆解为 2-5 分钟的小任务4. 测试先行(TDD)→ 红 - 绿 - 重构循环5. 代码审查(Code Review)→ 两级审查(规格 + 质量)6. 分支收尾(Finishing Branch)→ 合并/PR/清理决策
1.3 支持的平台
Superpowers 原生支持多个 AI 编码平台:
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| OpenClaw | 手动安装(本教程重点) |
二、Superpowers 核心技能详解
Superpowers 包含 14 个核心技能,分为 4 大类:
2.1 协作类技能(Collaboration)
🧠 brainstorming(头脑风暴)
触发时机:用户表达模糊需求时
作用:用苏格拉底式提问澄清需求,避免「直接开写然后返工」的陷阱。
工作流程:
1. 提出澄清问题(功能、用户、技术栈、性能要求)2. 等待用户回答3. 生成设计文档草稿4. 分块呈现,逐块确认
示例对话:
用户:帮我做个用户管理系统AI(触发 brainstorming):在开始之前,我需要了解几个关键问题:1. 功能范围 - 需要支持注册、登录、权限管理吗? - 需要 OAuth(Google/GitHub)集成吗?2. 目标用户 - 内部系统还是面向公众? - 预计用户量级?3. 技术约束 - 有现有技术栈需要集成吗? - 数据库偏好(PostgreSQL/MySQL/MongoDB)?4. 非功能需求 - 性能要求? - 安全合规要求?请提供更多细节,我们先明确「做什么」,再决定「怎么做」。
📋 writing-plans(编写计划)
触发时机:设计文档确认后
作用:将设计拆解为可执行的任务清单。
计划特点:
-
每个任务 2-5 分钟完成 -
精确到文件路径 -
包含完整代码示例 -
附带验证步骤
输出示例:
## 实施计划### 任务 1:创建用户表- 文件:src/db/schema.ts- 代码:[完整 Schema 定义]- 验证:运行 `pnpm db:generate` 无错误- 预计时间:3 分钟### 任务 2:实现用户注册 API- 文件:src/app/api/users/register.ts- 代码:[完整 API 实现]- 验证:curl 测试返回 201- 预计时间:5 分钟### 任务 3:实现用户登录 API- 文件:src/app/api/users/login.ts- 代码:[完整 API 实现]- 验证:curl 测试返回 token- 预计时间:5 分钟
🤖 subagent-driven-development(子 Agent 驱动开发)
触发时机:用户说「开始」后
作用:为每个任务创建独立的子 Agent,实现自主开发。
子 Agent 工作流:
1. 读取任务 → 理解需求2. 编写测试 → TDD 红阶段3. 实现代码 → TDD 绿阶段4. 代码审查 → 两级审查5. 提交结果 → 任务完成
两级审查:
- 第一阶段
检查是否符合计划规格 - 第二阶段
检查代码质量(可读性、性能、安全)
📦 executing-plans(执行计划)
作用:批量执行任务,带人工检查点。
与 subagent-driven-development 的区别:
subagent-driven-development
每个任务一个子 Agent,全自动 executing-plans
批量执行,每 N 个任务暂停让人工确认
2.2 测试类技能(Testing)
🧪 test-driven-development(测试驱动开发)
触发时机:实现任何功能时
作用:强制执行 TDD 红 – 绿 – 重构循环。
流程:
RED(红) → 写一个失败的测试GREEN(绿) → 写最少的代码让测试通过REFACTOR(重构) → 重构代码,保持测试通过
拦截机制:如果 AI 试图先写实现代码,Superpowers 会阻止并要求回到 TDD 流程。
示例:
// 步骤 1:写测试(RED)describe('add',()=>{it('should add two numbers',()=>{expect(add(1,2)).toBe(3);// add 函数还不存在,测试失败});});// 步骤 2:写最少的代码通过测试(GREEN)functionadd(a:number, b:number):number{return a + b;}// 步骤 3:重构(如果需要)// 在保持测试通过的前提下优化代码
2.3 调试类技能(Debugging)
🔧 systematic-debugging(系统化调试)
触发时机:遇到 bug 时
作用:四阶段根因定位流程。
四阶段:
Phase 1: 定位(Locate) - 复现问题 - 缩小范围Phase 2: 分析(Analyze) - 收集日志 - 检查相关代码Phase 3: 假设(Hypothesize) - 列出可能原因 - 按概率排序Phase 4: 修复(Fix) - 验证假设 - 实施修复 - 回归测试
✅ verification-before-completion(完成前验证)
触发时机:AI 声称「修好了」「完成了」时
作用:确保问题真的解决了,而不是「看起来解决了」。
验证清单:
-
测试通过了吗? -
边界条件处理了吗? -
有回归测试吗? -
文档更新了吗?
2.4 Git 工作流技能
🌿 using-git-worktrees(使用 Git Worktrees)
触发时机:开始新功能开发时
作用:创建隔离的开发环境,支持并行开发。
工作流:
1. 创建新 worktree:`git worktree add -b feature/login ../login-worktree`2. 切换到 worktree 开发3. 完成后清理:`git worktree remove ../login-worktree`
🏁 finishing-a-development-branch(完成开发分支)
触发时机:所有任务完成后
作用:提供合并/PR/保留/丢弃的决策工作流。
选项:
- Merge to Main:测试全通过,直接合并
- Create PR:需要团队审查,创建 Pull Request
- Keep Branch:继续开发,保留分支
- Cleanup:删除分支和 worktree
2.5 代码审查技能
🔍 requesting-code-review(请求代码审查)
触发时机:任务完成后
作用:自动化代码审查。
审查清单:
-
功能完整性:计划的功能都实现了吗? -
代码正确性:逻辑正确吗?边界条件处理了吗? -
代码质量:命名清晰吗?函数太长吗?有重复代码吗? -
安全性:有 SQL 注入、XSS 等漏洞吗? -
性能:有明显的性能瓶颈吗?
严重性分级:
-
🔴Critical:必须修复才能合并 -
🟡Major:强烈建议修复 -
🟢Minor:改进建议
📥 receiving-code-review(接收代码审查)
作用:指导 AI 如何专业地处理审查反馈。
原则:
-
不敷衍、不辩解 -
逐条响应 -
无法立即修复的,说明原因和时间表
2.6 元技能
✍️ writing-skills(编写技能)
作用:教用户如何创建新的 Superpowers 技能。
输出:完整的 SKILL.md 模板和测试方法论。
📖 using-superpowers(使用 Superpowers)
作用:Superpowers 的入门指南,教 AI 如何发现和调用技能。
三、在 OpenClaw 中安装 Superpowers
3.1 前置条件
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
~/clawd/
|
3.2 安装步骤
Step 1:克隆 Superpowers 仓库
git clone https://github.com/obra/superpowers.git ~/.openclaw/superpowers
Step 2:创建技能符号链接
OpenClaw 通过skills/目录自动发现技能。创建符号链接:
mkdir-p ~/.openclaw/skillsln-s ~/.openclaw/superpowers/skills ~/.openclaw/skills/superpowers
验证:
ls-la ~/.openclaw/skills/superpowers
应该看到指向 superpowers 技能目录的符号链接。
Step 3:重启 OpenClaw Gateway
openclaw gateway restart
Step 4:验证安装
发送消息触发技能:
帮我规划一个用户登录功能
如果 Superpowers 正确安装,AI 应该自动触发brainstorming技能,开始提问澄清需求。
3.3 Windows 安装(PowerShell)
# 克隆仓库git clone https://github.com/obra/superpowers.git "$env:USERPROFILE\.openclaw\superpowers"# 创建技能目录New-Item-ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw\skills"# 创建符号链接(需要管理员权限)cmd /c mklink /J "$env:USERPROFILE\.openclaw\skills\superpowers""$env:USERPROFILE\.openclaw\superpowers\skills"# 重启 OpenClawopenclaw gateway restart
3.4 从旧版本迁移
如果你之前通过其他方式安装了 Superpowers,需要:
-
更新仓库:
cd ~/.openclaw/superpowers &&git pull -
创建符号链接(见 Step 2)
-
删除旧的 bootstrap 配置:
-
检查 ~/.openclaw/AGENTS.md或SOUL.md -
移除任何引用 superpowers bootstrap的配置块 -
重启 OpenClaw
3.5 更新 Superpowers
cd ~/.openclaw/superpowers &&git pull
由于使用符号链接,技能会即时更新,无需重启。
3.6 卸载
# 删除符号链接rm ~/.openclaw/skills/superpowers# 可选:删除克隆的仓库rm-rf ~/.openclaw/superpowers
四、实战演示:完整开发流程
场景:开发用户登录功能
阶段 1:头脑风暴
用户:帮我做个用户登录功能AI(触发 brainstorming):在开始之前,我需要了解几个关键问题:1. 认证方式 - 用户名 + 密码? - 邮箱 + 验证码? - OAuth(Google/GitHub)?2. 安全要求 - 需要 JWT 还是 Session? - 密码加密算法偏好(bcrypt/argon2)? - 需要双因素认证吗?3. 技术栈 - 后端框架(Express/NestJS/Fastify)? - 数据库(PostgreSQL/MySQL/MongoDB)?4. 额外功能 - 需要「记住我」功能吗? - 需要登录失败次数限制吗?请提供更多细节,我们先明确需求。
阶段 2:设计文档确认
AI:根据我们的讨论,这是设计文档的第一部分:## 1. 概述构建一个基于 JWT 的用户登录系统,支持用户名 + 密码认证。## 2. 功能列表- 用户登录(POST /api/auth/login)- JWT Token 生成和验证- 登录失败次数限制(5 次/小时)- 密码加密(bcrypt)这部分没问题吧?用户:没问题,继续。AI:好的,接下来是技术架构部分...[逐块确认,直到设计文档完成]
阶段 3:计划生成
AI(触发 writing-plans):## 实施计划### 任务 1:安装依赖- 命令:`npm install jsonwebtoken bcrypt express-validator`- 验证:`npm list` 显示已安装- 时间:2 分钟### 任务 2:创建用户模型- 文件:src/models/User.ts- 代码:[完整模型定义]- 验证:TypeScript 编译无错误- 时间:3 分钟### 任务 3:实现登录 API- 文件:src/routes/auth.ts- 代码:[完整路由实现]- 验证:curl 测试返回 200 + token- 时间:5 分钟### 任务 4:实现 JWT 中间件- 文件:src/middleware/auth.ts- 代码:[完整中间件实现]- 验证:受保护路由需要 token- 时间:4 分钟### 任务 5:编写测试- 文件:tests/auth.test.ts- 验证:`npm test` 全部通过- 时间:5 分钟可以开始了吗?用户:开始!
阶段 4:子 Agent 执行
AI(触发 subagent-driven-development):正在启动子 Agent 执行任务...[任务 1-2 完成]✅ 依赖安装完成✅ 用户模型创建完成[暂停点:每 2 个任务确认一次]前两个任务已完成,方向正确吗?用户:正确,继续。[任务 3-5 完成]✅ 登录 API 实现完成✅ JWT 中间件实现完成✅ 测试编写完成所有任务完成!
阶段 5:代码审查
AI(触发 requesting-code-review):## 代码审查报告### ✅ 功能完整性- 所有计划功能已实现### ✅ 代码正确性- 逻辑正确,边界条件已处理### ⚠️ 代码质量(Major)- `auth.ts` 函数过长(85 行),建议拆分### ✅ 安全性- 密码使用 bcrypt 加密- JWT 签名密钥从环境变量读取- 登录失败次数限制已实现### ✅ 性能- 无明显性能瓶颈建议:重构 `auth.ts` 后再合并。
阶段 6:分支收尾
AI(触发 finishing-a-development-branch):## 开发完成### 测试结果- 单元测试:15/15 通过- 集成测试:5/5 通过- 代码覆盖率:87%### 选项1. **Merge to Main**:测试全通过,可以直接合并2. **Create PR**:创建 Pull Request 让团队审查3. **Keep Branch**:保留分支继续开发4. **Cleanup**:删除分支和 worktree你想怎么处理?用户:创建 PR 吧。AI:好的,正在创建 PR...PR #42 已创建:https://github.com/your/repo/pull/42
资源链接
- Superpowers 官方仓库:https://github.com/obra/superpowers
- OpenClaw 官方文档:https://docs.openclaw.ai
夜雨聆风