Superpowers：高效能AI代理技能框架与软件开发方法论
速览
该项目提供了一套经过验证的代理技能框架及软件开发方法论，旨在提升AI在代码生成与项目构建中的准确性与效率。通过结构化的技能定义，它使AI代理能够更稳定地处理多步骤开发任务，适用于需要高可靠性AI辅助编程的场景。
AI 深度解读
这是什么
Superpowers 是一个为代码智能体（Coding Agents）设计的完整软件开发方法论框架。它并非单一的工具或插件，而是一套基于可组合技能（Composable Skills）和初始指令的系统，旨在赋予 Claude Code、Codex CLI、Cursor、GitHub Copilot CLI 等主流 AI 编程助手以标准化的工程能力。
该项目由 Jesse Vincent 开发，托管在 GitHub 上（obra/superpowers），目前拥有超过 20 万 Star，是 Shell 语言编写的热门开源项目。其核心理念是：当开发者启动 AI 编程助手时，助手不应立即盲目生成代码，而是应遵循一套严格的工程流程——从需求澄清、规格说明书确认、实施计划制定，到基于子代理的迭代开发与测试驱动开发（TDD）。
解决的问题
传统的 AI 编程助手往往存在“急于写代码”的倾向，导致生成的代码缺乏整体架构思考、不符合项目上下文、测试覆盖率低，且容易偏离既定目标。Superpowers 解决了以下核心痛点：
- 缺乏工程纪律：AI 助手通常跳过设计阶段直接编码，导致代码结构混乱。Superpowers 强制要求在编码前进行需求澄清和设计确认。
- 上下文丢失与偏差：在长时间运行中，AI 容易遗忘初始指令或偏离计划。Superpowers 通过“子代理驱动开发”和严格的计划执行机制，确保 AI 在数小时的自主工作中保持专注。
- 测试缺失：许多 AI 生成的代码缺乏测试或测试不规范。Superpowers 内置了严格的 TDD（测试驱动开发）流程，强制“红-绿-重构”循环。
- 技能碎片化：不同 AI 工具缺乏统一的工程标准。Superpowers 提供了一套跨平台、可复用的技能库，确保无论使用何种 AI 助手，都能获得一致的、高质量的工程体验。
核心功能
Superpowers 通过一系列自动触发的“技能”（Skills）来规范 AI 的行为，这些技能构成了强制性的工作流：
1. 需求与设计阶段
- Brainstorming（头脑风暴）：在编码前激活。通过苏格拉底式提问澄清模糊需求，探索替代方案，并将设计文档分段呈现供开发者验证。
- Writing Plans（编写计划）：设计获批后激活。将工作分解为 2-5 分钟的微小任务，每个任务包含精确的文件路径、完整代码和验证步骤。强调 YAGNI（你不会需要它）和 DRY（不要重复自己）原则。
2. 实施与开发阶段
- Using Git Worktrees（使用 Git 工作树）：在计划批准后激活。创建隔离的工作区分支，运行项目设置，并验证干净的测试基线。
- Test-Driven Development（测试驱动开发）：在实现过程中激活。强制执行 RED-GREEN-REFACTOR 循环：先写失败测试，再写最小代码使其通过，最后重构。删除未通过测试的代码。
- Subagent-Driven Development / Executing Plans（子代理驱动开发/执行计划）：启动后激活。为每个工程任务分派独立的子代理，进行两阶段审查（规范合规性 -> 代码质量），或以批次形式执行并设置人工检查点。
3. 审查与收尾阶段
- Requesting Code Review（请求代码审查）：在任务之间激活。对照计划审查代码，按严重程度报告问题。关键问题会阻止进度继续。
- Finishing a Development Branch（完成开发分支）：任务完成后激活。验证测试，提供合并/PR/保留/丢弃选项，并清理工作树。
4. 辅助技能
- Systematic Debugging（系统化调试）：四阶段根本原因分析过程，包括根因追踪、纵深防御和条件等待技术。
- Verification Before Completion（完成前验证）：确保问题真正被修复。
亮点 / 与同类相比
- 方法论而非单纯工具：与仅提供代码补全的插件不同，Superpowers 是一套“软件开发方法论”。它通过指令集强制 AI 遵循软件工程最佳实践（如 TDD、YAGNI、DRY）。
- 跨平台兼容性：虽然各 AI 助手（Claude, Codex, Cursor 等）的插件安装方式不同，但 Superpowers 的技能逻辑是通用的。它支持在多个主流 AI 编程环境中部署，提供一致的工程体验。
- 子代理驱动架构：利用子代理（Subagent）并行或串行处理任务，并进行两阶段审查。这使得 AI 能够在无人干预的情况下自主工作数小时，同时保持对计划的严格遵守，减少了“幻觉”和偏离。
- 强制性与自动化：技能是自动触发的，开发者无需手动干预。AI 会在执行任务前检查相关技能，确保流程不被跳过。
- 透明化设计：设计文档以短片段形式展示，便于人类快速消化和确认，避免了长文本导致的阅读疲劳。
适合谁用 / 上手
适合人群
- 重视工程质量的开发者：希望 AI 生成的代码符合 TDD、模块化、可维护性标准的专业开发者。
- 使用多种 AI 编程助手的团队：需要统一 AI 行为标准，确保不同工具（如 Claude Code, Cursor, GitHub Copilot）下产出代码风格和质量一致。
- 复杂项目维护者：需要 AI 在长时间自主工作中保持上下文一致性和计划遵循性的项目。
上手指南
Superpowers 的安装方式因使用的 AI 助手（Harness）而异，需分别安装：
-
Claude Code：
- 通过 Anthropic 官方市场安装：
/plugin install superpowers@claude-plugins-official - 或通过注册市场后安装：
/plugin marketplace add obra/superpowers-marketplace，然后/plugin install superpowers@superpowers-marketplace
- 通过 Anthropic 官方市场安装：
-
Codex CLI：
- 在插件搜索界面搜索 "Superpowers" 并安装。
- 或在 Codex App 侧边栏的 "Coding" 部分点击 "+" 安装。
-
Factory Droid：
- 注册市场：
droid plugin marketplace add https://github.com/obra/superpowers - 安装插件：
droid plugin install superpowers@superpowers
- 注册市场：
-
Gemini CLI：
- 安装扩展：
gemini extensions install https://github.com/obra/superpowers - 更新扩展：
gemini extensions update superpowers
- 安装扩展：
-
OpenCode：
- 执行安装指令：
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
- 执行安装指令：
-
Cursor：
- 在 Agent 聊天中安装：
/add-plugin superpowers - 或在插件市场搜索 "superpowers"。
- 在 Agent 聊天中安装：
-
GitHub Copilot CLI：
- 注册市场：
copilot plugin marketplace add obra/superpowers-marketplace - 安装插件：
copilot plugin install superpowers@superpowers-marketplace
- 注册市场：
注意：如果同时使用多个 AI 助手，需为每个助手单独安装 Superpowers。安装后，AI 助手将在启动时自动加载这些技能，无需额外配置。