乐于分享
好东西不私藏

我把 AI 助手武装成了高级开发工程师,效率翻了 10 倍

我把 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 编码平台:

平台
安装方式
Claude Code
插件市场
Cursor
插件市场
Codex
Git clone + 符号链接
OpenCode
插件配置
Gemini CLI
扩展安装
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 前置条件

要求
说明
OpenClaw
已安装并配置完成
Node.js
18+
Git
已安装
工作区
~/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 /"$env:USERPROFILE\.openclaw\skills\superpowers""$env:USERPROFILE\.openclaw\superpowers\skills"# 重启 OpenClawopenclaw gateway restart

3.4 从旧版本迁移

如果你之前通过其他方式安装了 Superpowers,需要:

  1. 更新仓库

    cd ~/.openclaw/superpowers &&git pull
  2. 创建符号链接(见 Step 2)

  3. 删除旧的 bootstrap 配置

    • 检查~/.openclaw/AGENTS.mdSOUL.md
    • 移除任何引用superpowers bootstrap的配置块
  4. 重启 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