5.2 KiB
Superpowers 仓库介绍
Superpowers 是一个为编码代理(Coding Agent)打造的完整软件开发工作流框架,核心基于可组合的“技能(Skills)”体系和标准化执行指令,让 AI 编码代理能按照专业的软件工程实践自主完成开发任务。
核心定位
为 Claude Code、Cursor、Codex、OpenCode、Gemini 等主流编码代理提供标准化的开发工作流能力,替代“直接写代码”的简单模式,引入专业的软件工程实践(TDD、YAGNI、DRY、系统化调试、代码评审等),让 AI 代理能自主规划、执行、评审、调试开发任务,甚至可自主运行数小时而不偏离计划。
核心特性
1. 标准化工作流
-
需求梳理:代理不会直接写代码,而是先提取清晰的需求规格,分块展示给用户确认;
-
实现规划:生成符合“初级工程师可执行”的详细实现计划,强调 TDD(测试驱动开发)、YAGNI(按需开发)、DRY(避免重复);
-
子代理驱动开发:核心的“Subagent-Driven Development”模式,由主代理调度子代理完成各任务,自动评审、校验工作成果;
-
全生命周期覆盖:从需求分析、方案设计、编码实现、测试验证、代码评审,到分支收尾、发布准备全流程覆盖。
2. 可组合的技能体系
仓库核心是丰富的“技能(Skills)”集合,每个技能对应一类标准化开发行为,例如:
-
systematic-debugging:系统化调试(四阶段调试法,聚焦根因而非表面症状); -
requesting-code-review:代码评审(标准化评审清单、子代理评审流程); -
finishing-a-development-branch:开发分支收尾(合并、PR、清理等结构化选项); -
writing-plans:编写标准化实现计划(精确路径、命令、预期输出); -
subagent-driven-development:子代理驱动开发(任务拆分、并行执行、质量门禁); -
还有测试反模式识别、TDD 实践、技能编写最佳实践等数十个细分技能。
3. 多平台适配
支持主流编码代理平台,且为不同平台提供适配方案:
| 平台 | 接入方式 |
|---|---|
| Claude Code | 官方插件市场直接安装 |
| Cursor | 插件市场搜索/命令安装 |
| Codex | 拉取并执行指定安装脚本 |
| OpenCode | 原生 JS/TS 插件 + 共享核心模块 |
| Gemini CLI | 扩展安装命令 |
4. 可复用的核心模块
为适配多平台,提取了共享核心模块 lib/skills-core.js,包含技能发现、Frontmatter 解析、版本更新检查等通用逻辑,避免各平台重复开发,同时保证行为一致性。
仓库结构
核心目录/文件说明:
superpowers/
├── .codex/ # Codex 平台适配(安装脚本、CLI 逻辑)
├── .opencode/ # OpenCode 平台适配(插件、安装指南)
├── .claude-plugin/ # Claude 插件配置
├── lib/ # 共享核心模块(skills-core.js)
├── skills/ # 核心技能集合(各技能对应独立目录,含 SKILL.md 定义)
├── docs/ # 设计文档、实现计划、平台适配指南
├── tests/ # 测试用例(子代理开发、各平台兼容性测试)
├── README.md # 核心说明、多平台安装指南
└── gemini-extension.json # Gemini 扩展配置
关键设计理念
-
渐进式披露(Progressive Disclosure):技能相关的文档/资源按需加载,避免上下文token浪费(例如按领域组织参考文件,仅加载当前任务需要的内容);
-
标准化验证:每个任务都有明确的“做什么”和“验证方式”,确保成果可校验;
-
错误容灾:例如调试技能中“3次修复失败则质疑架构”、代码评审中“显式文件读取指令避免文件找不到”;
-
跨平台复用:通过共享核心模块,让 Codex/OpenCode 等平台复用同一套技能逻辑,仅保留平台特定的封装层。
安装与验证
-
各平台安装方式在 README.md 中有详细说明(例如 Claude 用
/plugin install、Cursor 用/add-plugin、Gemini 用gemini extensions install); -
验证方式:启动新会话,触发任意技能(如“帮我规划这个功能”),若代理自动调用对应技能逻辑,则安装成功。
维护与支持
-
作者:Jesse Vincent(jesse@fsck.com);
-
赞助:支持通过 GitHub Sponsors 赞助(https://github.com/sponsors/obra);
-
问题反馈:通过仓库 Issues 提交(https://github.com/obra/superpowers/issues);
-
迭代规划:文档中包含明确的平台适配计划(如 2025 年 OpenCode 支持)、技能改进计划(基于用户反馈优化评审、测试逻辑)。
综上,Superpowers 本质是“AI 编码代理的软件工程方法论落地框架”,将人类成熟的开发流程和最佳实践固化为 AI 可执行的“技能”,大幅提升 AI 编码代理的产出质量和自主工作能力。
(注:文档部分内容可能由 AI 生成)