原文地址【带图片】Superpowers让 AI 编程助手从「能写代码」到「工程级交付」的技能框架一个场景AI 写代码为什么越写越乱你兴冲冲地打开 Claude Code敲下一句话「帮我做一个用户登录系统支持邮箱和手机号登录。」AI 二话不说开始往外吐代码——路由、数据库模型、密码加密、JWT、中间件……一口气写了 800 行。你还没来得及高兴就发现了一些问题手机号登录是否要验证码AI 假设要但你其实只是想要一个简单实现数据库选型没问你——它默认用了 SQLite但你的项目是 PostgreSQL没有测试也没有错误处理你开始怀疑这段代码能不能用这在技术圈有个名字——Vibe Coding让 AI 「凭感觉写代码」结果往往是越写越乱。Superpowers就是为了解决这个问题而生的。它不是另一个 AI 工具而是一套强制性的工程纪律系统让 AI 在写代码之前先去思考你想让它写什么。一、什么是 SuperpowersSuperpowers 是由 Claude Code 核心贡献者Jesse Vincentobra打造的开源技能框架GitHub 已获得16 万 Star是 Anthropic 官方插件市场上安装量排名第二的插件。它的核心理念可以用一句话概括不要直接写代码。先澄清需求再编写计划然后分步实现每一步都有检查点。Superpowers 将专业软件开发团队的方法论固化为 14 个可组合的「技能Skills」在 AI 编程助手启动时自动加载。它不是「建议」AI 遵循最佳实践而是强制它走完完整的工程流程。它不是什么不是 Prompt 模板包它不是把一段长提示词塞给 AI而是通过代理技能系统在运行时控制 AI 的行为不是一个新 AI 工具它是 Claude Code、Cursor、Codex 等现有平台的插件不替换你的工具链不适合所有场景改一个错字、调一个颜色不需要 Superpowers。但开发一个完整功能、重构一个模块它是你的工程护盾架构理念Superpowers 建立在一个简洁的三阶段流水线上头脑风暴Brainstorm → 编写计划Write Plan → 执行计划Execute Plan每个阶段都有不可跳过的检查点确保质量在源头被保障而不是事后补救。二、安装 SuperpowersSuperpowers 支持多种 AI 编程平台安装方式因平台而异。Claude Code推荐Claude Code 上安装最简单通过插件市场即可# 第一步注册 Superpowers 插件市场/plugin marketplaceaddobra/superpowers-marketplace# 第二步安装核心插件/plugininstallsuperpowerssuperpowers-marketplace也可以直接通过 Anthropic 官方市场安装/plugininstallsuperpowersclaude-plugins-officialCursor在 Cursor 的终端中输入/add-plugin superpowersGemini CLIgemini extensionsinstallhttps://github.com/obra/superpowersGitHub Copilot CLIcopilot plugin marketplaceaddobra/superpowers-marketplace copilot plugininstallsuperpowerssuperpowers-marketplace验证安装安装成功后输入/help或在支持的平台输入对应命令如果出现以下三个命令即表示安装成功命令功能/superpowers:brainstorm头脑风暴 — 交互式需求澄清与方案设计/superpowers:write-plan编写开发计划 — 将设计拆解为细粒度可执行任务/superpowers:execute-plan执行计划 — 带检查点批量执行遇阻即停这三个命令分别对应流水线的三个阶段。你不必手动调用它们——在绝大多数场景下Superpowers 会在 AI 代理启动时自动触发。三、核心工作流从「想到」到「做完」Superpowers 的核心是一个 7 步工程流水线。下面我们通过一个完整示例——「开发一个 Python 程序读取图片上的文字并用红色方框标注」——来看这套流程是怎么运转的。阶段一头脑风暴Brainstorm当你输入开发需求后Superpowers 不会让 AI 直接写代码而是启动一个苏格拉底式的多轮对话AI: 你希望支持哪些语言中文、英文还是多语言混合 你: 主要是中文但英文也要能识别。 AI: 输入输出格式有什么要求 你: 输入是本地图片文件输出是标注后的新图片文件。 AI: 方框的粗细和颜色需要可配置吗 你: 不需要用默认红色 3px 即可。头脑风暴阶段有几个关键规则设计方案获批前零代码——AI 不能写哪怕一行代码所有假设必须被确认或否定——不允许「我猜你需要……」至少提出 2-3 个方案并分析利弊——让开发者做选择而不是 AI 替你做决定输出正式设计文档——作为后续所有步骤的「契约」阶段二Git 工作区隔离头脑风暴通过后Superpowers 会自动在一个隔离的 Git Worktree中创建新分支。这样做的好处主工作区不受影响随时可以切回去如果实现方向不对直接丢弃整个 worktree没有任何副作用多个并行任务互不干扰阶段三编写计划Write Plan设计文档确定后Superpowers 会将需求拆解为极细粒度的任务每个任务满足2-5 分钟可完成——宁可拆碎不要笼统包含精确文件路径——明确知道要改哪个文件包含验证步骤——写完代码后如何确认它是对的严禁占位符——不允许出现 TODO、待定、后续实现一个典型的任务单元看起来像这样### Task 2/8: 实现 OCR 文字识别模块 **文件**: src/ocr_engine.py **实现内容**: - 使用 pytesseract 调用 Tesseract OCR 引擎 - 支持中文 (chi_sim) 和英文 (eng) 语言参数 - 返回 [(text, bbox), ...] 列表bbox 为 (x, y, w, h) **验证**: python -c from src.ocr_engine import recognize; print(recognize(test.png))阶段四子代理 TDD 执行计划批准后执行阶段不是由主 AI 直接写代码而是派发子代理——每个子代理负责一个独立任务拥有自己的上下文窗口。执行严格遵循TDD测试驱动开发循环RED → 先写一个失败的测试 GREEN → 写最少的代码让测试通过 REFACTOR → 重构代码保持测试绿色每个子代理完成任务后要经过两阶段审查规格符合度审查代码是否严格按设计文档实现有没有多余的功能代码质量审查安全性、性能、可维护性、边界处理是否到位审查不通过子代理必须修改重来直到通过为止。阶段五系统化调试如果测试失败或审查发现 BugSuperpowers 启动四阶段调试流程根因分析精确描述症状定位到具体代码行假设形成基于根因提出修复假设假设验证用最小改动验证假设修复实施确认修复后正式应用改动并补充测试这比「试试这个、试试那个」的随机调试高效得多。阶段六完成前验证所有任务完成后Superpowers 不会直接说「搞定了」。它会启动一个强制验证清单所有测试通过没有遗留的 TODO 或占位符文档和注释同步更新没有调试代码print、console.log 等残留变更文件都在预期范围内没有误改无关文件阶段七分支收尾验证通过后Superpowers 提供清晰的收尾路径✅ 所有任务完成所有检查通过。 请选择 1. 合并到主分支 2. 创建 Pull Request 3. 保留分支稍后处理 4. 丢弃所有变更 请输入选项编号四、14 个核心技能一览Superpowers 的 14 个技能分为四类覆盖从需求到交付的全流程。流程类技能触发时机核心作用brainstorming开始任何实现之前通过多轮对话澄清需求设计技术方案产出设计文档writing-plans设计文档获批后将方案拆解为 2-5 分钟的细粒度任务每个任务含文件路径和验证步骤executing-plans计划获批后带检查点的批量执行追踪进度遇阻即停subagent-driven-development执行每个子任务时派发独立子代理执行单个任务经两阶段审查dispatching-parallel-agents任务可并行时并发派发多个子代理执行独立任务测试与质量技能触发时机核心作用test-driven-development编写任何功能代码时强制 RED-GREEN-REFACTOR 循环不写测试不让写实现systematic-debugging测试失败或发现 Bug 时四阶段结构化调试根因→假设→验证→修复verification-before-completion所有任务完成后强制检查清单测试、TODO、调试代码、改动范围协作类技能触发时机核心作用requesting-code-review子代理完成任务后多代理并行审查安全、性能、风格、规格receiving-code-review收到审查反馈后技术性解析反馈逐条响应而不是笼统接受finishing-a-development-branch验证通过后提供 merge/PR/keep/discard 选项清理工作区工具类技能触发时机核心作用using-git-worktrees启动新开发任务时创建隔离 Git 工作区互不干扰writing-skills需要自定义技能时按最佳实践编写新的 Superpowers 技能using-superpowers代理启动时元技能——教 AI 如何使用这套技能系统本身五、实际效果与适用边界效果数据Superpowers 自 2025 年 10 月发布以来增长迅猛2025 年 10 月初始发布2026 年 1 月约 3 万 Star2026 年 3 月约 12 万 StarGitHub Trending 第一2026 年 4 月16 万 StarAnthropic 官方市场安装量第二23 万 安装社区实践有开发者在社区分享用 Superpowers 从零搭建公司落地页5 分钟头脑风暴 审批计划后30 分钟、5 轮迭代即上线。无需中途纠正 AI 的假设因为所有决策都在 brainstorm 阶段前置解决了。这正是 Superpowers 带来的核心变化把纠错成本从实现阶段前移到设计阶段。在传统 AI 编码流程中你往往在看到代码后才发现问题Superpowers 让你在代码出现之前就把问题解决掉。适用场景强烈推荐使用的场景多文件功能开发新增 API、页面、模块系统重构跨文件的架构调整从零搭建项目需要完整的技术选型和架构设计多人协作项目需要规格文档作为协作基准不熟悉的技术栈用头脑风暴弥补知识空白不太适合的场景单行修复改文案、修颜色、调间距已经充分讨论、只需执行的明确任务上下文窗口紧张的小型项目成本和权衡Superpowers 不是免费的午餐代价说明上下文窗口消耗14 个技能会占用大量上下文空间大型项目可能挤占代码实现空间流程开销头脑风暴和写计划本身需要时间简单任务反而拖慢节奏TDD 的必要性不是所有人习惯 TDD强制 RED-GREEN-REFACTOR 可能感觉束缚学习成本理解 14 个技能的触发时机和协作方式需要实践但换个角度看如果开发的是一个需要 2 小时以上的功能前期的 10-15 分钟澄清和规划通常能节省后期 30-60 分钟的调试和返工。一个重要的事实Superpowers不是不可覆盖的铁律。如果项目的CLAUDE.md中明确写了「不使用 TDD」Superpowers 会遵从项目规则。用户的即时指令始终享有最高优先级。它是一套可配置的纪律系统而不是僵硬的教条。六、与 MCP 和 Skills 的关系如果你看过本站之前关于 MCP、Skills 与 Plugins 的分析可能会问Superpowers 属于 MCP、Skills 还是 Plugin答案是它是一个 Plugin内部由 14 个 Skills 组成。作为 PluginSuperpowers 通过 Claude Code 的插件系统安装用户通过/plugin install注册包含 Skills每个技能都是一个独立的 Skill 文件在特定条件下由代理触发不依赖 MCPSuperpowers 是纯 Skills 系统不涉及外部服务器的协议通信这也反映了 Claude Code 扩展生态的实际使用模式Plugin 是分发单元Skills 是功能单元MCP 是能力接入单元。三者各司其职Superpowers 是利用了 Plugin Skills 这一组合的典型案例。总结Superpowers 解决的核心问题不是「AI 不够聪明」而是**「AI 太急于写代码」**。它用 14 个技能、7 步流水线和不可跳过的检查点强制 AI 在编码前完成需求澄清和计划编写在编码中使用 TDD 和代码审查在完成后进行系统验证。这套流程本质上是在用工程纪律替代随性发挥。如果用一句话总结 Superpowers 的价值它让 AI 不再直接回答「我能写什么代码」而是先回答「我们到底要解决什么问题」。从单行修复到系统重构不同的场景需要不同的工具深度。Superpowers 帮你把 AI 编程从「凭感觉」升级到「按工程标准交付」但这不意味着任何场景都需要它——轻量任务用原生 Claude Code 足够重量任务才需要它的纪律护航。参考资料Superpowers GitHub — 核心仓库包含 14 个技能和安装文档Superpowers Marketplace — 官方插件市场管理分发和版本Claude Code Skills 最佳实践指南 — 社区中文教程包含使用场景和配置示例Claude Code 30k Star 官方插件深度解析 — 阿里云开发者社区的技术分析Anthropic Building Effective Agents — Anthropic 工程博客Agent 设计方法论