面向用户

Superpowers 开发工程技能指南

了解 14 个专业开发技能如何让 AI 像软件工程师一样工作

一句话说明

Superpowers 是 14 个专业开发技能的集合 —— 让 AI 助手能够像专业软件工程师一样工作，每个技能都是一个工作流程规范，确保 AI 在特定场景下采用最佳实践。

💡

核心理念

不是让 AI 写得更快，而是让 AI 工作得更专业。

🎯

专业化

让 AI 像专业工程师一样工作

每个场景都有规范可循

🔍

透明化

每个步骤都可见、可理解

随时知道 AI 在做什么

✅

质量化

测试、审查、验证保证质量

交付的都是可靠代码

🎛️

可控化

用户随时可介入、调整、决策

控制权永远在你手中

应用场景

🎬 四大应用场景

了解在什么情况下使用什么技能组合

你想开发一个新功能

💬

"我想给网站加一个用户登录功能"

使用的技能组合

brainstorming → writing-plans → using-git-worktrees → subagent-driven-development → TDD → verification → finishing

工作流程

brainstorming

AI 先和你讨论设计方案（不会直接写代码）

writing-plans

把批准的设计写成详细实现计划

using-git-worktrees

创建隔离的开发环境

subagent-driven-development

子代理按计划实现功能

test-driven-development

每个功能先写测试再实现

verification-before-completion

完成前验证所有测试通过

finishing-a-development-branch

询问你如何集成（合并/PR/保留）

用户收益

✅ 设计方案先讨论，避免做错方向
✅ 实现过程透明，可随时查看进度
✅ 质量有保证，每个功能都有测试
✅ 完成有验证，不会说"应该好了"

程序出 Bug 了

💬

"这个功能报错了，帮我看看"

使用的技能组合

systematic-debugging → TDD → verification → finishing

工作流程

systematic-debugging

AI 系统化调查根本原因（不是瞎猜）

读取错误信息
重现问题
检查最近的更改
收集证据形成假设

test-driven-development

先写一个会失败的测试，再修复

确保问题可重现
修复后测试通过
防止回归

verification-before-completion

验证修复有效

运行完整测试套件
确认退出码为 0
才说"修复完成"

用户收益

✅ 找到根本原因，不是症状修复
✅ 修复有测试保护，不会再次出错
✅ 验证后才交付，不会说"应该好了"

你要做一个大项目

💬

"我想做一个完整的电商网站"

使用的技能组合

brainstorming → writing-plans → subagent-driven → dispatching-parallel-agents → code-review → verification

工作流程

brainstorming

探索需求，提出架构方案

writing-plans

拆分成小任务（每个 2-5 分钟）

subagent-driven-development

子代理逐个实现任务

dispatching-parallel-agents

独立任务并行处理

requesting-code-review

关键代码请求审查

verification-before-completion

最终验证

用户收益

✅ 大项目拆成小任务，可控
✅ 并行处理，速度快
✅ 代码有审查，质量高
✅ 最终有验证，可交付

你想学习如何写代码

💬

"教我怎么用 TDD 开发"

使用的技能组合

TDD + executing-plans

AI 会做什么

解释 TDD 的红 - 绿 - 重构循环

理论学习

演示如何先写失败测试

实践示范

演示如何最小实现

实践示范

演示如何重构

实践示范

让你实践，给反馈

互动学习

用户收益

✅ 边做边学，不是纯理论
✅ 有最佳实践示范
✅ 实时反馈和纠正

技能详解

🔧 14 个技能详解

每个技能的核心理念、工作原理和用户收益

📋

using-superpowers

基础技能

核心理念

如果有 1% 的可能性某个技能适用于你正在做的事情，你绝对必须调用该技能。

💼 工作原理

每次会话开始时自动检查
识别当前任务可能适用的技能
调用 Skill 工具获取详细指令
精确遵循技能规范

👀 用户看到的效果

AI："我将使用 using-superpowers 技能来确保遵循最佳实践。
     检测到当前任务可能适用 brainstorming 技能，正在调用..."

⭐ 为什么重要

✅ 确保 AI 不会"凭感觉"工作
✅ 每个场景都有规范可循
✅ 避免跳过重要步骤

🧠

brainstorming

设计阶段

核心理念

在展示设计并获得用户批准之前，不得调用任何实现技能、编写任何代码。

💼 工作原理

探索项目上下文（读文档、看代码）
提出澄清问题（一次一个，不轰炸）
提出 2-3 种方法（含权衡分析）
展示设计部分（逐个确认）
编写设计文档
规范审查循环
用户审查规范
调用 writing-plans

👀 用户看到的效果

AI："在开始实现之前，我想先确认几个问题：

问题 1/5：这个功能需要支持第三方登录吗？
        A) 只需要邮箱密码
        B) 需要微信/Google 登录
        C) 两种都要

