Superpowers：让AI编码代理学会工程师思维的开源框架

AI编码代理写代码快，但工程纪律差——这几乎是所有使用Claude Code、Cursor、Devin或GitHub Copilot的开发者共同的痛点。Superpowers正是冲着这个问题来的：它不是又一个提示词模板，而是一套强制AI代理走完"头脑风暴→设计→计划→测试驱动→代码审查"全流程的方法论。据该项目在YouTube上的介绍视频披露，它在单周内收获了超过308,000颗星标，仅当天就新增近5,000颗，市场用脚投票的速度相当可观。

问题：AI代理的"先写后问"惯性

现有编码代理的典型行为模式是：你一开口，它立刻开始写代码。需求靠猜，功能自行加戏，测试完全跳过。出现bug后没有系统化的调试路径，只是随机改几行碰运气。代码审查环节压根不存在，测试被视为事后补充。当多个代理同时推进一个项目时，缺乏协调机制导致相互冲突，最终烧掉大量token，留下一堆难以维护的代码。

Superpowers的作者将这套行为总结为"写代码第一，提问永不"。要理解Superpowers的价值，先得承认这个现状不是靠一句"请先思考再动手"的提示词能解决的——模型在被给予选择时，几乎总会走捷径。

Superpowers的解法：把流程变成强制技能

Superpowers的核心设计是一组可组合的"技能"（skills），它们按顺序自动激活，代理必须遵循。整个工作流从头脑风暴开始：代理反复追问澄清问题，直到你真正说清楚要做什么、为什么做。达成共识后产出一份短到能读完的设计文档。

随后进入计划阶段：用Git Worktrees创建隔离的开发分支，并验证测试基线是干净的。写计划时，工作被拆成2到5分钟粒度的任务，每个任务附带确切的文件路径和完整代码。接下来有两种执行模式——子代理驱动开发为每个任务派发一个全新的、上下文独立的子代理，每个任务完成后立即审查；或者内联执行计划，最后统一做一次审查。

测试驱动开发：反转代理的编码顺序

测试驱动开发是Superpowers最具颠覆性的部分。代理必须先写一个会失败的测试，亲眼看着它失败，然后写最少的代码让它通过，通过后才允许重构。这完全颠倒了多数代理的编码习惯——它们先写实现，测试要么不写，要么写了也验证不了任何东西。

该技能还内置了常见测试反模式的参考清单：mock被测代码、测试实现细节而非行为、写永远通过的测试。代理在写测试前先学习什么是不好的测试，从而主动规避。

技能（Skill） 在AI编码代理的语境下，指的是一种封装了特定工作流、指令和验证步骤的可复用模块。与传统的提示词模板不同，技能通常以结构化文件（如Markdown）存储，包含触发条件、执行步骤和成功标准，并能被代理自动识别和调用。Superpowers的技能设计强调“可组合性”和“强制激活”：多个技能可以按依赖关系串联成完整流程，且代理无法跳过已被激活的技能，从而将软性的最佳实践转化为硬性的执行约束。这种机制类似于给代理安装了一套“行为操作系统”，使其在特定场景下必须遵循预设的纪律，而非依赖模型自身的判断。

测试驱动开发（TDD） 是一种软件开发方法论，其核心循环为“红-绿-重构”：先编写一个预期失败的测试（红），然后编写恰好能让测试通过的最小实现（绿），最后在测试保护下重构代码以改善设计。TDD的关键价值在于将需求转化为可执行的断言，并确保代码始终有测试覆盖。对于AI编码代理而言，TDD的反直觉之处在于它要求代理先关注“如何验证正确性”，再考虑“如何实现功能”，这迫使代理在动手前明确预期行为，从而减少猜测性编码和过度设计。Superpowers将TDD设为强制技能，正是利用这一顺序反转来对抗代理“先写实现、后补测试”的惯性。

系统化调试与验证闭环

出问题时，Superpowers提供四阶段的根因排查流程，运用根因追踪、纵深防御和基于条件的加权等技术逐步缩小范围。代理不会到处撒print语句，而是谨慎插桩、精确追踪执行路径，定位bug的确切位置。修复完成后还有验证环节，确保解决的是根因而非表面症状。

