obra/superpowers：把软件开发方法论打包成 Markdown

> 原文链接：https://github.com/obra/superpowers

一个反直觉的事实：方法论正在变成"代码"

2026 年的 AI 编码 Agent 有一个尴尬的现象：你给它一个任务，它立刻开始写代码。快是快，但写出来的东西经常是——没有测试、没有设计文档、没有任务拆解、没有 review。能跑，但一改就崩。

这不是 Agent 的问题，是方法论缺失的问题。人类工程师花了半个世纪总结出 TDD、YAGNI、DRY、code review、spec-first——这些不是装饰，是让代码能演化的基础设施。但 Agent 不知道这些，因为它训练数据里"写代码"远多于"如何写代码"。

obra/superpowers 的做法是：把方法论打包成 Markdown skill，让 Agent 自动触发。不是文档，不是 prompt 模板，是能被 Agent 识别并执行的"方法论代码"。

核心流程：从"立刻写代码"到"先想清楚再写"

Superpowers 的工作流从 Agent 启动那一刻就开始了：

1. Brainstorming（头脑风暴）——Agent 看到你要建东西，不立刻写代码，而是问你："你到底想做什么？"通过多轮对话把模糊需求变成清晰 spec。

2. Spec 分段展示——把设计文档分成你能消化的块，一段一段给你看、你签字了才继续。不是一次性甩给你 50 页文档。

3. Implementation Plan——"clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow"。这是原文里最精准的一句：计划要清晰到连一个没品味、没判断、没项目上下文、不爱写测试的初级工程师都能执行。

4. Subagent-Driven Development——这是 Superpowers 最核心的创新。你说"go"之后，Agent 不是自己闷头干，而是每个任务派一个新的 subagent 去执行，执行完由主 Agent 做 spec 合规检查 + 代码质量 review，通过才进下一个。"not uncommon for your agent to work autonomously for a couple hours at a time without deviating from the plan"——能自动跑两小时不跑偏。

5. TDD + YAGNI + DRY——三条铁律通过 skill 强制执行：先写测试再写代码、不需要的不写、重复的抽出来。

关键洞察：方法论作为"可执行技能"

Superpowers 最有意思的设计不是某个具体 skill，而是skill 的自动触发机制。你不需要告诉 Agent"现在做 brainstorming"——它看到你在建东西，自动进入 brainstorming。你不需要说"现在写测试"——TDD skill 自动触发。

这和 i-have-adhd 的设计哲学同构：对齐不一定需要重训模型，有时只需要一个 skill 文件。但方向不同——i-have-adhd 是约束输出风格，Superpowers 是约束工程流程。

从"颗粒度同构"原理看，Superpowers 做的是：把方法论的颗粒度对齐到 Agent 执行的颗粒度。人类方法论是"写代码前先想"——颗粒度是"一次对话"。Agent 方法论是"每个 subtask 前先 dispatch 一个 brainstorming subagent"——颗粒度是"一个 subagent 调用"。颗粒度对齐了，方法论才能真正执行。

11+ harness 统一：方法论的跨平台化

Superpowers 支持的 harness 列表读起来像 2026 年 AI 编码工具的点名册：Claude Code、Antigravity、Codex App、Codex CLI、Cursor、Factory Droid、Gemini CLI、GitHub Copilot CLI、Kimi Code、OpenCode、Pi。

这不是偶然。方法论不应该绑定到某个具体 Agent——TDD 不会因为你是 Claude Code 还是 Cursor 就变样。Superpowers 把方法论抽离成 Markdown skill，每个 harness 用自己的方式加载，但 skill 内容是同一份。

这和 cangjie-skill 的"方法论蒸馏"思路相通：方法论是可蒸馏、可迁移、可复用的资产。区别在于 cangjie 蒸馏的是"如何做研究/写文章"，Superpowers 蒸馏的是"如何写代码"。两者都是把隐性知识变成显性 skill。

Subagent-Driven Development：为什么"派新人"比"自己干"更好

这是 Superpowers 最反直觉的设计。直觉上，一个强 Agent 自己干完所有事最高效。但 Superpowers 偏偏每个 task 都派一个新 subagent。

为什么？因为fresh context。

主 Agent 跑了两小时后，上下文里塞满了前面所有 task 的细节、决策、代码片段。这时候它做下一个 task，判断会被前面的上下文污染——这就是"上下文渗透"（context bleed）。派一个新 subagent，给它干净的 context 和明确的 task spec，它不会被污染。

这和 ACE 工作流的 RPI（Research-Plan-Implement）三步压缩上下文是同一个原理：每个阶段独立压缩上下文，保持利用率 40-60%。Superpowers 把这个原理推到极致——每个 task 都是一个全新的 context。

从"分工比统一更有效"原则看：Superpowers 把"规划"和"执行"分给不同的 Agent，主 Agent 做规划和 review，subagent 做执行。分工让每个角色都更专注。

数据说话

• 支持 harness：11+ AI 编码客户端（Claude Code、Cursor、Codex、Gemini CLI、Copilot CLI 等）
• 今日 stars：777（2026-08-04 trending）
• 核心 skill 数：brainstorming、spec、planning、subagent-driven-development、TDD、code review 等
• 自动触发：无需手动调用，skill 根据 context 自动激活
• 商业版：Primeradiant 提供企业支持

给 Agent 开发者的启示

1. 方法论是 skill，不是文档：Markdown skill 能被 Agent 自动触发，比"请遵循以下规范"的文档有效 10 倍。 2. Subagent = fresh context：每个 task 派新 subagent，避免上下文渗透。这是"颗粒度同构"原理在 Agent 执行层的应用。 3. 方法论跨 harness：TDD 不绑定 Claude Code，把方法论抽离成可迁移 skill，一份投入多平台收益。 4. Spec 要清晰到"初级工程师能执行"：这不是贬低 Agent，是承认 Agent 和初级工程师一样需要明确指令。

---

一句话总结：obra/superpowers 把半个世纪的软件工程方法论打包成 Markdown skill，让 Agent 自动触发 brainstorming→spec→plan→subagent→review 的完整流程。不是教 Agent 写代码，是教 Agent 如何写代码。

> 仓库：obra/superpowers > Subagent-Driven Development skill：SKILL.md