Superpowers​ 是一个开源的、基于技能组合的完整软件开发工作流系统由开发者obraJesse创建和维护。自2026年2月发布v4.3.0版本以来这个项目以其独特的设计哲学和强大的自动化能力在AI辅助编程领域引起了广泛关注。与传统代码生成工具不同Superpowers的核心不是直接生成代码而是强制实施系统化的开发流程——它通过一系列可组合的“技能”和初始指令确保你的编码代理遵循最佳实践从需求澄清到代码审查的全过程都在严谨的流程控制下进行。核心价值流程强制化不是建议而是强制执行TDD、YAGNI、DRY等工程原则智能工作流分解自动将复杂任务分解为可管理的子任务子代理驱动开发协调多个AI代理并行工作模拟真实团队协作质量保证自动化内置代码审查、测试验证、调试系统化流程项目定位Superpowers填补了AI代码生成工具与专业软件开发流程之间的空白。它既不是另一个代码补全插件也不是简单的模板系统而是一个完整的工程方法论实现。通过将人类工程师数十年的经验编码为自动化技能它为AI编码代理提供了“超级能力”使其能够像资深工程师一样思考、规划和执行复杂的软件开发任务。主要功能1. 智能需求澄清与设计验证Superpowers的核心创新在于其brainstorming头脑风暴技能。当用户启动编码代理并开始描述需求时系统不会立即跳入代码编写而是首先通过苏格拉底式提问来提炼真实需求。它会探索替代方案考虑边缘情况并将最终设计以易于消化的小块形式呈现给用户进行验证。这种设计优先的方法确保了开发方向从一开始就是正确的避免了后期昂贵的重构。2. 系统化实施规划一旦设计获得批准writing-plans编写计划技能会自动激活。它将工作分解为可管理的任务单元每个任务都精确到2-5分钟的工作量。每个任务包含确切的文件路径、完整代码示例和验证步骤。这种精细化的规划确保了即使是没有项目背景、品味不佳、判断力有限且厌恶测试的初级工程师也能清晰跟随真正实现了计划的可靠执行。3. 子代理驱动并行开发subagent-driven-development子代理驱动开发技能是Superpowers最强大的功能之一。系统为每个工程任务启动一个全新的子代理实施两阶段审查流程首先检查规范符合性然后评估代码质量。这种机制允许Claude等AI代理能够自主工作数小时而不偏离原始计划显著提升了开发效率和代码一致性。4. 严格的测试驱动开发test-driven-development测试驱动开发技能强制实施RED-GREEN-REFACTOR循环先编写失败测试观察其失败编写最小化代码使其通过然后进行重构。系统会自动删除在测试之前编写的任何代码确保测试始终先行。这种严格的TDD执行消除了测试后补的常见反模式从根本上保证了代码质量。5. 系统化调试与问题解决systematic-debugging系统化调试技能提供了一个四阶段的根本原因分析流程包括根因追踪、深度防御、条件等待等技术。结合verification-before-completion完成前验证技能确保问题被真正解决而不仅仅是症状被掩盖。这种系统化的方法将调试从艺术转变为可重复的科学过程。6. 协作与代码审查自动化requesting-code-review请求代码审查技能在任务之间自动激活根据预定义清单进行审查并按严重程度报告问题。关键问题会阻止进展确保只有高质量代码才能进入下一阶段。receiving-code-review接收代码审查技能则帮助代理有效响应反馈形成完整的协作闭环。7. Git工作流与分支管理using-git-worktrees使用Git工作树技能在设计批准后自动创建隔离的工作空间和新分支运行项目设置并验证干净的测试基线。finishing-a-development-branch完成开发分支技能在任务完成时验证测试提供合并/PR/保留/丢弃选项并清理工作树确保版本控制的规范使用。8. 技能扩展与自定义writing-skills编写技能技能允许用户创建新的技能遵循最佳实践和测试方法学。这种元编程能力使Superpowers成为一个可扩展的平台用户可以根据特定需求定制开发流程形成个性化的超级能力集合。安装与配置平台差异说明Superpowers的安装方法因目标平台而异主要支持三种AI编码环境Claude Code官方Claude开发环境、CodexOpenAI的代码生成系统和OpenCode开源替代方案。每个平台都有特定的集成方式用户需要根据自己使用的工具选择正确的安装路径。Claude Code安装通过插件市场对于使用Claude Code的用户安装过程最为简单注册插件市场在Claude Code中执行命令/plugin marketplace add obra/superpowers-marketplace安装插件执行/plugin install superpowerssuperpowers-marketplace验证安装启动新会话要求Claude帮助触发技能的任务如“帮我规划这个功能”或“调试这个问题”Claude应自动调用相关的superpowers技能Codex安装流程Codex用户需要通过特定指令进行安装获取安装指令告诉Codex“获取并遵循来自 https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md的指令”执行安装脚本Codex将自动获取并执行安装脚本配置必要的环境和工作流环境验证确保所有依赖项正确安装技能能够正常触发OpenCode安装步骤OpenCode用户需要类似的指令驱动安装触发安装过程告诉OpenCode“获取并遵循来自 https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md的指令”系统配置安装脚本将自动配置技能目录、钩子函数和集成点测试集成验证Superpowers技能能够与OpenCode正常交互安装验证与故障排除无论使用哪个平台安装后都应进行验证启动测试会话创建一个新的开发会话触发技能提出需要规划或实施的任务如“我想构建一个用户认证系统”观察行为正确的安装应导致代理启动brainstorming技能而不是直接开始编码检查日志如有问题查看平台日志中是否有技能加载错误更新与维护Superpowers技能在插件更新时自动更新更新命令在Claude Code中执行/plugin update superpowers版本检查定期查看RELEASE-NOTES.md了解新功能和修复向后兼容性主要版本更新可能涉及工作流变化建议在测试环境中先行验证如何使用基础工作流程第一步需求启动与头脑风暴用户通过自然语言描述开发需求如“我需要一个任务管理API”。Superpowers的brainstorming技能会自动激活引导对话深入核心需求。代理会提出澄清问题“这个API需要支持哪些操作用户权限如何管理数据持久化要求是什么”通过这种苏格拉底式对话粗糙的想法被提炼为精确的规格。第二步设计验证与批准系统将设计文档分解为易于消化的小块呈现给用户。每个部分都包含关键决策点和替代方案评估。用户逐部分审阅并提供反馈最终签署批准完整设计。这个过程中设计被保存为结构化文档作为后续所有开发活动的单一事实源。第三步实施计划制定writing-plans技能基于批准的设计创建详细的实施计划。工作被分解为微小任务每个任务都有明确的输入、输出、文件路径和验证步骤。计划的可读性极高确保即使是没有上下文的新手也能准确执行。用户审阅计划确认任务分解的合理性和完整性。第四步子代理驱动执行subagent-driven-development技能为每个任务启动专用子代理。每个子代理遵循两阶段审查首先验证产出是否符合规范然后评估代码质量。主代理协调所有子代理的工作确保整体一致性。用户可以在关键节点介入审查进展或调整方向。第五步测试驱动开发循环在编码阶段test-driven-development技能强制RED-GREEN-REFACTOR循环。每个功能都从失败测试开始逐步演进到完整实现。系统自动检测并拒绝在测试之前编写的代码确保测试覆盖率从第一天就是100%。第六步自动化代码审查任务完成后requesting-code-review技能自动触发根据预定义清单检查代码质量。问题按严重程度分类关键问题会阻止继续前进。这种自动化的质量门禁确保了代码库的长期健康。第七步分支管理与交付finishing-a-development-branch技能验证所有测试通过提供交付选项直接合并、创建拉取请求、保留分支或丢弃更改。无论选择哪种方式工作树都会被适当清理保持版本控制的整洁。高级工作模式并行代理协作模式对于大型项目dispatching-parallel-agents技能允许同时启动多个专业代理处理不同模块。例如一个代理处理数据库模式另一个处理API端点第三个处理前端组件。主代理协调它们的工作解决接口冲突确保整体架构一致性。增量交付与反馈循环系统支持将大型项目分解为多个可独立交付的增量。每个增量都经历完整的工作流但范围控制在几天的工作量内。这种模式特别适合敏捷环境允许早期用户反馈和方向调整。遗留代码现代化改造当处理遗留代码库时systematic-debugging技能与test-driven-development技能结合先为现有行为添加测试然后安全地进行重构。这种“测试加固再改造”的方法显著降低了现代化改造的风险。技能定制与扩展高级用户可以使用writing-skills技能创建领域特定的超级能力。例如为数据科学项目添加“数据验证工作流”技能或为Web开发添加“响应式设计测试”技能。这种扩展性使Superpowers能够适应各种专业场景。最佳实践指南会话管理策略长期会话对于多日项目保持会话开放以维持上下文连续性检查点保存定期保存设计文档和计划防止意外丢失上下文修剪对于非常长的会话有选择地修剪早期对话以保持性能技能触发优化明确触发词使用“规划”、“设计”、“实施”等明确词汇启动相应技能避免模糊请求具体描述需求而非模糊陈述以获得更精确的响应分阶段请求对于复杂项目分阶段请求帮助而不是一次性要求完整解决方案质量控制设置审查严格度调整根据项目阶段调整代码审查的严格程度测试覆盖目标为不同模块设置适当的测试覆盖目标技术债务管理定期使用技能识别和规划技术债务偿还应用场景实例实例1初创公司最小可行产品快速迭代场景描述一家教育科技初创公司团队只有3名开发者需要在6周内推出课程管理系统的MVP。传统开发模式下需求频繁变更导致代码混乱测试覆盖不足技术债务快速积累。团队陷入“快速开发-紧急修复”的恶性循环产品稳定性差用户反馈负面。解决方案技术负责人引入Superpowers作为核心开发工作流。首先团队使用brainstorming技能与Claude代理进行需求会话。通过系统化提问模糊的“课程管理系统”被提炼为精确的功能规格用户认证、课程创建、内容上传、进度跟踪四个核心模块每个模块都有明确的API端点和数据模型。writing-plans技能将6周工作分解为84个精细任务每个任务平均30分钟。例如“实现用户注册端点”被分解为1) 创建用户模型2) 实现密码哈希3) 添加输入验证4) 编写集成测试。这种粒度确保了即使初级开发者也能准确执行。在实施阶段subagent-driven-development技能为每个任务启动专用代理。test-driven-development技能强制每个功能都从测试开始。当团队临时决定添加“社交媒体分享”功能时系统自动调整计划重新评估优先级确保核心功能不受影响。实施效果开发速度提升40%6周计划提前2天完成代码缺陷率降低75%生产环境严重bug为零测试覆盖率从20%提升到92%技术债务可控代码库保持整洁可维护MVP发布后用户满意度达4.8/5.0为后续融资奠定基础实例2企业级微服务架构迁移项目场景描述一家金融科技公司决定将单体应用迁移到微服务架构。现有系统有50万行代码数百个相互依赖的模块。迁移团队面临巨大挑战如何安全解耦如何确保新服务与旧系统兼容如何协调多个团队并行工作传统规划方法无法处理这种复杂性。解决方案架构委员会采用Superpowers作为迁移项目的协调中枢。首先brainstorming技能帮助团队识别迁移策略绞杀者模式逐步替换而非一次性重写。系统生成详细的设计文档将单体分解为12个微服务每个都有明确的边界和接口契约。writing-plans技能创建了分阶段的迁移路线图阶段1解耦用户服务阶段2解耦交易服务以此类推。每个阶段都包含回滚计划和兼容性保证。计划特别强调了“增量可验证性”——每个小步骤都能独立测试和部署。在实施中dispatching-parallel-agents技能协调4个开发团队同时工作。每个团队负责3个微服务主代理确保接口一致性和整体进度同步。requesting-code-review技能在服务间集成时自动触发检查API兼容性和数据一致性。当发现性能瓶颈时systematic-debugging技能引导团队进行四阶段分析1) 重现问题2) 收集数据3) 假设验证4) 修复验证。这种系统化方法在三天内解决了困扰团队两周的性能问题。实施效果18个月迁移项目按时完成预算控制在110%零数据丢失服务中断时间小于0.1%系统性能提升300%资源使用降低40%团队协作效率提升50%接口冲突减少80%新架构支持了公司用户规模从100万到1000万的扩张实例3开源项目社区协作质量提升场景描述一个流行的开源数据可视化库拥有200名贡献者每月接收50个拉取请求。维护团队面临挑战代码质量参差不齐审查负担沉重新贡献者上手困难。项目活跃度开始下降关键维护者出现倦怠。解决方案核心维护团队将Superpowers集成到项目贡献工作流中。他们在CONTRIBUTING.md中添加了Superpowers使用指南并创建了项目特定的技能扩展数据可视化最佳实践、性能测试模式、可访问性检查清单。新贡献者按照指南启动Claude代理与Superpowers。brainstorming技能帮助他们澄清功能需求writing-plans技能将复杂功能分解为可管理的小块。即使是没有经验的贡献者也能产出符合项目标准的代码。对于拉取请求审查requesting-code-review技能自动运行项目特定的检查清单。系统不仅检查代码风格还验证性能影响、浏览器兼容性和可访问性。维护者可以将精力集中在架构审查上而不是基础质量检查。当项目需要重大重构时团队使用subagent-driven-development技能协调多个贡献者同时工作。系统确保重构的每一步都保持向后兼容所有测试持续通过。这种协调能力使原本需要数月的工作在几周内完成。实施效果拉取请求合并时间从平均14天缩短到3天代码审查负担减少70%维护者倦怠显著缓解新贡献者首次贡献成功率从30%提升到85%项目质量评分在开源排名中从第15位上升到第3位社区活跃度恢复增长月活跃贡献者增加120%实例4教育机构编程教学改革场景描述一所大学的计算机科学系传统编程教学注重语法和算法但毕业生缺乏工程实践能力。学生在个人项目中能够编写代码但在团队协作、测试编写、代码审查等方面表现不佳。雇主反馈毕业生需要数月培训才能达到生产标准。解决方案教学委员会将Superpowers引入软件工程课程。学生在课程项目中必须使用Superpowers工作流完成作业。教学重点从“如何写代码”转变为“如何工程化地开发软件”。在课程设计中brainstorming技能帮助学生将模糊的项目想法转化为精确的规格。writing-plans技能教导他们任务分解的艺术。test-driven-development技能强制他们养成测试先行的习惯——这是传统教学中难以灌输的思维模式。最革命性的变化在团队项目中。学生使用dispatching-parallel-agents技能模拟真实团队协作。每个学生负责一个模块系统确保接口一致性和集成质量。requesting-code-review技能让他们体验专业代码审查流程学习如何给出和接收建设性反馈。教师使用Superpowers的元技能创建课程特定的检查清单学术诚信验证、学习目标对齐、复杂度适当性等。系统自动评估学生作业的工程质量而不仅仅是功能正确性。实施效果学生工程能力评估分数提升60%毕业生雇主满意度从65%提高到92%学生项目完成率从70%提升到95%教学效率提高教师能够指导更多学生而不降低质量课程成为学校招牌申请计算机科学专业的学生增加40%实例5自由职业者多项目并行管理场景描述一位全栈开发自由职业者同时为5个客户维护项目。每个项目技术栈不同、需求紧急度不同、质量标准不同。传统工作模式下上下文切换成本高昂项目间质量不一致客户沟通负担沉重收入增长遇到瓶颈。解决方案自由职业者将Superpowers作为个人开发操作系统。他为每个客户项目创建独立的Superpowers配置定制项目特定的技能客户A需要严格的类型安全客户B注重快速迭代客户C要求完整的文档。daily-planning技能帮助他规划每周工作周一处理客户A的紧急bug周二开发客户B的新功能周三进行客户C的代码审查。系统根据截止日期、计费率和项目重要性自动优化时间分配。在具体开发中subagent-driven-development技能允许他同时推进多个任务。当客户A的bug需要深入调试时systematic-debugging技能引导他高效定位问题而不是盲目尝试。当客户B要求快速原型时test-driven-development技能确保即使快速开发也不牺牲质量。对于客户沟通Superpowers自动生成进度报告完成的任务、遇到的问题、下一步计划。这些报告基于实际工作数据而不是模糊的估计显著提升了客户信任。实施效果项目交付准时率从60%提高到95%客户满意度评分从4.0提升到4.85分制年收入增长80%而工作时间仅增加20%工作压力显著降低从救火模式转变为系统化工作建立了专业声誉获得了更高价值的长期合同实例6企业内部工具开发团队转型场景描述一家零售企业的内部IT部门负责开发维护库存管理、员工排班、销售分析等内部工具。团队由10名开发者组成但技能水平参差不齐。项目经常延期bug频发业务部门抱怨工具难用。IT部门被视为成本中心而非价值创造者。解决方案IT总监引入Superpowers作为团队标准工作流。首先团队使用brainstorming技能与业务部门进行需求工作坊。通过系统化提问模糊的“更好用的库存系统”被转化为具体的用户故事和验收标准。团队建立了内部技能库零售行业数据模型、高并发处理模式、离线同步策略等。这些领域知识被编码为可重用的技能确保即使新加入的开发者也能快速产出符合行业标准的代码。在开发过程中test-driven-development技能显著提升了代码质量。当销售分析工具出现性能问题时systematic-debugging技能帮助团队在两天内定位并解决了数据库查询优化问题而之前类似问题需要两周。对于跨团队协作dispatching-parallel-agents技能允许库存团队、排班团队、分析团队并行工作同时确保数据模型一致性。requesting-code-review技能在集成点自动触发防止接口不匹配导致的后期返工。实施效果项目平均延期时间从45天减少到5天生产环境严重事故减少90%业务部门满意度从3.5提升到4.65分制团队士气显著提升开发者从被动救火转变为主动创新IT部门重新定位为数字化转型引擎获得了更多预算和资源GitHub地址项目地址https://github.com/obra/superpowers项目关键信息项目名称Superpowers - A complete software development workflow for your coding agents创建者obraJesse最新版本v4.3.02026年2月13日发布开源协议MIT License星标趋势持续增长的开发者关注度技术基础基于可组合技能系统的AI辅助编程工作流主要语言技能定义使用Markdown和特定领域语言项目结构obra/superpowers/ ├── .claude-plugin/ # Claude Code插件配置 ├── .codex/ # Codex平台配置和安装脚本 ├── .opencode/ # OpenCode平台配置 ├── agents/ # 代理定义和配置 ├── commands/ # 斜杠命令定义 ├── docs/ # 文档资源 ├── hooks/ # 平台钩子函数 ├── lib/ # 核心库和工具函数 ├── skills/ # 技能库核心目录 │ ├── brainstorming/ # 头脑风暴技能 │ ├── test-driven-development/ # TDD技能 │ ├── systematic-debugging/ # 系统化调试 │ ├── writing-plans/ # 计划编写技能 │ ├── subagent-driven-development/ # 子代理开发 │ └── ...其他技能 ├── tests/ # 测试套件 ├── .gitattributes # Git配置 ├── .gitignore # 忽略文件配置 ├── LICENSE # MIT许可证 ├── README.md # 项目主文档 └── RELEASE-NOTES.md # 版本发布说明技术特色技能触发自动化基于上下文自动激活相关技能无需手动调用工作流强制实施不是建议而是强制执行工程最佳实践多平台支持Claude Code、Codex、OpenCode全平台覆盖可扩展架构模块化技能系统支持自定义扩展质量门禁集成自动化代码审查、测试验证、调试流程子代理协调智能协调多个AI代理并行工作社区资源官方文档README.md提供完整的使用指南技能开发指南skills/writing-skills/SKILL.md详细说明如何创建新技能问题追踪GitHub Issues用于反馈和功能请求赞助支持开发者接受GitHub Sponsors赞助以持续维护更新日志RELEASE-NOTES.md记录所有版本变化快速开始命令# Claude Code用户 /plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace # Codex用户 告诉Codex获取并遵循来自 https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md 的指令 # OpenCode用户 告诉OpenCode获取并遵循来自 https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md 的指令项目愿景Superpowers代表着AI辅助编程的范式转变——从简单的代码生成工具升级为完整的工程方法论实施系统。它不仅仅自动化了编码任务更重要的是自动化了工程思维。通过将资深工程师的隐性知识编码为显性技能它使AI代理能够像人类专家一样进行系统化思考、规划和执行。在软件开发日益复杂、人才短缺持续的背景下Superpowers为提升全球软件开发效率和质量提供了切实可行的解决方案。其开源本质和可扩展架构确保了它能够持续进化适应不断变化的技术 landscape最终推动整个行业向更高水平的工程卓越迈进。