AI 编程工具快速发展，从利用外部文件和 Bash 脚本突破模型上下文限制的 Ralph-Loop 爆火，到如今 Superpowers 框架的崛起，也才经过几个月的时间。我们需要快速适应并调整驾驭AI编程助手的方式。有时候感觉比古法编程时代更累了。

在普通的开发场景下，AI 拿到需求后往往会横冲直撞：看一眼代码文件和规范，直接上手就写。它不在乎项目整体架构，也不考虑测试覆盖率，最终导致代码结构混乱，甚至产生严重的逻辑幻觉。

Superpowers 是一个专门为 AI 编程 Agent 而设计的 Skill。它本质上不是单一的技能，而是一个开源的智能体技能框架（Agent Skills Framework），目前已兼容 Claude Code、Codex 等主流工具。其核心理念是，通过一系列组合好的规范流程和工具，强制AI遵循我们已经探索出的最佳实践。这能使AI在写代码之前，可以像资深软件工程师一样先梳理需求，询问用户细节，然后进行规划，最后才动手写代码。

Superpowers 的四大核心原则

Superpowers 的核心原则可以总结为以下几项，这些原则共同构成了一套强制约束力的标准工作流：

1. 谋定而后动 (Spec-First Development)

在敲代码之前，首先进行头脑风暴。AI会主动分析需求、挖掘边缘条件、权衡替代方案，然后编写详细的设计文档（Spec）。最关键的是运用 Human-In-The-Loop 机制，进行详细的询问，在用户确认所有需求细节后，并且同意执行了设计方案后，才开始编码。

1. 测试驱动开发 (Test-Driven Development, TDD)

Superpowers 极其强调 TDD 的红-绿-重构（Red-Green-Refactor）流程。必须先编写针对新功能的测试用例（此时运行测试必然失败），然后再编写实现代码让测试通过。这里有一条极其严苛的惩罚机制：如果代码存在问题或偏离计划，强制 AI 删除代码重新来过。这一原则是防止 AI 产生幻觉、确保代码真实可用的最有效手段。

1. 极简主义与实用主义 (YAGNI & DRY)

• YAGNI (You Aren’t Gonna Need It - 你不需要它)： 强制 AI 只编写当前明确要求的功能，严禁自作主张地进行过度设计或添加未来可能用到的冗余逻辑。
• DRY (Don’t Repeat Yourself - 不要重复自己)： 强制 AI 审视现有代码库，复用已有逻辑，避免重复造轮子。

1. 隔离与安全优先 (Isolation & Separation of Concerns)

• 隔离环境：AI 在执行任何写入操作前，必须利用 Git 技能创建隔离的工作区（Worktree）或新分支，确保代码被版本控制，随时可无损回滚。
• 职责分离：大模型由于其自回归特性，通常存在确认偏误，很难客观审查自己写的代码（往往觉得毫无 Bug）。Superpowers 引入了子智能体（Sub-agent）机制来实现职责分离：主 Agent 负责拆解计划，随后为每个任务唤起一个全新的、只有干净上下文的子 Agent 去执行编码，避免长对话带来的上下文污染。

核心工作流：Superpowers 赋予了 AI 哪些超能力？

在实际开发中，Superpowers 会通过以下流程序列化地引导 AI：

1. 头脑风暴（brainstorming）

在写代码之前，它会先执行以下动作：

• 它会先退一步，询问你到底想构建什么。
• 它会与你进行互动，挖掘边缘情况（Edge cases），探索替代方案。
• 只有当你明确批准了它生成的设计文档（Spec）后，它才会进入下一步。

1. 创建隔离工作树（using-git-worktrees）

当设计文档完成后，它会在新分支上创建隔离工作区，同时运行当前项目，确保当前的代码版本是干净且可以运行的。

1. 制定计划（writing-plans）

它将设计文档中的工作分解为小任务（每个任务2-5分钟），每个任务都有确切的的文件路径、完整的编码、验证步骤。这一步的目的是完整列出整个需求应该干的活，可以让一个新的Agent来完美编码。

1. 子Agent驱动开发（subagent-driven-development / executing-plans）

在执行计划阶段，它会通过两阶段审查（规范符合性，然后是编码质量）为每个任务分派新的子代理，或者通过人工检查点批量执行。

1. 测试驱动开发（test-driven-development）

在编写代码时，它会严格按照红-绿-重构的模式进行测试，如果代码有问题，则删除代码并重来。

1. 请求代码审查（requesting-code-review）

代码审查会在任务之间执行。这个节点对照计划进行审查，按严重程度报告问题。关键问题块进展。

1. 完成开发分支（finishing-a-development-branch）

当所有任务都完成之后，执行测试单元，完成合并或PR等选项，然后清理工作树，保持开发环境整洁。

它是如何运作的？（技术与心理学结合）

SKILL.md 文件： Superpowers 的技能本质上是一系列结构化的 Markdown 文件和脚本。每个技能描述了：何时激活该技能、需要遵循哪些步骤、如何进行验证。AI 会读取这些描述并自动调用。

说服 AI 遵守纪律： 这是一个非常有趣的特性。大型语言模型（LLM）由于算力限制或 Token 节省机制，有时会偷懒跳过步骤。Superpowers 在指令中运用了罗伯特·西奥迪尼（Robert Cialdini）在《影响力》一书中提出的心理学和说服原则。它将技能检查点设置在生成任何回复之前，从结构上防止 AI 偷懒跳过测试或代码审查。

总结

将 Agent Skill 转化为 Superpowers，本质上是将 AI 从一个有求必应但容易出错的打字员，升级为了一个自带顶级软件工程方法论的开发团队。它证明了在目前的 AI 阶段，高质量的输出不仅取决于模型的智力，更取决于约束模型的工作流纪律。