superpowers

一简介Superpowers https://github.com/obra/superpowers 是一个为 AI 编程代理如 Claude Code、Codex、OpenCode打造的完整软件开发工作流系统。它的核心理念是通过一套可组合的”技能”Skills和初始指令让 AI 代理在编写代码时自动遵循最佳实践而不是像”没有经验的初级工程师”那样随意行事。旨在解决“一句需求” 从头脑风暴→写计划→执行计划让AI编程助手秒变专业开发团队自动遵循TDD测试驱动开发一次通过零报错真正实现代码质量质的飞跃。包含的skill1.1 核心设计哲学测试驱动开发TDD永远先写测试。没有看到测试失败就不能确定测试是否真正测试了正确的行为。系统化而非临时化用流程替代猜测。每个技能都有明确的决策流程图用 DOT/GraphViz 语法定义作为”可执行规范”。复杂度削减以简洁为首要目标。技能中反复强调 YAGNIYou Aren’t Gonna Need It原则积极删除不必要的功能。证据而非声明在宣布任务完成之前必须验证。看到测试通过看到代码运行而不是”我觉得应该可以了”。1.2 技能库详解项目包含 14 个核心技能分为几大类别测试类test-driven-development强制执行 RED-GREEN-REFACTOR 循环。核心规则是”先写测试失败的代码删掉重新来”包含详细的反模式参考调试类systematic-debugging四阶段根因定位流程整合了 root-cause-tracing逆向追踪调用栈、defense-in-depth多层验证、condition-based-waiting基于条件的等待替代任意超时等技术verification-before-completion确保问题真正被修复协作类brainstorming苏格拉底式设计提炼writing-plans详细实现计划executing-plans批量执行与检查点dispatching-parallel-agents并发子代理工作流requesting-code-review / receiving-code-review代码审查的请求与响应using-git-worktrees并行开发分支finishing-a-development-branch合并/PR 决策工作流subagent-driven-development两阶段审查的快速迭代元技能using-superpowers技能系统入门writing-skills如何创建新技能包含测试方法论1.3 总结Superpowers 本质上是在回答一个问题如何让 AI 代理像有经验的工程师一样工作而不是像”会写代码但不懂工程”的实习生答案是把最佳实践编码成可执行的、不可逃避的工作流。用流程图定义决策点用测试验证行为用子代理实现关注点分离用两阶段审查确保质量。这个项目对于想要提升 AI 编程效率和质量的开发者来说是一个非常值得学习和使用的工具。二安装支持Claude Code、Cursor 、Codex、OpenCode、Gemini CLI。2.1 Claude Code/plugin查找安装插件/reload-plugins激活插件。/help检查是否安装成功。/superpowers:brainstorm - 头脑风暴/superpowers:write-plan - 写计划/superpowers:execute-plan - 执行计划2.2 CursorTry in chatSuperpowers 插件本质上是一个“开发方法库 自动协作能力”你现在可以这样用它包含什么Skills技能一组可复用流程TDD、调试、规划、代码评审等可被我自动调用也可你手动触发。Subagents子代理专门执行某类任务的独立代理你这套里有 code-reviewer。Hooks钩子会话级自动行为当前有 sessionstart会在会话开始时生效。Rules规则插件内置约束会自动应用不需要你手动开关。Commands命令可通过 / 调用你现在看到的 brainstorm / execute-plan / write-plan 已标注为 deprecated建议直接用对应 skill。你如何触发手动触发推荐显式在输入框用 / 调技能或子代理例/superpowers:writing-plans先产出实现计划例/superpowers:test-driven-development先写测试再实现例/code-reviewer做阶段性代码审查自动触发你只要描述目标我会按场景自动选择合适 skill例如遇到报错走 systematic-debugging做功能走 test-driven-development。典型工作流最实用做新功能writing-plans → test-driven-development → 实现 → verification-before-completion → requesting-code-review排查问题systematic-debugging → 定位根因 → 修复 → 验证多任务并行dispatching-parallel-agents适合相互独立的任务分支收尾finishing-a-development-branch测试通过后决定 PR/合并/清理这套插件的关键价值把“怎么做”标准化不是只给答案而是给可靠流程。在你忘记步骤时自动补齐如先测后改、改后验证、提交前审查。适合中大型任务能显著减少“修了又坏”的反复。三完整工作流程Superpowers 构建了一个端到端的开发流程头脑风暴brainstorming 编写代码前激活。当你说”我想做一个 X 功能”时AI 不会直接写代码。它会像苏格拉底式对话一样一次问一个问题帮你厘清真正的需求。设计方案分 200-300 字的小节呈现每节都要你确认”看起来对吗”。通过提问细化粗略想法探索替代方案分模块展示设计方案供用户验证并保存设计文档。使用 Git 工作树using-git-worktrees设计方案通过批准后激活。在新分支创建独立工作区完成项目初始化验证干净的测试基线。编写计划writing-plans 设计方案通过批准后激活。把设计拆解成 2-5 分钟的小任务。每个任务都有精确的文件路径、完整的代码片段、验证步骤。目标是让”一个没有判断力、没有项目背景、讨厌写测试的热情初级工程师”也能执行。子智能体驱动开发 / 执行计划subagent-driven-development /executing-plans设计方案通过批准后激活。为每个任务分配全新子智能体执行两阶段评审先验证是否符合规格再检查代码质量或批量执行任务并设置人工检查点。测试驱动开发test-driven-development实施阶段激活。强制遵循红-绿-重构流程编写失败测试用例 → 观察失败 → 编写最简代码 → 观察通过 → 提交。删除测试前编写的代码。请求代码评审requesting-code-review任务间激活。对照计划进行评审按严重程度报告问题关键问题将阻塞项目进度。完成开发分支finishing-a-development-branch任务完成后激活。验证测试提供选项合并/拉取请求/保留/丢弃清理工作树。四从 0 到 1 的使用路径第 1 步启动头脑风暴在聊天里输入/superpowers:brainstorming目标先澄清需求不急着写代码。第 2 步逐题澄清一次只问一个问题我会按流程问你目的、约束、成功标准。你只需要短答比如“给谁用、必须支持什么、上线时间”。第 3 步方案对比2-3 个我会给你 2-3 条实现路径 取舍 推荐方案。你选定后我再给完整设计架构/组件/数据流/异常/测试。第 4 步设计确认后再进入实现设计确认后进入/superpowers:writing-plans然后再走实现/superpowers:test-driven-development最后验收/superpowers:verification-before-completion必要时 /code-reviewer 审查。4.1 你在每一步要做什么你负责回答问题、拍板方案、确认设计。我负责控流程、收敛需求、给出可执行设计和后续计划。关键原则先设计后实现未确认设计前不写代码。4.2 一段最小可用示例你可以直接复制思路你/superpowers:brainstorming 我要做一个员工请假审批功能我先问 1 个问题比如“优先 PC 还是移动端”你回答我继续单题澄清 → 给 2-3 个方案 → 你选我输出设计并让你确认你确认后输入 /superpowers:writing-plans我生成实施计划再进入 TDD 实现和验证五实战第 1 步启动头脑风暴/superpowers:brainstorming第 2 步逐题澄清一次只问一个问题第 3 步方案对比2-3 个第 4 步设计确认后再进入实现第 5 步编写计划writing-plans第 6 步测试驱动开发test-driven-development第 7 步收尾finishing-a-development-branch