把 AI 从"聪明的代码生成器"变成"懂规矩、有条理的初级工程师"
一、什么是 obra/superpowers？
obra/superpowers 是一个为 AI 编程代理（主要是 Claude Code）设计的代理技能框架（Agentic Skills Framework）和软件开发方法论。
简单来说，它是一套给 AI 编程助手安装的"插件"或"技能包"，目的是让 AI 在写代码时遵循更专业、更系统的软件工程流程，而不是随意的"想到哪写到哪"。
二、核心功能与做法
这个项目的核心思想是**"通过技能（Skills）来约束和引导 AI 的行为"**。它包含了一系列预设的标准化工作流：
测试驱动开发 (TDD)
强制 AI 遵循"红-绿-重构"的循环，必须先写测试，再写代码让测试通过。
系统化调试 (Systematic Debugging)
在修复 Bug 前，强制 AI 执行根因分析（Root Cause Analysis），而不是盲目尝试修复。
头脑风暴与规划 (Brainstorming & Planning)
在开始写代码前，先与用户讨论设计方案，制定详细的实施计划。
完成前验证 (Verification Before Completion)
在提交任务前，必须运行验证命令，确保代码真的能跑通。
三、工作原理
它从你启动编程代理的那一刻就开始工作。当代理发现你正在构建 something 时，它不会直接跳进去尝试写代码。相反，它会后退一步，询问你真正想要做什么。
一旦通过对话梳理出需求规格，它会以足够短的块展示给你，让你真正能够阅读和消化。
在你签核设计方案后，代理会制定一份足够清晰的实施计划——清晰到即使是一个热情高涨但品味欠佳、缺乏判断力、没有项目背景、且讨厌写测试的初级工程师也能遵循。它强调真正的红/绿 TDD、YAGNI（你不会需要它）和 DRY 原则。
接下来，当你说"开始"后，它会启动一个子代理驱动的开发流程，让代理逐个处理每项工程任务，检查和审核它们的工作，然后继续前进。Claude 连续自主工作几个小时而不偏离你制定的计划，这并不罕见。
四、适用场景
这个项目主要适用于希望 AI 编程助手更加靠谱、专业、可控的场景：
1. 复杂功能的开发与重构
- 当你需要 AI 处理涉及多个文件的复杂需求时，它的
/plan 和 /brainstorm 技能可以防止 AI 迷失方向 - 适用于大型代码库的维护，通过系统化的规划减少引入新 Bug 的风险
2. 提高代码质量与稳定性
- 如果你希望 AI 产出的代码不仅仅是"能跑"，而是经过测试验证的，这个框架的 TDD 技能非常有用
3. 解决棘手的 Bug
- 当遇到深层 Bug 时，系统化调试技能会引导 AI 一层层追踪调用栈，而不是直接修改表面症状
4. 减少"保姆式"提示
- 如果你厌倦了每次都要提醒 AI "请先写测试"、"请检查一下有没有错"，安装这个工具后，AI 会自动默认遵守这些最佳实践，减少了用户的认知负担
5. 团队流程标准化
- 对于使用 AI 辅助编程的团队，可以通过配置统一的技能包，让所有人的 AI 助手都遵循相同的代码审查和开发规范
五、基础工作流程
brainstorming（头脑风暴）
在编写代码之前激活。通过提问精炼粗略的想法，探索替代方案，分段展示设计以供验证。保存设计文档。
using-git-worktrees（使用 Git 工作树）
设计批准后激活。在新分支上创建隔离的工作空间，运行项目设置，验证测试基线的干净状态。
writing-plans（编写计划）
有了批准的设计后激活。将工作分解成小块任务（每个 2-5 分钟）。每个任务都有精确的文件路径、完整的代码和验证步骤。
subagent-driven-development / executing-plans（子代理驱动开发/执行计划）
有了计划后激活。为每个任务分派新的子代理，进行两阶段审查（先是规格合规性，然后是代码质量），或以批次方式执行并设置人工检查点。
test-driven-development（测试驱动开发）
实施期间激活。强制执行红-绿-重构：写失败的测试，观察它失败，写最少的代码，观察它通过，提交。删除在测试之前编写的代码。
requesting-code-review（请求代码审查）
在任务之间激活。根据计划进行审查，按严重性报告问题。关键问题会阻止进度。
finishing-a-development-branch（完成开发分支）
任务完成时激活。验证测试，呈现选项（合并/PR/保留/丢弃），清理工作树。
代理在执行任何任务之前都会检查相关技能。这是强制性的工作流程，不是建议。
六、技能库详解
测试类
调试类
- systematic-debugging - 4 阶段根因分析流程（包含根因追踪、纵深防御、条件等待技术）
- verification-before-completion
协作类
- brainstorming
- writing-plans
- executing-plans
- dispatching-parallel-agents
- requesting-code-review
- receiving-code-review
- using-git-worktrees
- finishing-a-development-branch
- subagent-driven-development
元技能
- writing-skills
- using-superpowers
七、安装指南
注意：安装方式因平台而异。Claude Code 有内置的插件系统，Codex 和 OpenCode 需要手动设置。
Claude Code（通过插件市场）
首先注册市场：
/plugin marketplace add obra/superpowers-marketplace
然后从市场安装插件：
/plugin install superpowers@superpowers-marketplace
验证安装是否成功：
/help
# 应该能看到：
# /superpowers:brainstorm - 交互式设计精炼
# /superpowers:write-plan - 创建实施计划
# /superpowers:execute-plan - 分批执行计划
Codex
告诉 Codex：
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
OpenCode
告诉 OpenCode：
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
更新
插件更新时技能会自动更新：
/plugin update superpowers
八、核心理念
九、Claude Skills 的四大核心特性
在了解 Superpowers 框架的同时，我们也需要理解 Claude Skills 的设计理念：
1. 可组合 (Composable)
Claude 可以同时叠加使用多个技能来处理复杂任务。
2. 可移植 (Portable)
一次构建，到处使用（从 Web 端到 API）。
3. 高效 (Efficient)
Claude 会智能判断当前任务需要哪个技能，按需加载，不会被无关信息拖慢。
4. 强大 (Powerful)
技能包中可以包含可执行代码，这对于需要精确计算或特定格式输出的任务非常有用。
十、实际应用案例
| |
|---|
| Box | 将文档自动转换为符合公司模板的 PowerPoint 演示文稿 |
| Notion | 通过预设程序，让 AI 输出的结果更加可预测和稳定 |
| Canva | 嵌入品牌设计规范，让 AI 生成符合品牌调性的视觉素材 |
| 金融领域 | 通过自定义技能处理复杂的电子表格和错误检查，将原本需要一整天的工作缩短到一小时 |
总结
obra/superpowers 就是给你的 AI 程序员发了一本**《软件工程最佳实践手册》**并强制它执行。
它把 Claude Code 从一个"聪明的代码生成器"变成了一个"懂规矩、有条理的初级工程师"。
如果你希望 AI 编程助手更加靠谱、专业、可控，不妨试试这个框架！
项目地址：https://github.com/obra/superpowers
如果这篇文章对你有帮助，欢迎点赞、在看、转发！
10个月宝宝每天需要喝多少奶粉？
