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

97 lines
5.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 解析、版本更新检查等通用逻辑,避免各平台重复开发,同时保证行为一致性。
## 仓库结构
核心目录/文件说明:
```Plain Text
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](README.md) 中有详细说明(例如 Claude 用 `/plugin install`、Cursor 用 `/add-plugin`、Gemini 用 `gemini extensions install`);
- 验证方式:启动新会话,触发任意技能(如“帮我规划这个功能”),若代理自动调用对应技能逻辑,则安装成功。
## 维护与支持
- 作者:Jesse Vincent([jesse@fsck.com](mailto:jesse@fsck.com));
- 赞助:支持通过 GitHub Sponsors 赞助([https://github.com/sponsors/obra](https://github.com/sponsors/obra));
- 问题反馈:通过仓库 Issues 提交([https://github.com/obra/superpowers/issues](https://github.com/obra/superpowers/issues));
- 迭代规划:文档中包含明确的平台适配计划(如 2025 年 OpenCode 支持)、技能改进计划(基于用户反馈优化评审、测试逻辑)。
综上,Superpowers 本质是“AI 编码代理的软件工程方法论落地框架”,将人类成熟的开发流程和最佳实践固化为 AI 可执行的“技能”,大幅提升 AI 编码代理的产出质量和自主工作能力。
> (注:文档部分内容可能由 AI 生成)