## 概述
我们从零重建了头脑风暴（Brainstorming）功能，使其能更好地完成它一直以来的使命：在开始构建任何东西之前，帮你理清自己真正想要什么，并用语言表达出来。新的技能会要求你描述你的需求和动机，复述它所理解的内容供你纠正，并持续提出好问题，直到画面清晰为止。然后它会根据工作性质匹配相应的流程——从直接执行到编写完整设计文档。
本次发布还为 Antigravity Marketplace 添加了原生插件清单，并修复了 Windows 钩子发现、Git Bash 路径、Hermes 技能描述以及若干小 bug。
---
## 头脑风暴（Brainstorming）
头脑风暴在任何提案之前先挖掘你的真实需求。它的首条消息会提供跳过提问的选项，并提出一个关于真实场景或具体画面的开放式问题。仅当你卡住时才提供菜单。在整个过程中，它会主动提出查看既有方案、你的项目或网络资源。当它理解了每个部分后，会用几百字复述该部分，并将自己的猜测标注为猜测。（[#2463](https://github.com/obra/superpowers/pull/2463)）
- **工作量评估**：在理解你的需求后，它会用直白的语言评估工作量。小任务立即执行，中等改动在聊天中与你确认，大项目则编写设计文档。你可以覆盖它的判断，如果工作量增长它会自动升级规模。（[#2463](https://github.com/obra/superpowers/pull/2463)）
- **构建者检查**：用构建者检查替代了规格文档审查者。一个新的子代理以构建者的身份阅读设计文档，列出仍需询问的问题。头脑风暴会回答能回答的部分，自行做小决策并标注为自己决定的，然后在一轮中将影响构建的问题交给你。（[#2463](https://github.com/obra/superpowers/pull/2463)）
- **技术选型确认**：它会主动了解你对实现方式的偏好。平台、语言、库、媒介——如果你有强烈倾向，它会与你讨论；如果你交由它决定，它会选择合理的默认值并告诉你选了什么。即使你跳过了提问环节，它也会做这件事。这一改动源于一次会话中设计了一个 iOS 应用，却从未询问平台，最终构建了一个 Web 应用。（[#2482](https://github.com/obra/superpowers/pull/2482)，[#2483](https://github.com/obra/superpowers/pull/2483)）
- **可视化伴侣**：当"看"比"读"更有帮助时，它会主动提供可视化伴侣——包括界面、布局、流程、不同方案的对比图、示意图等。该功能已移除 token 消耗警告。（[#2463](https://github.com/obra/superpowers/pull/2463)）
- **可视化伴侣 bug 修复**：可视化伴侣现在能正确显示包含 `$'`、`$&` 等序列的界面内容。此前服务端使用 `String.replace` 插入内容，会将这些序列当作替换模式处理。现在改为字面插入。感谢 [@andrew-yian](https://github.com/andrew-yian) 报告，[@luochen211](https://github.com/luochen211) 修复。（[#2362](https://github.com/obra/superpowers/issues/2362)，[#2364](https://github.com/obra/superpowers/pull/2364)）
---
## Antigravity 支持
- **原生插件安装**：`agy plugin install https://github.com/obra/superpowers` 现在会将 Superpowers 作为原生 Antigravity 插件安装。我们添加了 `.antigravity-plugin/plugin.json`，包含 Marketplace 显示名称、logo 和建议提示词。此前 `agy` 会回退为将仓库作为 Gemini CLI 扩展导入，然后在每次会话中拒绝复制的 Claude 格式钩子文件，报错 `invalid hook "hooks": command hook must specify 'command'`。安装命令保持不变。（[#2479](https://github.com/obra/superpowers/pull/2479)）
- **技能发现引导**：Superpowers 在 Antigravity 上通过技能发现机制引导启动。Antigravity 没有 session-start 钩子事件，但它会向模型展示每个已安装技能的描述，而 using-superpowers 的"在每次对话开始时使用"提示会引导模型加载它。我们在 agy 1.3.1 上验证了 12 次运行："做一个 React 待办列表"和"添加设置页面"在任何代码之前触发了头脑风暴，一个失败的测试在任何编辑之前触发了系统性调试。我们还更正了 README 和移植指南，它们描述了一个从未存在的 session-start 钩子和安装脚本。（[#2479](https://github.com/obra/superpowers/pull/2479)）
---
## 钩子（Hooks）
- **SessionStart 在 PATH 损坏时正常工作**：钩子不再在 PATH 上查找 `dirname`、`cat` 或 `bash`，因此当启动时的 PATH 无法解析这些命令时，不再丢失引导流程。感谢 [@kannan983](https://github.com/kannan983) 报告，Ada Sen 修复。（[#2310](https://github.com/obra/superpowers/issues/2310)，[#2349](https://github.com/obra/superpowers/pull/2349)）
- **Windows：Git for Windows 发现**：`run-hook.cmd` 现在能找到用户级 Git for Windows 安装，并跳过 WSL 启动器。它会检查 `%LOCALAPPDATA%\Programs\Git`，在搜索 PATH 时跳过 WSL 的 `bash.exe` 启动器（在没有 Linux 发行版时会失败）。感谢 [@jp5247](https://github.com/jp5247) 报告，[@citizen204](https://github.com/citizen204)（[#1864](https://github.com/obra/superpowers/pull/1864)）和 [@KaiyiQuan](https://github.com/KaiyiQuan)（[#2365](https://github.com/obra/superpowers/pull/2365)）的修复在此合并。（[#1863](https://github.com/obra/superpowers/issues/1863)，[#2393](https://github.com/obra/superpowers/pull/2393)）
- **Windows：安全修复**：`run-hook.cmd` 忽略当前目录下的 `bash` 和 `where`。此前，仓库可以在当前目录放置 `bash.cmd` 或 `where.bat`，使其在会话启动时被执行。（[#2393](https://github.com/obra/superpowers/pull/2393)）
- **Windows：退出码传递**：`run-hook.cmd` 现在将钩子退出码传递给框架。此前即使钩子失败也会报告成功。（[#2393](https://github.com/obra/superpowers/pull/2393)）
---
## 子代理驱动开发（Subagent-Driven Development）
- **保留仓库的 .gitignore**：`sdd-workspace` 不再覆盖仓库自身的 `.superpowers/sdd/.gitignore`。此前每次运行都会用 `*` 覆盖该文件，撤销仓库已提交的版本（例如用于跟踪 `progress.md` 台账）。现在仅在文件不存在时才写入默认值。感谢 [@aruizcu1989](https://github.com/aruizcu1989) 修复。（[#2161](https://github.com/obra/superpowers/pull/2161)，[#2399](https://github.com/obra/superpowers/pull/2399)）
- **Windows 路径修复**：计划标记在 Windows 上保持仓库相对路径。在 Git Bash 中，`sdd-workspace` 将 `git rev-parse` 的 `C:/…` 根路径与计划的 `/c/…` 路径进行比较，导致每个工作区标记记录的都是绝对机器特定路径。现在以与计划路径相同的方式解析根路径。此问题在合并 [@t0domanh](https://github.com/t0domanh) 的 Windows 测试修复（[#2149](https://github.com/obra/superpowers/pull/2149)）时发现。
---
## 执行计划（Executing Plans）
- **静默通过的测试任务记录修复**：`task-done` 现在会记录测试命令静默通过的任务。此前当通过的命令不打印任何输出时，`task-done` 以退出码 1 退出且不写入台账行，导致已完成任务看起来未完成。现在会记录 `→ (no output)`。感谢 [@KenM-BT](https://github.com/KenM-BT) 报告，Ada Sen 修复。（[#2385](https://github.com/obra/superpowers/issues/2385)，[#2388](https://github.com/obra/superpowers/pull/2388)）
---
## 请求代码审查（Requesting Code Review）
- **示例命令修复**：示例中的 base-SHA 命令在带参数调用时不再被破坏。Claude Code 会将技能体中的 `$1` 替换为第二个参数词，因此调用技能时带参数会把 `awk '{print $1}'` 变成 `awk '{print }'`。示例现在使用 `cut -d' ' -f1`，不含 `$`。感谢 [@errmakov](https://github.com/errmakov) 报告，[@klemens-floege](https://github.com/klemens-floege) 修复。（[#2311](https://github.com/obra/superpowers/issues/2311)，[#2361](https://github.com/obra/superpowers/pull/2361)）
---
## 系统性调试（Systematic Debugging）
- **敏感信息泄露修复**：多层诊断示例不再打印它检查的密钥。`${IDENTITY:+SET}${IDENTITY:-UNSET}` 和 `env | grep IDENTITY` 都会将签名身份的值输出到日志中。示例现在仅报告变量是否已设置。感谢 [@kennyg-g](https://github.com/kennyg-g) 报告，[@m2dumpling](https://github.com/m2dumpling) 修复。（[#2375](https://github.com/obra/superpowers/issues/2375)，[#2380](https://github.com/obra/superpowers/pull/2380)）
---
## Hermes 代理
- **技能描述修复**：Hermes 的技能列表现在会显示 Superpowers 技能描述。Hermes 使用传给 `register_skill` 的描述来列出每个插件技能，而该描述默认为空。此前插件只传递了名称和路径，因此每个技能都显示为空白，模型无法选择。现在插件会传递每个技能 frontmatter 中的描述。感谢 [@pepijn-blom](https://github.com/pepijn-blom) 修复。（[#2284](https://github.com/obra/superpowers/pull/2284)）
英文地址：Release v7.0.0 · obra/superpowers · GitHub
翻译时使用了AI工具。