（等你回答后再问下一个问题）"

❌ 错误做法

"这太简单了不需要设计" → 直接写代码
一次性问 5 个问题 → 用户困惑
设计没批准就写代码 → 可能做错

✅ 正确做法

再简单的功能也先设计
一次一个问题
用户批准后才实现

⭐ 用户收益

✅ 方向正确，不会做错
✅ 理解设计决策
✅ 可随时调整需求

📝

writing-plans

规划阶段

核心理念

为代理工程师编写计划，假设他们对代码库零上下文且判断力可疑。

💼 工作原理

范围检查 - 拆分子系统
文件结构设计 - 精确到文件路径
任务拆分 - 每个任务 2-5 分钟
计划审查循环 - 自我验证
执行交接 - 给实现子代理

👀 用户看到的效果

AI："我已将实现计划写入 `plans/feature-login.md`

计划包含：
- 12 个任务（预计 45 分钟完成）
- 每个任务有完整代码示例
- 每个任务有验证命令

你要现在审查计划，还是直接开始执行？"

⭐ 用户收益

✅ 透明，知道 AI 要做什么
✅ 可审查，可调整
✅ 可追踪，知道进度

🌳

using-git-worktrees

执行

核心理念

系统化目录选择 + 安全验证 = 可靠隔离

💼 工作原理

选择目录（.worktrees > worktrees > 询问用户）
验证忽略状态（确保 git 不会追踪）
创建工作树（git worktree add）
运行项目设置（npm install 等）
验证测试基线

⭐ 用户收益

✅ 开发环境隔离，不会弄乱主工作区
✅ 可同时开发多个功能
✅ 随时可丢弃，无副作用

🤖

subagent-driven-development

执行

核心理念

每个任务新鲜子代理 + 两阶段审查（规范然后质量）= 高质量，快速迭代

💼 工作原理

⭐ 用户收益

✅ 每个任务独立，不会累积错误
✅ 双重审查，质量高
✅ 进度透明，实时可见

▶️

executing-plans

执行

核心理念

有计划，按部就班执行，不跳步。

💼 工作原理

读取计划文档
逐任务执行
每个任务完成后验证
记录进度

⭐ 使用场景

小项目（不需要子代理）
用户想亲自参与实现
调试/学习场景

🧪

test-driven-development

质量

铁律

没有根本原因调查前不得修复
没有失败测试前不得写代码

💼 红 - 绿 - 重构循环

🔴 RED 编写失败测试

↓

验证失败（正确原因）

↓

🟢 GREEN 最小实现

↓

验证通过

↓

🔵 REFACTOR 清理代码

↓

重复下一个功能

❌ 红旗（AI 违规）

代码在测试前
测试后实现
"我已经手动测试了"
"TDD 是教条，我是务实"

⭐ 用户收益

✅ 每个功能都有测试保护
✅ 不会过度实现（YAGNI）
✅ 重构有安全感
✅ 回归测试防止倒退

🔍

systematic-debugging

质量

铁律

总是在尝试修复前找到根本原因。症状修复是失败。

💼 四个阶段

根本原因调查 - 读错误、重现、检查更改、收集证据
模式分析 - 找 work 示例、比较差异
假设和测试 - 形成假设、最小测试
实现 - 创建测试、修复、验证

⚠️ 注意

3+ 修复失败： 质疑架构，而非继续修复

⚡

dispatching-parallel-agents

质量

核心理念

独立任务并行处理 = 速度提升 N 倍

💼 工作原理

识别独立任务（无依赖关系）
调度多个子代理同时工作
各自完成后汇总
集成验证

⭐ 使用场景

多个独立 Bug 修复
多个页面同时开发
多个组件重构

📤

requesting-code-review

质量

核心理念

关键代码需要外部视角，避免盲点。

💼 工作原理

识别关键代码（核心逻辑、安全相关、复杂算法）
请求代码审查
接收反馈
实施改进
重新审查

⭐ 用户收益

✅ 代码质量更高
✅ 发现盲点
✅ 学习最佳实践

✔️

verification-before-completion

质量

铁律

没有新鲜验证证据前不得完成声明
证据永远先于断言

💼 门函数

1 识别：什么命令证明此声明？

→

2 运行：执行完整命令（新鲜、完整）

→

3 阅读：完整输出，检查退出码

→

4 验证：输出确认声明？

→

                                        5
                                        仅此之后：声明
                                    

❌ 错误（无验证）

AI："登录功能应该完成了，
我测试过可以工作。"

✅ 正确（有验证）

AI："验证登录功能完成...

运行测试套件：
$ npm test -- login

输出：
  ✓ 应该允许有效用户登录
  ✓ 应该拒绝无效密码
  ✓ 应该拒绝不存在用户
  ✓ 应该返回 JWT token

