Superpowers:让 AI 编码 Agent 从编码助手变成工程搭档

上周一个朋友跟我吐槽："Claude Code 写代码确实快，但从来不写测试、不问需求就开干、遇到 Bug 瞎猜一通……像极了一个不靠谱的实习生。
关于这个问题，89K Star 的 Superpowers 框架用一种优雅的方式解决了。

Superpowers 可以解决什么问题？

你有没有这种体验：让 AI Agent 实现一个功能，二话不说就开始写代码——不问你想要什么，不写 spec，不考虑架构，更不会先写测试。代码看起来"能跑"，但维护起来是灾难。

问题的根源不是模型能力不够。大语言模型被训练为"尽可能有帮助"，实际执行时就变成了"尽快产出结果"。问这个问题的 Jesse Vincent（Perl 6 前项目经理、Keyboardio 联合创始人、K-9 Mail 作者）花了几个月琢磨出一个洞察：AI Agent 不缺能力，缺的是纪律。

核心能力

•Brainstorming（头脑风暴）：——不写 spec、用户不批准，绝不动手写代码。强制 Agent 先探索上下文、问澄清问题、给出 2-3 种方案

•Writing Plans（写实施计划）：把工作拆成每个 2-5 分钟的小任务，包含精确文件路径、完整代码上下文、验证步骤。假设执行者"零上下文 + 品味堪忧"

•Test-Driven Development（铁律 TDD）：没有失败测试就不许写产品代码。先写了代码？删掉重来，没有例外

•Systematic Debugging（系统化调试）：四阶段流程——根因调查 → 假设形成 → 定向修复 → 验证。铁律：不调查根因不许动手修

•Subagent-Driven Development（子 Agent 驱动）：每个任务分派全新 Agent 执行，两阶段审查（spec 合规 + 代码质量），Claude 能自主工作数小时不偏离计划

•Code Review（代码审查）：独立 Agent 审查，不带实现者的上下文偏见，按严重度分级报告

•Cross-Agent Compatibility（跨平台兼容）：Claude Code、Cursor、Codex、Gemini CLI、OpenCode 全支持，因为技能本质就是 Markdown 文件

架构思想：为什么能让 Agent "自觉遵守纪律"？

graph TB    subgraph 触发层        A[用户发起任务]    end    subgraph 规划层        B[Brainstorming 头脑风暴]        C[Writing Plans 实施计划]    end    subgraph 执行层        D[Subagent-Driven Dev 子Agent执行]        E[Test-Driven Dev TDD铁律]    end    subgraph 质量层        F[Code Review 代码审查]        G[Systematic Debugging 系统调试]    end    subgraph 交付层        H[Finishing Branch 完成交付]    end    A --> B --> C --> D    D --> E --> F --> H    F -->|发现问题| G --> E

设计精髓在于"铁律"（Iron Law）机制：

1硬门禁而非软建议：TDD 技能不是"建议写测试"，而是"没有失败测试就写了代码？删除它，重新来过"。这就像限速牌 vs 减速带——一个提醒，一个物理阻止

2上下文隔离防漂移：每个子 Agent 从零开始，只接收当前任务描述，不继承前序对话历史。防止累积上下文导致判断力退化

3技能链式触发：Brainstorming 产出 Spec → Spec 输入 Plan → Plan 驱动 Subagent → Subagent 遵循 TDD → Code Review 兜底。每个技能的输出就是下一个技能的输入

Superpowers 快速上手

Claude Code（官方市场，一行搞定）：

/plugin install superpowers@claude-plugins-official

Cursor：

/add-plugin superpowers

Gemini CLI：

gemini extensions install https://github.com/obra/superpowers

Codex CLI：

/plugins

安装完毕后，无需任何额外操作。开个新会话，直接说"帮我实现一个功能"——Agent 会自动触发 Brainstorming 开始问你问题，而不是直接写代码。技能全自动触发，零学习成本。

Star 增长趋势

2026 年 1 月首次进入 GitHub Trending 就单日涨超 1500 Star，5 个月内从 0 飙到 89,000+ Star，成为开发者工具领域增长最快的项目之一。

核心驱动力：AI 编码 Agent 用户的爆发式增长 + "装了就有效"的零成本体验。

适用场景

1日常 Feature 开发：启动项目后 Agent 自动走 Brainstorming → Plan → TDD 全流程，产出代码自带完整测试套件。chardet 7.0.0 就是用 Superpowers 交付的——41 倍性能提升、96.8% 准确率、覆盖 2161 个文件的测试

2复杂 Bug 修复：Systematic Debugging 强制根因分析，避免"改了表面症状、引入更多 Bug"的恶性循环。特别适合多线程、异步、分布式场景的诡异问题

3团队协作标准化：跨平台兼容意味着团队里用 Claude Code 的、用 Cursor 的、用 Codex 的，都跑同一套流程。技能就是 Markdown 文件，放 Git 仓库里版本管理

4自定义扩展：内置 writing-skills 元技能教 Agent 如何写新技能。部署检查清单、ADR 文档、安全审计——都能编码成 Skill 自动执行

写在最后

Superpowers 不是魔法棒，不会让错误的架构变正确。但是做的事更朴素也更关键：确保那些因为赶工、跳步骤、不问问题而犯的"低级错误"不再发生。对大多数项目来说，这些低级错误恰恰是成本最高的。

如果你用 AI 编码 Agent 时曾想过 "要是能慢下来、按规矩办事就好了"——Superpowers 就是那个答案。

项目地址：https://github.com/obra/superpowers
作者：Jesse Vincent
语言：Markdown（技能定义）
License：MIT 兼容：Claude Code / Cursor / Codex CLI / Gemini CLI / OpenCode / Factory Droid
觉得有用，点个 Star 支持作者继续维护 👇