⚡
★ 86.6k

第十一章：更新日志

Superpowers 的完整发布历史。发布按时间倒序排列（最新的在前）。

v5.0.2 — 2026 年 3 月

主题： 基础设施弹性与会话管理

新增内容

  • 零依赖头脑风暴服务器。 头脑风暴伴侣现在无需任何外部依赖即可运行。头脑风暴服务器不需要 npm install——它仅运行在 Node.js 内置模块上。这消除了整类设置失败，并使头脑风暴功能在克隆后立即可用。

  • 30 分钟空闲自动退出。 已空闲 30 分钟的长时间运行会话会自动干净退出。这防止了孤立进程，减少了资源消耗，并确保会话不会积累来自数小时前工作的陈旧上下文。

  • 上下文隔离改进。 Sub-agent 上下文现在与父上下文更严格地隔离。一个 agent 调查的信息不会泄漏到另一个 agent 的推理中，防止了一类微妙的污染 bug，其中 agent 会"记住"来自它不应该访问的并行工作流的内容。

Bug 修复

  • 修复了当默认端口被占用时头脑风暴服务器无法启动的边界情况
  • 修正了深度嵌套 agent 树的上下文序列化

v5.0.1 — 2026 年 3 月

主题： 平台扩展

新增内容

  • Gemini CLI 扩展支持。 Superpowers 现在通过扩展系统完全支持 Google 的 Gemini CLI。所有核心 skills——TDD、系统化调试、验证、代码审查、worktrees——都可以在 Gemini CLI 上使用，与 Claude Code 具有相同的执行保障。配置说明包含在安装文档中。

备注

这是一个平台支持版本。现有 skills 或规范没有行为变更。

v5.0.0 — 2026 年 3 月

主题： 视觉推理与文档智能

新增内容

  • 视觉头脑风暴伴侣。 新的伴侣模式将头脑风暴过程渲染为交互式视觉图表。在头脑风暴进行时以视觉方式查看想法、联系和决策树。对于复杂的架构决策和系统设计工作特别有用。

  • 文档审查系统。 用于审查技术文档的新功能——RFC、架构决策记录、设计文档和规格说明——与代码审查应用相同的严格性。文档审查系统检查内部一致性、缺失的边界情况和未陈述的假设。

  • 架构指导 skill。 用于架构级决策的新专用 skill。在设计系统、选择数据存储、规划服务边界或做出影响多个组件的决策时激活。为权衡分析提供结构化框架。

破坏性变更

  • v4.3.0 的头脑风暴硬门现在也适用于架构讨论。在完成头脑风暴 + 文档审查循环之前，你不能开始架构实现。

v4.3.1 — 2026 年 2 月

主题： 官方 Cursor 支持

新增内容

  • Cursor IDE 官方支持。 对 Cursor IDE 的完整 Superpowers 支持。所有 skills、规范和铁律都可以通过 Cursor 的 rules 系统使用。安装文档涵盖 Cursor 特定配置，包括如何将 skills 映射到 Cursor 的 composer 和聊天界面。

  • 针对长会话中上下文窗口限制的 Cursor 特定解决方案

  • 记录了专用的 Cursor 配置文件格式

v4.3.0 — 2026 年 2 月

主题： 头脑风暴执行

新增内容

  • 头脑风暴硬门。 创意工作——构建新功能、设计新组件、添加新行为——现在在任何实现开始之前都需要完成头脑风暴会话。这是一个硬门：agent 不会在没有完成头脑风暴的情况下进行实现。以前这是一个软性建议；现在它被强制执行。

  • 指定了头脑风暴会话的最低要求：问题探索、至少考虑两种替代方案、做出明确决策并记录理由。

原理

对 v4.2.x 会话日志的分析表明，73% 的重大返工发生在跳过头脑风暴的功能上。软性建议没有被一致遵循。硬门解决了这个问题。

v4.2.0 — 2026 年 2 月

主题： 隔离与 main 分支保护

新增内容

  • 强制 worktree 隔离。 所有功能开发现在都需要一个 git worktree。不再允许在功能分支上直接在主仓库检出中工作。每个功能、每个 bugfix、每个实验都有自己的隔离 worktree 目录。

  • Main 分支保护。 规范现在明确禁止直接 commit 到 main。所有变更必须通过分支，并通过本地合并（含测试）或 pull request 进行。

  • 更新第八章，包含五步 worktree 创建流程和四个完成选项。

