Files
Obsidian/MyArticles/Superpowers 仓库介绍.md
T
coco 8b94d76799 a
2026-07-21 13:57:15 +08:00

5.2 KiB
Raw Blame History

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 扩展配置

关键设计理念

  1. 渐进式披露(Progressive Disclosure):技能相关的文档/资源按需加载,避免上下文token浪费(例如按领域组织参考文件,仅加载当前任务需要的内容);

  2. 标准化验证:每个任务都有明确的“做什么”和“验证方式”,确保成果可校验;

  3. 错误容灾:例如调试技能中“3次修复失败则质疑架构”、代码评审中“显式文件读取指令避免文件找不到”;

  4. 跨平台复用:通过共享核心模块,让 Codex/OpenCode 等平台复用同一套技能逻辑,仅保留平台特定的封装层。

安装与验证

  • 各平台安装方式在 README.md 中有详细说明(例如 Claude 用 /plugin install、Cursor 用 /add-plugin、Gemini 用 gemini extensions install);

  • 验证方式:启动新会话,触发任意技能(如“帮我规划这个功能”),若代理自动调用对应技能逻辑,则安装成功。

维护与支持

综上,Superpowers 本质是“AI 编码代理的软件工程方法论落地框架”,将人类成熟的开发流程和最佳实践固化为 AI 可执行的“技能”,大幅提升 AI 编码代理的产出质量和自主工作能力。

(注:文档部分内容可能由 AI 生成)