Superpowers-AI智能体-戴号AI

Superpowers 概述

Superpowers 是由 Jesse Vincent 和 Prime Radiant 团队开发的一套开源 Agentic 技能框架与软件开发方法论，专为 Claude、Cursor、GitHub Copilot 等 AI Coding Agent 设计。该框架包含 14 个可组合技能和初始指令，改变了 AI 编码助手直接编写代码的传统模式。它要求 AI 先通过苏格拉底式提问提炼需求，生成可验证的设计文档，制定详细实施计划，随后再进入子代理驱动的开发流程。

其核心强调 RED-GREEN-REFACTOR 测试驱动开发、YAGNI 原则和 DRY 原则，并支持 Git Worktrees 隔离开发、并行子代理调度、两阶段代码审查等高级工作流。这使得 Claude 等 Agent 能够自主运行数小时而不偏离既定计划。

主要功能解析

需求提炼与规划

苏格拉底式头脑风暴：通过不断追问来提炼需求，将设计方案分块呈现给用户确认后，才进入编码阶段。
设计文档生成：将粗糙的想法转化为结构化、可验证的规格说明，并自动保存。
详细实施计划：将工作拆解为 2-5 分钟的微任务，包含精确的文件路径、完整代码和验证步骤。

开发与测试机制

子代理驱动开发：为每个任务派遣独立子代理，并执行两阶段审查（规格合规性与代码质量）。
测试驱动开发：强制执行 RED-GREEN-REFACTOR 循环，要求先写测试再写代码，若发现测试前编写的代码则予以删除。
系统化调试：采用四阶段根因分析流程，涵盖根因追踪、纵深防御、条件等待等技术。

工作流与代码审查

Git Worktrees 工作流：在独立分支和工作区中进行开发，验证干净的测试基线。
并行代理调度：并发执行多个子代理工作流，提升大型项目的开发效率。
代码审查机制：在任务间自动进行审查，按严重程度报告问题，关键问题将阻塞进度。
分支收尾：验证测试，提供合并、PR、保留或丢弃等选项，并清理工作区。

扩展与兼容性

技能自扩展：遵循最佳实践创建和测试新技能，支持团队沉淀内部方法论。
多平台插件支持：全面覆盖 Claude Code 官方市场、Cursor、OpenAI Codex CLI/App、GitHub Copilot CLI、Gemini CLI、OpenCode。

安装与使用指南

各平台安装方式

Claude Code 官方市场：运行 /plugin install superpowers@claude-plugins-official。
Claude Code Superpowers 市场：先执行 /plugin marketplace add obra/superpowers-marketplace，再执行 /plugin install superpowers@superpowers-marketplace。
OpenAI Codex CLI：打开插件搜索界面，搜索 "Superpowers" 并选择安装。
OpenAI Codex App：在侧边栏点击 Plugins，于 Coding 分类中找到 Superpowers 并点击 + 安装。
Cursor：在 Agent 聊天中通过插件市场搜索 "superpowers" 安装。
OpenCode：输入 Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md。
GitHub Copilot CLI：依次运行 copilot plugin marketplace add obra/superpowers-marketplace 和 copilot plugin install superpowers@superpowers-marketplace。
Gemini CLI：运行 gemini extensions install https://github.com/obra/superpowers，更新时使用 gemini extensions update superpowers。

基础工作流

标准的工作流程依次为：头脑风暴、设计确认、Git Worktree 创建、撰写计划、子代理执行或计划执行、TDD 实现、代码审查、分支收尾。

核心优势与应用场景

核心优势

不直接写代码，先理解需求：Agent 遇到开发任务时先退一步，通过提问明确真实目标，避免幻觉和返工。
系统化而非随意：以基于流程的方法论替代猜测式编程，将复杂度削减作为首要目标。
证据胜于断言：只有在验证通过后才宣告成功，避免"看起来能跑"的虚假完成。
自动触发技能：检测到相关任务时技能自动激活，无需手动调用或记忆复杂指令。
长时间自主运行：Claude 等 Agent 可在既定计划下自主工作数小时不偏离目标。
强制测试优先：TDD 作为强制性工作流而非可选建议，从根本上保障代码质量。
多 Agent 生态兼容：同一套技能库可跨 Claude、Cursor、Copilot、Codex、Gemini 等平台无缝工作。
微任务拆解：2-5 分钟粒度的任务描述让"热情的初级工程师"也能准确执行。
隔离式开发：Git Worktrees 避免污染主分支，支持并行实验和安全回退。

应用场景

从零构建新功能：通过头脑风暴和设计文档确保需求理解正确，避免后期大规模返工。
大型重构项目：用 Git Worktrees 隔离实验，子代理并行处理不同模块的改造。
Bug 修复与根因分析：系统化调试技能指导 Agent 进行四阶段根因追踪，而非盲目试错。
代码审查自动化：在提交前让 Agent 执行两阶段审查，主动发现规格偏离和质量问题。
多文件复杂改动：将大需求拆解为微任务，分派子代理逐步实施并持续验证。
跨平台开发协作：同一套 Superpowers 技能在 Claude、Cursor、Copilot 间保持一致体验。

关键信息与常见问题

关键信息与使用要求

开源协议：MIT License，可自由使用、修改和商业应用。
维护者：Jesse Vincent 及 Prime Radiant 团队。
核心哲学：TDD 优先、系统化流程、复杂度削减、证据验证。
技能数量：14 个可组合技能，覆盖测试、调试、协作、计划执行、并行代理、Git 工作流。
安装前提：需使用支持插件系统的 Coding Agent（如 Claude Code、Cursor、Codex 等）。
工作流强制性：Agent 在执行任务前必须检查相关技能，这是强制流程而非建议。
社区支持：提供 Discord 社区、GitHub Issues、邮件订阅发布通知。
贡献规范：不接受随意新增技能，修改需跨所有支持平台验证，并遵循 writing-skills 指南。
更新机制：部分平台支持自动更新，具体取决于 Coding Agent 的插件系统。

常见问题解答

Q：Superpowers 是一个代码库还是方法论？

A：两者兼备。它是一套基于可组合技能的完整软件开发方法论，同时以开源插件形式分发到各大 AI 编码平台。

Q：是否必须学会所有技能才能开始？

A：不需要。技能会根据当前任务自动触发，用户只需正常与 Coding Agent 交互，Superpowers 会在后台接管工作流。

Q：支持哪些 AI 编码平台？

A：支持 Claude Code（官方市场）、Cursor、OpenAI Codex CLI/App、GitHub Copilot CLI、Gemini CLI、OpenCode。

Q：能否自定义或添加新技能？

A：可以，但需遵循 writing-skills 技能指南，且必须确保跨所有支持平台兼容。官方一般不直接接受新技能贡献。

Q：为什么强调"先不写代码"？

A：直接生成代码容易产生幻觉和返工。Superpowers 通过设计文档和计划确保 Agent 真正理解需求后再动手，降低后期修正成本。

Q：TDD 是可选的吗？

A：不是。RED-GREEN-REFACTOR 是强制性工作流，Agent 会删除测试前编写的任何代码，确保测试覆盖率。

Q：子代理驱动开发和执行计划有什么区别？

A：子代理驱动开发为每个任务派遣独立 Agent 并执行两阶段审查；执行计划则以批处理模式运行并设置人工检查点。