影响

从 v4.1.x 迁移的项目需要采用 worktree 工作流。过渡指南在安装文档中。

v4.0.0 — 2025 年 12 月

主题： 审查基础设施与调试工具链

新增内容

  • 两阶段代码审查。 代码审查现在是两阶段流程：第一阶段是自动静态分析，第二阶段是 subagent 审查。这确保机器可检测的问题在消耗 subagent 注意力之前就被发现，subagent 的注意力被保留用于架构和逻辑问题。

  • 计划中的 DOT 流程图。 实现计划现在可以包含以视觉方式渲染的 DOT 语言流程图。带有条件分支的复杂多步骤计划在可视化后显著更容易审查和理解。

  • 捆绑调试工具。 Superpowers 现在附带一套调试工具：结构化日志分析、测试失败模式检测和回归二分助手。这些工具支持第六章中描述的四阶段调试流程。

破坏性变更

  • 计划格式更新以支持 DOT 流程图块。旧格式的现有计划继续有效，但不会渲染视觉流程图。
  • 两阶段审查改变了 superpowers:requesting-code-review 的结构。更新任何自定义审查自动化。

v3.5.0

主题： OpenCode 平台支持

新增内容

  • OpenCode 支持。 Superpowers 现在支持 OpenCode 平台。包含配置和 skill 映射文档。

v3.3.0 — 2025 年 10 月

主题： 实验性 Codex 集成

新增内容

  • 实验性 Codex 支持。 对 OpenAI Codex 的早期访问支持。核心 skills 可用；某些高级功能受限。标记为实验性——行为可能在后续版本中更改。

  • Codex 的已知限制：上下文窗口限制影响长规划会话；某些 skill 触发需要显式命名而非自动检测。

v3.2.0 — 2025 年 10 月

主题： 设计文档与命名空间

新增内容

  • 头脑风暴中的设计文档。 头脑风暴工作流现在作为输出产生结构化设计文档。该文档捕获探索的替代方案、做出的决策和推理——并直接输入到实现计划阶段。

  • superpowers: 命名空间。 所有 Superpowers skills 现在以 superpowers: 命名空间为前缀（例如，superpowers:systematic-debugging、superpowers:verification-before-completion）。这防止了与用户创建的 skills 的命名冲突，并使 skill 调用明确无误。

迁移

没有命名空间前缀的 v3.1.x skills 继续通过别名工作。建议在所有新调用中使用命名空间前缀。

v3.0.1 — 2025 年 10 月

主题： Skills 系统迁移

新增内容

  • Anthropic 第一方 skills 系统迁移。 Skills 现在通过 Anthropic 的官方第一方 skills 系统管理，而不是之前的自定义机制。这带来了更高的可靠性、更好的版本管理，以及访问 Anthropic skill 分发基础设施的能力。

  • 所有现有 skills 迁移到新系统，保持向后兼容性。

  • 设置指南中记录了新的 skill 安装流程。

v2.0 — 2025 年 10 月

主题： Skills 仓库分离与扩展

新增内容

  • Skills 仓库分离。 Skills 库现在作为独立仓库从核心 Superpowers 配置中维护。这允许 skills 独立于核心规范更新，并允许团队在公共库旁边维护私有 skill 仓库。

  • 新增 9 个 skills：

    • systematic-debugging — 四阶段调试规范
    • verification-before-completion — 5 步验证门
    • receiving-code-review — 审查响应中的技术严谨性
    • requesting-code-review — 结构化审查请求规范
    • using-git-worktrees — Worktree 隔离工作流
    • writing-plans — 实现前规划
    • executing-plans — 带检查点的计划执行
    • dispatching-parallel-agents — 多 agent 协调
    • writing-skills — Skill 创建与测试

备注

v2.0 标志着 Superpowers 从个别工具集合成为完整开发方法论的时刻。本版本中的九个 skills 涵盖了从规划到验证的完整功能生命周期。

早期版本

v2.0 之前的版本记录在仓库历史中的旧版 changelog 中。v2.0 版本代表了一次重大的架构重构；早期版本历史保留以供参考，但其中描述的规范已被取代。