概述
Superpowers v7.0.0(2026-10-10 發布)是一個主版本(major release),只包含一個大主軸與一批平台修復:
“We rebuilt brainstorming from scratch so it does a much better job of what it was always for: helping you work out what you actually want and put it into words before anything gets built.”
官方原文把意圖說得很白:brainstorming(腦力激盪)這個 skill 從零重建,讓它更擅長做它一直該做的事——在你真正開工之前,幫你把「你到底想要什麼」想清楚並說出來。其餘變更包含 Antigravity Marketplace 的原生 plugin manifest,以及 Windows hook 探索、Git Bash 路徑與 Hermes skill 描述等修復。
| 區塊 | 一句話 |
|---|---|
| Brainstorming | 先描述與釐清、播回讓你修正、按工作規模分級處理、builder check 取代 spec 審查者 |
| Antigravity | .antigravity-plugin/plugin.json 讓 agy plugin install 以原生 plugin 安裝 |
| Hooks | SessionStart 不再依賴 PATH;Windows run-hook.cmd 找得到 per-user Git、忽略當前目錄的假 bash |
| 各 skill 修復 | SDD、executing-plans、code review、debugging、Hermes 的小修 |
Brainstorming:先問清楚,再提議
第一則訊息就提供「跳過」選項(#2463)
新版 brainstorming 的第一則訊息會主動提供跳過提問,並針對「一個真實時刻或具體畫面」問一個開放性問題;只有當你卡住時才出現選單。過程中它會視需要提議查看 prior art(既有做法)、你的專案或網路。當它理解了每個部分,就用幾百字把那個部分播回(play back)給你聽,並把它的猜測標記為猜測。
理解之後才為工作定規模(#2463)
brainstorming 會在理解你想要什麼之後,用白話為工作定規模(size the work)並說出來:
- 又快又清楚的小事 → 立刻做掉
- 小改動 → 在對話中與你議定
- 一個專案 → 寫成設計文件(design document)
你可以推翻它的判斷;工作長大了它也會自動升一級。
Builder check 取代 spec-document 審查者(#2463)
舊版 brainstorming 有一個 spec-document reviewer;v7.0.0 改為 builder check:
“A fresh subagent reads the design as the person who’ll build it and lists what they’d still need to ask.”
一個全新的 subagent 以「將要實作這份設計的人」的視角讀設計,列出它動工前還需要問什麼。brainstorming 回答它答得了的、自己決定小事並標記為自己的決定,只把「會改變做出來的東西」的問題帶給你——而且一輪解決。
你想自己擁有哪些技術選擇(#2482、#2483)
新版會探詢「這個東西怎麼做出來」的哪些選擇你想自己拿:平台(platform)、語言、函式庫、媒介(medium)。你有明確意見就跟你討論;你交給它,它挑合理預設並告訴你它挑了什麼。
官方記錄了這個改動的起因:
“We made this change after a session designed an iOS app, never asked about platform, and built a web app.”
一個 session 設計了 iOS app、從沒問過平台,然後做出了一個 web app。即使你跳過提問,這個探詢仍然會進行。
視覺 companion(#2463、#2362、#2364)
當「看」比「讀」更有幫助時(畫面、排版、流程、長得不一樣的選項、圖表),brainstorming 會提議視覺 companion;這個提議不再附帶 token 成本警告。另修正 companion 內容含 $``、$&這類序列時被String.replace` 當成替換模式吃掉的問題——現在以字面插入。
Antigravity:原生 plugin 與 skill 探索啟動(#2479)
- 新增
.antigravity-plugin/plugin.json(含 Marketplace 顯示名稱、logo 與建議 prompts)。此前agy plugin install https://github.com/obra/superpowers會退而把 repo 當 Gemini CLI extension 匯入,然後在每個 session 拒絕複製過來的 Claude 格式 hooks 檔:invalid hook "hooks": command hook must specify 'command'。安裝指令不變。 - Antigravity 沒有 session-start hook 事件,Superpowers 改以 skill 探索啟動:Antigravity 會把每個已安裝 skill 的 description 給模型看,而
using-superpowers的「Use when starting any conversation」促使模型載入它。官方在 agy 1.3.1 上以 12 次執行驗證:“Let’s make a react todo list” 與 “add a settings page” 在寫任何程式碼前觸發 brainstorming、一個失敗的測試在改任何程式碼前觸發 systematic-debugging。 - 同時修正 README 與 porting guide——它們描述了一個從未存在的 session-start hook 與安裝腳本。
Hooks:啟動可靠性與 Windows 安全(#2310、#2349、#2393)
- SessionStart 在壞掉的
PATH下仍可運作:hooks 不再透過PATH查找dirname、cat、bash——harness 給的啟動PATH解析不到它們時(claude-code#43127),bootstrap 不再掉。 - Windows
run-hook.cmd:找得到 per-user Git for Windows(檢查%LOCALAPPDATA%\Programs\Git),搜尋PATH時跳過需要 Linux distro 的 WSLbash.exelauncher。 - 安全修復:
run-hook.cmd不再執行當前目錄裡的bash與where——此前一個 repo 可以植入bash.cmd或where.bat讓它在 session 啟動時被執行。 run-hook.cmd現在把 hook 的 exit code 如實傳給 harness(此前 hook 失敗也回報成功)。
其他 skill 修復
| Skill | 修復 |
|---|---|
| Subagent-Driven Development | sdd-workspace 不再每次以 * 覆寫 repo 自己 commit 的 .superpowers/sdd/.gitignore(只在檔案不存在時寫預設)(#2161、#2399);Windows(Git Bash)上 plan marker 改以 repo-relative 路徑記錄(git rev-parse 的 C:/… 與計畫的 /c/… 對不上的問題)(#2149) |
| Executing Plans | task-done 記錄「通過但無輸出」的測試指令——此前靜默通過會讓已完成的任務看起來沒完成,現在記錄 → (no output)(#2385、#2388) |
| Requesting Code Review | 範例的 base-SHA 指令不再被 skill 參數破壞:Claude Code 會以第二個參數字取代 skill body 裡的 $1,使 awk '{print $1}' 變形;改用不含 $ 的 cut -d' ' -f1(#2311、#2361) |
| Systematic Debugging | 多層診斷範例不再印出它檢查的 secret 值(`env |
| Hermes Agent | skill 清單顯示每個 skill 的 frontmatter description——此前只傳名稱與路徑,每個 skill 都顯示空白(#2284) |
隨堂測驗
v7.0.0 的 builder check 中,「全新的 subagent」讀設計文件的視角是什麼?
💡 想先看個提示?
審查者問「這份文件對不對」,builder check 問「我拿著它能不能開工」。
在 Antigravity 上(沒有 session-start hook 事件),Superpowers 怎麼完成啟動?
💡 想先看個提示?
模型每個 session 都會看到已安裝 skills 的 description。
動手升級檢查清單
升級 v7.0.0:動手檢查清單
逐項勾選,確認你已完成升級必要的步驟(進度會保存在此瀏覽器)
延伸閱讀
- 官方 v7.0.0 release notes
- 前一課:
v642-lean-plans——v6.4.2 的精簡計畫 - 基礎課:
beginner-guide——Superpowers 功能導覽 - 本主題 Changelog:完整的 v7.0.0 條目