Superpowers 工作流框架：让 AI 编程助手按工程规范做事

Superpowers 是一个开源的 Claude Code 插件，包含 14 个结构化技能，强制 AI 编程助手按完整的软件工程流程工作—— 先澄清需求、再设计方案、拆解为可验证的小步、用 TDD 实现、最后独立审查。 它解决的核心问题是：AI 倾向于"直接动手写代码"，跳过设计和验证环节。

一、安装

方式一：官方市场（推荐）

方式二：Superpowers 自有市场

安装后重启 Claude Code 即可。输入 / 能看到以 superpowers: 开头的命令列表。

二、技能概览

14 个技能按开发阶段分为五组。Superpowers 的 using-superpowers 元技能充当路由器， 自动判断当前处于哪个阶段、应该触发哪个技能，不需要手动指定。

2.1 设计阶段

2.2 计划阶段

2.3 实现阶段

2.4 验证阶段

2.5 元技能

三、code-review 技能详解

3.1 requesting-code-review

任务完成后自动调度一个独立的审查子 Agent。审查者不参与实现过程，因此能发现实现者可能忽略的问题。

审查输入：git SHA 范围 + 需求描述 + 实现笔记。审查输出按严重度三级分类：

• Critical：功能缺失、逻辑错误、安全漏洞。阻塞合并。
• Important：可维护性问题、不一致的命名、缺少边界处理。建议修复后再合并。
• Minor：格式问题、未使用的 import、可选的性能优化。

3.2 receiving-code-review

审查反馈回来后，这个技能约束 Claude 的回应方式。两条硬规则：

• 禁止盲从：收到审查建议后必须先验证代码是否确实需要修改，再决定是否采纳。不允许直接说"你说得对"然后照改。
• YAGNI 优先：审查者说"可以扩展这个功能支持 X"，但如果当前没有调用方，删除多余代码而非扩展。

两级审查的设计要点在于：审查者是独立子 Agent，它不继承主会话的实现过程，因此判断不受实现过程的影响。 这与在同一个会话中让 Claude "自己审查自己的代码"有本质区别——后者无法消除实现过程中的盲区。

四、实际使用

4.1 触发方式

Superpowers 的技能按需自动触发，不需要手动调用。当你描述一个任务时，using-superpowers 元技能判断当前阶段并激活对应的子技能。

也可以手动指定：

4.2 典型工作流

一次完整的 Superpowers 开发流程：

1. 描述需求 → brainstorming 启动，逐层细化，产出设计文档
2. 设计确认 → writing-plans 将设计拆为微任务列表
3. 计划确认 → using-git-worktrees 创建隔离分支
4. 开始实现 → test-driven-development 强制先写测试
5. 每个微任务 → subagent-driven-development 派发独立子 Agent
6. 全部完成 → requesting-code-review 两级审查
7. 审查通过 → finishing-a-development-branch 清理分支，准备合并

五、与 HUD 的关系

Claude HUD 和 Superpowers 互不冲突，解决的是不同层面的问题：

同时安装时，HUD 的状态行会显示 Superpowers 技能触发的工具活动（如"◐ brainstorming: 细化需求"）和子 Agent 进度。

六、适用场景

七、验证

安装后逐条确认：

1. 输入 /，能看到 superpowers:brainstorm 等命令
2. 描述一个开发需求（如"给首页加一个搜索框"），Claude 在动手前先询问设计细节——说明 brainstorming 已触发
3. 让 Claude 完成一个小改动后，它主动提议进行代码审查——说明 requesting-code-review 已触发