1. 项目定位与用途
Superpowers 是一个为 AI 编码代理设计的完整软件开发工作流框架，以插件形式集成到多种编码环境中。其核心用途是通过自动触发的可组合技能，引导代理遵循结构化开发流程，从初始的需求澄清开始，经过设计验证、计划分解、子代理执行，最终到测试驱动实现与代码审查，从而提升代理自主开发时的代码质量、减少返工，并确保工程最佳实践的落实。
项目档案插件 / 扩展
Superpowers AI 编码代理工作流框架：插件式安装，自动触发技能引导 TDD 最佳实践，提升开发质量
Superpowers 是一个为 AI 编码代理设计的插件式开发工作流框架，通过自动触发头脑风暴、计划编写、子代理开发等技能，引导代理遵循 TDD、YAGNI 最佳实践。支持 Claude Code、Cursor、Codex、OpenCode 等平台。本页提供项目介绍、安装指南、使用方法和架构解析。
AI 总结
Superpowers 是一个为 AI 编码代理设计的插件式开发工作流框架，通过自动触发可组合技能，引导代理遵循 TDD、YAGNI 等最佳实践，完成从需求澄清到测试验证的完整软件开发生命周期，提升自主开发质量与效率。
中文项目介绍
Superpowers 是一个专为 AI 编码代理设计的软件开发工作流框架，旨在提升代理的自主开发能力与产出质量。
它通过一系列可组合的“技能”自动触发，引导代理从需求澄清、设计验证、计划分解到实现测试的全流程，确保遵循 TDD（测试驱动开发）、YAGNI（你不会需要它）、DRY（不要重复自己）等工程最佳实践。
该项目适用于使用 AI 代理进行功能规划、复杂调试、大型任务执行、代码审查等场景，支持 Claude Code、Cursor、Codex、OpenCode 等多种主流 AI 编码环境。
技术实现上，Superpowers 采用插件化跨平台架构，共享核心技能发现与解析模块，并基于 SKILL.md 文件定义技能触发条件与行为，支持个人技能扩展以覆盖默认行为。
详细信息与使用说明
2. 解决的问题
AI 编码代理常因缺乏结构化流程而直接跳入编码，导致需求不明确、设计未验证、计划不分解、测试不充分，最终产出质量低下。Superpowers 通过技能驱动的工作流，在编码前强制进行头脑风暴以细化需求，展示分段设计供确认，生成可执行计划，并实施严格的测试驱动开发与子代理审查机制，有效解决了这些痛点，延长了代理的自主运行时间并提高了产出可靠性。
3. 适用场景
该项目适用于多种 AI 辅助开发场景，包括：使用 AI 代理规划新功能时进行需求澄清与设计验证；调试复杂问题时启用系统性调试技能进行根因分析；执行大型开发任务时分派子代理并行工作并逐项审查；进行代码审查时请求或接收同行反馈；以及在支持插件的 AI 编码环境（如 Claude Code、Cursor、Codex、OpenCode）中增强代理能力，使其遵循工程规范。
4. 安装方式
安装方式因平台而异。Claude Code 可通过官方市场执行 `/plugin install superpowers@claude-plugins-official` 或先添加市场再安装；Cursor 在 Agent 聊天中执行 `/add-plugin superpowers` 或搜索安装；Codex 需告知代理获取并遵循 `.codex/INSTALL.md` 指令；OpenCode 需告知代理遵循 `.opencode/INSTALL.md` 或在其配置中添加插件；GitHub Copilot CLI 需先添加市场再安装；Gemini CLI 使用 `gemini extensions install` 命令。具体步骤详见各平台文档。
5. 使用方式
基本工作流包含五个自动激活的技能：头脑风暴（brainstorming）在写代码前通过提问细化想法并生成分段设计；使用 git worktrees（using-git-worktrees）在设计批准后创建隔离工作区；编写计划（writing-plans）将设计分解为 2-5 分钟的小任务，含精确路径与验证步骤；子代理驱动开发（subagent-driven-development）分派子代理执行任务并进行两阶段审查；测试驱动开发（test-driven-development）强制红-绿-重构循环，确保测试先行。代理会根据上下文自动触发相应技能。
6. 实现特点
Superpowers 采用插件化跨平台架构，通过平台特定适配层（Claude Code 插件、Codex symlink、OpenCode 插件）集成不同环境。核心是共享的 `lib/skills-core.js` 模块，提取通用技能发现、解析与加载逻辑，减少代码重复。技能基于 `SKILL.md` 文件定义，使用 YAML frontmatter 描述触发条件。支持分层技能优先级（个人 > 核心）以实现 shadowing 覆盖。OpenCode 插件还提供工具映射适配层，将 Claude Code 工具转换为平台原生 API。
思维导图
Superpowers
核心工作流技能
brainstorming
using-git-worktrees
writing-plans
subagent-driven-development
test-driven-development
辅助技能
systematic-debugging
requesting-code-review
receiving-code-review
using-superpowers
平台支持
Claude Code
Cursor
Codex
OpenCode
GitHub Copilot CLI
Gemini CLI
架构组件
共享核心模块 (skills-core)
技能发现与解析
工具映射适配
个人技能扩展
常见问题
Superpowers 是什么？
Superpowers 是一个为 AI 编码代理设计的软件开发工作流框架，以插件形式集成到编码环境中，通过自动触发的可组合技能引导代理完成从需求澄清到测试验证的全流程，提升自主开发质量。
如何安装 Superpowers？
安装方式取决于平台：Claude Code 可通过插件市场安装；Cursor 使用 /add-plugin 命令；Codex 和 OpenCode 需告知代理获取并遵循仓库中的 INSTALL.md 指令；GitHub Copilot CLI 和 Gemini CLI 也有对应命令。具体步骤请参考对应平台的安装文档。
Superpowers 包含哪些主要技能？
主要技能包括：brainstorming（头脑风暴细化需求）、using-git-worktrees（创建隔离工作区）、writing-plans（分解任务）、subagent-driven-development（子代理执行与审查）、test-driven-development（强制测试驱动循环），以及 systematic-debugging、code-review 等辅助技能。
支持哪些 AI 编码平台？
Superpowers 支持多种平台：Claude Code（官方插件市场）、Cursor（插件市场）、Codex（symlink 方式）、OpenCode（原生插件）、GitHub Copilot CLI 和 Gemini CLI。各平台集成方式略有不同，但核心工作流一致。
如何自定义或扩展技能？
用户可以在个人配置目录（如 ~/.config/opencode/skills/ 或 ~/.agents/skills/）创建自定义 SKILL.md 文件，通过分层技能优先级机制覆盖默认技能行为，实现个性化工作流扩展。