测试：4/4 通过
退出码：0

✓ 登录功能完成（已验证）"

❌ 红旗（AI 违规）

使用"应该"、"可能"、"似乎"
验证前表达满意（"完美！"）
信任代理成功报告（不自己验证）

⭐ 用户收益

✅ 完成是真的完成，不是"应该"
✅ 有证据，不是空口说
✅ 可信任，不会交付半成品

📥

receiving-code-review

协作

核心理念

接收反馈不防御，技术 rigor 优先于面子。

💼 工作原理

接收审查反馈
理解问题（不辩解）
实施改进
验证修复
重新提交审查

⭐ 用户收益

✅ 代码质量持续提升
✅ AI 不防御，愿意改进
✅ 学习审查文化

🏁

finishing-a-development-branch

完成

核心理念

验证测试 → 呈现选项 → 执行选择 → 清理

💼 工作原理

验证所有测试通过
呈现 4 个选项给用户
执行用户选择
清理（如需要）

🎯 4 个选项

🔄 本地合并 适合：确定要集成

📤 推送并创建 PR 适合：需要团队审查

📌 保持分支 适合：还想再看看

🗑️ 丢弃此工作 适合：方向错了重来

👀 用户看到的效果

AI："登录功能实现完成！

验证：
✓ 12 个测试全部通过
✓ 代码审查通过
✓ 无 lint 错误

如何集成此工作？

1️⃣ 🔄 本地合并到 main 分支
2️⃣ 📤 推送到 GitHub 并创建 PR
3️⃣ 📌 保持分支，稍后处理
4️⃣ 🗑️ 丢弃此工作

请选择（1-4）："

⭐ 用户收益

✅ 清晰的选择，不混淆
✅ 知道每个选项的后果
✅ 控制权在用户

✍️

writing-skills

元技能

核心理念

编写技能是应用于过程文档的测试驱动开发

💼 TDD 循环

🔴 RED 运行基线测试（无技能）

↓

记录代理违反和合理化

↓

🟢 GREEN 编写技能（解决特定违反）

↓

验证代理遵守

↓

🔵 REFACTOR 关闭漏洞

↓

重新测试直到防弹

⭐ 使用场景

创建新技能
编辑现有技能
部署前验证技能

最佳实践

🔄 技能组合模式

常见场景的技能组合使用方式

🆕

新功能开发

brainstorming → writing-plans → using-git-worktrees → subagent-driven-development → verification → finishing

从零开始构建新功能的完整流程

预计时间：根据复杂度（小功能 30 分钟，大功能 2-3 小时）

🐛

Bug 修复

systematic-debugging → TDD → code-review → verification → finishing

系统化调试到修复验证

预计时间：简单 Bug 10 分钟，复杂 Bug 1 小时+

⚡

并行调试

systematic-debugging → dispatching-parallel-agents → verification → finishing

多个独立问题同时解决

预计时间：单问题时间 / N（N = 并行代理数）

🔧

大规模重构

brainstorming → writing-plans → subagent-driven → review(each) → verification

多文件、多组件重构

预计时间：根据规模（1 小时 - 1 天）

工具

📋 快速参考卡

一目了然的技能速查表

技能	何时使用	关键输出
`using-superpowers`	会话开始时	技能调用确认
`brainstorming`	有任何想法/创意	批准的设计文档
`writing-plans`	有设计规范	可执行计划
`using-git-worktrees`	开始实现	隔离工作区
`test-driven-development`	实现任何功能	测试 + 实现
`systematic-debugging`	遇到 bug/失败	根本原因 + 修复
`verification-before-completion`	声称完成前	验证证据
`finishing-a-development-branch`	实现完成	合并/PR/清理

帮助中心

❓ 常见问题（FAQ）

您可能想知道的答案

A: 这是 brainstorming 技能的要求。先理解需求再实现，避免做错方向。每个问题都是为了确保设计方案正确。

A: Superpowers 技能要求先设计、再计划、后实现。这样确保方向正确、质量可控、过程透明。

A: 短期看可能慢 10-20%，但长期看 Bug 更少（节省调试时间）、重构更安全（节省维护时间）、文档即测试（节省文档时间）。

A: 可以，但不推荐。每个技能都是为了解决特定问题：跳过 brainstorming 可能做错方向，跳过 TDD 可能引入 Bug，跳过 verification 可能交付半成品。

A: 适合！技能是 scalable 的：小项目简化流程但保持核心（设计→实现→验证），大项目完整流程保证质量。

总结

💡 总结

记住

Superpowers 的目标是让 AI 像专业工程师一样工作。您只需要表达意图，AI 会遵循最佳实践完成所有工作。享受与您的 AI 开发伙伴的高效协作吧！ ⚡💪