Superpowers 是一套面向 AI 编码代理的开源工程化工作流框架，核心是让 AI 像专业工程师一样做全流程开发，而非零散写代码。
一、项目定位与核心价值
- 定位：非独立模型 / 应用，是AI 编码代理的技能库 + 标准化开发流程框架，适配 Claude Code、OpenAI Codex、OpenCode 等。
- 解决痛点：AI 编码易偏离需求、缺乏工程规范、代码质量不可控、上下文混乱、无测试意识。
- 目标：让 AI 遵循 TDD、YAGNI、DRY 等软件工程原则，实现需求→设计→计划→开发→审查→交付全流程自主闭环。
- 开源协议：MIT License，可自由使用、修改、分发。
- 项目地址：https://github.com/obra/superpowers
二、核心工作流（5 大阶段）
- 需求澄清与设计（Brainstorming）
- 不直接写代码，先通过对话厘清核心需求、输出设计草案并确认，避免方向错误。
- 环境隔离（Git Worktrees）
- 创建独立 Git 分支与 worktree，开发环境隔离、不污染主分支，支持回滚。
- 任务拆解与计划（Writing Plans）
- 把设计拆成2–5 分钟可执行小任务，含精确文件路径、代码片段、验证步骤，让初级工程师也能执行。
- 子代理驱动开发（Subagent-Driven）
- 为每个任务派 “新鲜” 子代理（无上下文污染），完成后做两阶段审查：
- 规格审查：是否完全符合需求、不多做 / 少做
- 质量审查：代码整洁、测试覆盖、无明显缺陷
- 循环修复直到通过，强制 TDD 贯穿。
- 为每个任务派 “新鲜” 子代理（无上下文污染），完成后做两阶段审查：
- 分支收尾（Finishing）
- 全量测试验证，提供合并 / 提 PR / 保留 / 丢弃分支选项，清理 worktree。
三、核心特性
- 工程化强制：内置 TDD、代码审查、任务拆解、环境隔离，杜绝 “随性编码（Vibe Coding）”。
- 子代理机制：每个任务独立子代理，避免上下文干扰、提升稳定性。
- 多代理兼容：跨 Claude Code、Codex、OpenCode、Gemini CLI 等平台。
- 可组合技能（Skills）：流程拆为可复用技能模块，灵活扩展。
- 零人工干预：支持 AI 自主迭代数小时，大幅提升效率。
四、与普通 AI 编码的区别
| 维度 | 普通 AI 编码（Vibe Coding） | Superpowers 驱动的 AI 编码 |
|---|---|---|
| 流程 | 想到哪写到哪、无规范 | 标准化全流程、强制工程实践 |
| 测试 | 几乎无测试、事后补 | TDD 先行、每步验证 |
| 环境 | 直接改主分支、易混乱 | 隔离分支、安全可回滚 |
| 质量 | 依赖提示词、不可控 | 双审查循环、质量可预期 |
| 效率 | 频繁返工、上下文溢出 | 小任务拆解、子代理并行 |
Superpowers 本质是给 AI 装上 “软件工程大脑”，让 AI 从 “代码生成器” 升级为 “自主开发工程师”，适合需要工程化、可维护、高质量代码的项目。