如果Superpowers自身行为异常——比如某个技能不该触发却触发了，或代理无视了既定计划——可以使用"诊断Superpowers"技能。它会读取会话记录，以行级证据报告发生了什么，并导出脱敏后的打包文件用于提交bug报告。

多代理协作与分支管理

对于大型项目，子代理驱动开发让主代理为每个任务派发一个专注的新子代理，各自拥有独立上下文和精确的任务规格。主代理逐个审查结果，有问题则修复重试或升级处理。当任务真正独立时，这比内联执行更节省成本，也能避免上下文污染。两种工作流都支持派发并行代理实现真正的并发。Git Worktrees则为每个开发分支提供隔离，工作互不碰撞。

协作被当作一等公民对待。请求代码审查技能对照原始计划逐项检查，按严重程度报告问题，关键问题直接阻断推进。接收代码审查技能则教代理如何建设性地回应队友反馈，而非防御性抵触。收尾阶段提供明确选项：合并到主分支、创建pull request、保留分支或干净丢弃。

Git Worktrees 是Git版本控制系统的一个功能，允许在同一个仓库中同时检出多个工作树（working tree），每个工作树对应不同的分支，且共享相同的.git目录。这意味着开发者可以在不切换分支的情况下，在不同目录中并行开发多个功能分支，彼此完全隔离。对于多代理协作场景，每个代理可以分配到一个独立的worktree中工作，避免分支切换带来的冲突和上下文丢失。Worktrees的隔离性还使得代理可以安全地进行实验性修改，而不会影响主分支或其他代理的工作，从而提升并发开发的协调性和可靠性。

可扩展性与测试工具链

Superpowers自身是可扩展的。"编写技能"技能教代理按照最佳实践创建新技能，包括Superpowers强制执行的测试方法论。每个技能存储为结构清晰的markdown文件，包含指令、示例和验证步骤。仓库包含一个名为Drill Evil的测试工具链，技能行为测试会针对多个代理运行以确保一致性。

基础设施测试放在tests目录，通过shell脚本或NPM test运行。测试工具链的理念是简洁与"证据优于声明"——新建技能要经过与核心技能相同的标准检验。

四条不可绕过的原则

Superpowers建立在四条核心原则之上：测试驱动开发，永远先写测试；系统化优于临时应对，流程永远胜过猜测；降低复杂度，简洁是首要目标，禁止镀金；证据优于声明，宣布成功前必须验证。

这些不是建议，而是写进技能本身的硬约束，代理无法跳过。这一点至关重要——如果给模型选择的余地，它多半会抄近路，Superpowers的做法是直接移除这个选项。

“证据优于声明” 是软件工程中强调可验证性的原则，要求任何关于系统状态或功能完成的断言都必须有客观证据支撑，而非仅凭主观声明。在AI代理的上下文中，这意味着代理不能仅声称“任务完成”或“测试通过”，而必须提供可复现的证据，如测试运行日志、代码差异、构建输出等。Superpowers将这一原则写入技能，要求代理在宣布成功前必须执行验证步骤并展示结果，从而防止代理因幻觉或过度自信而虚报完成状态。这一原则与测试驱动开发、系统化调试等实践紧密结合，共同构成代理行为的可信基础。

代价与适用场景

Superpowers强制纪律，但纪律有真实代价：前期更慢。头脑风暴和计划确实耗时。不过据其介绍，这部分时间会立刻被更少的bug、更少的返工以及多代理协作时大幅改善的协调性所偿还。对独立开发者和小团队而言，这是"编码助手"与"合格团队成员"之间的差别；对大型组织而言，这是混乱与规模化之间的差别。

安装方面，Superpowers以插件形式分发，覆盖17个编码代理平台，通常一条命令即可完成。Claude Code可通过官方市场或Superpowers市场安装，Cursor、Devin等有各自的插件生态，GitHub Copilot CLI、Gemini、Grok、Kimi、Qwen、OpenCode等各有安装流程，均在README中列出。安装后下次开始编码时技能自动激活，无需额外配置。

值得一提的是，上述信息主要来自该项目的官方介绍视频，星标数的统计口径与持续性尚待第三方验证；视频文稿中部分段落存在重复和识别错误，实际功能细节建议以仓库文档为准。