Superpowers 发布说明
摘要
Superpowers 是面向Claude生态的技能增强插件，本页面记录了Superpowers从v2.0.0到v4.0.3版本的所有发布更新内容，涵盖新功能、功能改进、错误修复、破坏性变更等信息。核心更新方向包括强化Claude按用户要求调用技能的合规性、重构技能架构、新增标准化测试框架、优化多阶段工作流支持等。
版本更新记录
v4.0.3 (2025-12-26)
改进
- 强化显式技能请求场景下的技能调用 解决了用户按名称明确请求技能时，Claude仍会跳过调用直接处理的问题，修改内容包括：
- 将核心规则从“检查是否有适用技能”修改为“调用相关或请求的技能”，强调主动调用而非被动检查
- 新增规则：任何响应或操作之前必须完成技能检查
- 补充说明：调用错技能也没关系，减少调用犹豫
- 新增风险标记：“我知道这是什么意思”不代表不需要调用对应技能
- 新增显式技能请求测试套件
在
tests/explicit-skill-requests/新增测试套件，验证用户按名称请求技能时Claude可以正确调用，覆盖单轮和多轮对话场景。
v4.0.2 (2025-12-23)
修复
- 斜杠命令改为仅用户可调用：给
/brainstorm、/execute-plan、/write-plan三个斜杠命令添加disable-model-invocation: true限制，Claude无法再通过Skill工具调用这些命令，仅支持用户手动触发；对应的底层技能仍然对Claude开放，该修改避免了冗余调用引发的混淆。
v4.0.1 (2025-12-23)
修复
- 澄清Claude Code中技能的调用方式：修正了Claude调用技能后重复读取技能文件的问题，
using-superpowers技能明确说明Skill工具会直接加载技能内容，无需额外读取文件 - 给receiving-code-review新增GitHub线程回复指南，建议在原线程回复内联评审评论而非新增顶层PR评论
- 给writing-skills新增自动化优先于文档的指导，建议机械约束用自动化实现而非文档记录，技能仅保留需要人工判断的内容。
v4.0.0 (2025-12-17)
新功能
- 子驱动开发支持两阶段代码评审：每个任务完成后增加两个独立评审阶段：先做规范一致性评审（验证代码完全匹配需求，同时捕获遗漏需求和过度构建），通过后再做代码质量评审（评审代码整洁度、测试覆盖率、可维护性），评审是循环流程，发现问题后修复再重新评审
- systematic-debugging整合了配套调试技术和工具，包含根因追溯、深度防御、基于条件的等待、污染测试二分脚本等内容
- 测试驱动开发新增测试反模式参考，覆盖了伪造行为测试、生产类新增测试专属方法、不理解依赖就做Mock、不完整Mock隐藏结构假设等常见问题
- 新增三类技能测试基础设施：技能触发测试（验证无需显式命名就能触发对应技能）、Claude Code集成测试（支持无头测试和成本分析）、子驱动开发端到端测试（包含两个完整测试项目）
主要变更
- 使用DOT流程图作为可执行规范：核心技能使用DOT/GraphViz流程图作为权威流程定义，文档仅作为补充内容；修复了“描述陷阱”（描述包含流程总结时Claude会忽略详细流程图），要求技能描述仅保留触发条件，不包含流程细节
- 技能优先级规则：多个技能适用时，流程类技能（头脑风暴、调试）优先于实现类技能
- 强化头脑风暴触发规则：描述改为强制要求：任何创意工作（创建功能、构建组件等）之前必须使用该技能
破坏性变更
- 技能合并：6个独立技能被合并整合，
sharing-skills因过时被移除
更早版本更新
| 版本 | 日期 | 核心变更 |
|---|---|---|
| v3.6.2 | 2025-12-03 | 修复Linux兼容性问题，解决dash环境下的替换错误 |
| v3.5.1 | 2025-11-24 | 重构OpenCode启动注入逻辑，消除重复加载技能问题 |
| v3.5.0 | 2025-11-23 | 新增原生OpenCode.ai支持，重构Codex实现消除代码冗余 |
| v3.4.1 | 2025-10-31 | 优化启动逻辑，消除冗余技能执行 |
| v3.4.0 | 2025-10-30 | 简化头脑风暴技能，回归自然对话流程 |
| v3.3.1 | 2025-10-28 | 更新头脑风暴技能规则，修复技能目录路径说明错误 |
| v3.3.0 | 2025-10-28 | 新增实验性Codex支持 |
| v3.2.3 | 2025-10-23 | 更新调用说明，要求使用Skill工具而非Read工具调用技能 |
| v3.2.2 | 2025-10-21 | 强化using-superpowers规则，防止Claude找理由跳过技能调用 |
| v3.2.1 | 2025-10-20 | 内置代码评审Agent，无需用户单独配置 |
| v3.2.0 | 2025-10-18 | 头脑风暴新增设计文档阶段，统一技能引用命名空间 |
| v3.1.1 | 2025-10-17 | 修复README中的命令语法错误 |
| v3.1.0 | 2025-10-17 | 统一技能小写命名，增强头脑风暴功能，整合Anthropic最佳实践 |
| v3.0.1 | 2025-10-16 | 适配Anthropic原生技能系统 |
| v2.0.2 | 2025-10-12 | 修复本地仓库超前于上游时的错误更新提示 |
| v2.0.1 | 2025-10-12 | 修复启动钩子静默错误问题 |
| v2.0.0 | 2025-10-12 | 架构大重构，技能独立到单独仓库，支持社区协作更新，新增多个问题解决技能 |
关键要点
- Superpowers核心目标是让Claude在开发任务中主动、正确调用预设技能，减少跳过技能、错误调用的问题
- v4.0版本引入了标准化技能测试框架，保证技能触发和使用的稳定性
- 两阶段代码评审解决了现有工作流中“代码写得好但不符合需求”的常见问题
- 技能支持多平台：Claude Code、Codex、OpenCode.ai均有适配
- v2.0后采用插件和技能仓库分离架构，技能可以独立迭代更新，支持社区贡献