Theme / v7.0.2
Superpowers
AI 開發方法論
Changelog
版本更新紀錄
收錄 Superpowers 的版本變遷軌跡。每條紀錄以舊值→新值呈現，舊值以紅線劃掉但保留可見，方便對照改動軌跡。
v7.0.2
已同步2026-11-04- 2026-11-06 查核：上游最新 release 仍為 v7.0.2（2026-11-03 發布），其後無新版本。
- 版本定位：v7.0.1→v7.0.2（2026-11-03 發布）。官方主軸：「This release further tunes brainstorming's questions. It asks fewer of them, starts by asking why, and when there's a choice to make it gives you options to pick from. It also fixes bootstrap problems on six harnesses, and makes the SDD and executing-plans helper scripts much harder to point at the wrong repository or the wrong task.」
- Brainstorming：提問再調校（#2644）：「It asks a question only when the answer would change what gets built and nothing already answers it」——只在答案會改變做出來的東西、且沒有既有內容已回答它時才發問，否則把自己的決定以提案方式說出來讓你修正，並停止詢問流程問題（writing things up、where files go、whether to look further、how to show you something 是它自己的決定）；「When you haven't said why you want something, that's the first thing it asks」——先問 why，以開放方式問、不附範例答案；「When there's a choice it can name, it shows you the options with a recommendation」——Ctrl+K 測試場景中 v7.0.1 在 8 次執行有 8 次只丟出裸問句 "which one?"，本版 8 次全部列出選項並推薦其一；「It reads from how you talk whether you want to discuss the technical choices」——從你說話的方式判斷你是否想討論技術選擇。盲測評分（blind-graded）測試對話中，填充問題從 7.0.1 的 41 降到 23、請求背後的 why 在 33 次對話中的 33 次先於任何 approach 出現（改前 28/33）、審批前不再有東西被做出來（改前 4 次）；對比 6.4.2：填充問題更少（23 vs 34）、問出 why 的比例高得多（33/33 vs 19/33）、審批前不做東西與之持平。
- Brainstorming：
start-server.sh --project-dir .修復（#2524/#2608）：「The scriptcds into its own directory before starting the server」——此前每個由相對--project-dir推導出的路徑都指錯地方、server 永遠起不來；現在先解析目錄再啟動。 - Hooks：Copilot（Windows）與通用 hook 修復：Copilot on Windows 拿得到 bootstrap——Copilot CLI 與 VS Code Copilot 透過 PowerShell 執行 hook 指令，SessionStart 指令被 ParserError 拒絕，
hooks.json現在提供powershell形式的指令（#2189/#1225/#2592）；SessionStart hook 不再啟動子程序——Git Bash 上每個子程序耗費數十毫秒，而此 hook 每次啟動、/clear與 compaction 都啟動六個（#2081/#2593）；無 bash 的 Unix 上run-hook.cmd退回 zsh 或安靜退出——原本以 exit 127 與bash: not found失敗、bootstrap 遺失（#2503/#2594）。 - Hooks：Pi 的兩項修復：「Every prompt now gets the bootstrap」——extension 原本在 session 第一個 prompt 後就關掉 bootstrap，且因請求第一則訊息改變，Anthropic prompt caching 在第二個 prompt 重寫整個對話的 cache（實測一天 session 中 83% 的 first-to-second-prompt 轉換都在重寫 cache）（#2083/#2595）；
skills過濾器修復——extension 在 pi 套用過濾後又把整個skills/目錄加回來，"skills": []仍載入全部 15 個 skills（#2394/#2402/#2598）。 - Hooks：Hermes Agent 與 OpenCode 修復：Hermes Agent 的
delegate_tasksubagents 不再取得控制端的 bootstrap——每個 child 以空 history 開始、看似新 session 而拿到完整 bootstrap，有些先載入using-superpowers而非做任務（#2536/#2596）；OpenCode：bootstrap 改為指示模型使用裸 skill id（brainstorming而非superpowers:brainstorming），否則得到 "skill not found" 並略過 skill（#2583/#2597）；OpenCode：訊息提到EXTREMELY_IMPORTANT不再關閉 bootstrap——plugin 原本以第一則訊息含該字判定 bootstrap 已存在，現在改找 bootstrap 自己的第一行（#2197/#2600）；OpenCode 2：compaction 與 generate 請求現在帶有 bootstrap，否則全 session 最大的 compaction 請求錯過 prompt cache（#2391/#2601）。 - Hooks：Muse 的 SessionStart hook 在 Debian/Ubuntu 可執行（#2528/#2533）：manifest 以
sh執行 bash 腳本hooks/session-start，在sh為 dash 之處 hook 以 exit 2 失敗、bootstrap 從未載入；現在改以bash執行。 - SDD 與 executing-plans helpers 防誤用（#2525/#2607）：helpers 作用於當前目錄所在的 repository（如同
git）並接受-C DIR；在 repository 之外，五個 helpers 一律以 exit 2 停止並附訊息告知 agent 該怎麼做；全新、尚無 commit 的專案需 agent 先git init並做出第一個 commit；skills 改為指示從你的 working tree 以絕對路徑執行 helpers（原本說 "from this skill's directory"，cd 過去的 agent 會對 plugin 自己的檔案執行），並有測試在任何 skill 以相對路徑稱呼 helper 時失敗。 - SDD：
task-brief辨識與防護修復（#2459/#2496/#2175/#2405/#2604、#2436/#2605）：現在找得到A1、6b、2.1等形式的 task ID——原本完全拒絕字母開頭的 ID，且要 Task 6 會連 Task 6b 一起抓；plan 的 task 標題非英文時會說明必須使用 "Task" 一詞並列出找到的標題；並拒絕被未閉合 code fence 延伸到 plan 結尾的 brief——一個漏掉的閉合 fence 藏掉所有後續 task 標題，回報者的 177 行任務變成 1,159 行、含五個任務的 brief。 - SDD：Windows 上 helpers 輸出 PowerShell 可開啟的路徑（#2307/#2602）：原本印出
/c/Users/…，PowerShell 會讀成C:\c\Users\…。 - systematic-debugging 移除內建測試情境（#2277/#2654）：
CREATION-LOG.md與四個壓力測試 prompt（以 "This is a real scenario. You must choose and act" 開頭）不再安裝在SKILL.md旁——任務中的 agent 原本有機會找到它們；現在移到tests/之下，並有測試防止這類檔案出現在任何 skill。 - Maintenance（#2609）：
scripts/package-codex-plugin.sh與scripts/sync-to-codex-plugin.sh可從 linked git worktree 運作。 - 完整教學見
lessons/v702-brainstorming-questions-and-bootstrap-fixes.mdx。
v7.0.1
舊版本2026-10-23- 2026-11-03 查核：上游最新 release 仍為 v7.0.1（2026-10-21 發布），其後無新版本。
- 版本定位：v7.0.0→v7.0.1（2026-10-21 發布）。官方主軸：「This release retunes brainstorming after its rebuild in v7.0.0」——brainstorming 在 v7.0.0 重建後的重新調校，同時「trims three long skills so they better survive compaction on Claude Code」，並變更 issue 與 PR 模板要求人工撰寫摘要。
- Brainstorming：先挖掘 context 再提問（#2560）：「It digs for context first. In an existing project, or when you point it at a spec, plan, or files, it reads them before its first message and doesn't ask what they already answer.」——在既有專案或你指向 spec、plan 或檔案時，它先讀完才發出第一則訊息，不再重問這些內容已回答的事。
- Brainstorming：問更好的問題（#2560、#2571）：「when you've already said what you want, it plays your request back with what it found in the project and asks about the one thing still open」——你已說出想要什麼時，它帶著專案裡查到的內容播回請求、只問還開著的那一件事；後續問題建立在你的回答與它查到的東西上，並說明答案會改變什麼。
- Brainstorming：只在自行啟動時提供跳過（#2560）：「It offers to skip the questions only when it started on its own. If you asked for brainstorming by name or with
/brainstorming, it no longer offers to skip it.」——你指名要 brainstorming 時不再提議跳過。 - Brainstorming：列出方法並先寫設計文件（#2571）：「It lays out the approaches and writes a design doc before building. It presents two or three ways to build the thing, recommends one, and asks you to pick.」——提出兩三種做法、推薦其一、請你選擇，寫完設計文件並經你同意才動工；官方實測記錄「it skipped the doc without asking in 24 of 24 runs before this change and 3 of 24 after」（改前 24 次全跳過設計文件、改後僅 3 次）。
- Skill 瘦身以撐過 compaction：「After a compaction, Claude Code re-attaches each skill cut off at 20,000 characters, so anything past that point is gone for the rest of the session.」——超過 20,000 字元的部分在該 session 其餘時間會消失；曾有一個 session 回報 subagent-driven development 因此失去五輪上限、對單一任務跑了 18 輪修正（#2481，感謝 @dan-1492 回報）。
- subagent-driven-development 拆分 references/（#2565）：把 fix loop、final review、report handling、resuming、preflight、batching 與 cannot-verify 指引移入
references/，「It reads each file from disk at the step that needs it.」——需要的步驟才從磁碟讀取。 - writing-skills 與 executing-plans 瘦身：
writing-skills把輔助文件、SKILL.md 模板與 discovery 指引、bulletproofing、flowchart 慣例移入references/（#2564）；executing-plans直接刪除與上方規則重複的 Example Workflow（#2563）。 - 20,000 bytes 測試護欄（#2565）：
tests/skill-size/test-skill-size.sh在任何SKILL.md達到 20,000 bytes 時失敗——「fails when anySKILL.mdreaches 20,000 bytes」，用測試守住瘦身成果。 - 貢獻流程變更（#2569）：issue 與 PR 模板現在要求說明提交者是誰、其 human partner 要求了什麼，以及一份「written by a human」的 200 字內摘要（bug report 另問如何確認問題在沒有 Superpowers 時不發生）；並且「We don't accept agent-written PRs that fix someone else's issue unless a maintainer asked for one.」——除非維護者要求，不接受由 agent 撰寫、修別人 issue 的 PR；
diagnosing-superpowers草擬的 issue 也加入同樣兩個區塊，摘要還是佔位符時不送出，並改開 Bug Report 模板、移除 Session Diagnosis Report 模板。
v7.0.0
舊版本2026-10-12- 版本定位：v6.4.2→v7.0.0（單一 major release，2026-10-10 發布）。主軸是 brainstorming 從零重建——官方定位「幫你把真正想要的東西想清楚並說出來，在任何東西被做出來之前」；外加 Antigravity Marketplace 原生 plugin manifest 與一批 hooks／Windows 修復。
- Brainstorming 重建（#2463）：第一則訊息就提供「跳過提問」選項並問一個關於真實時刻或具體畫面的開放問題，卡住才出現選單；理解每個部分後以幾百字播回（play back）讓你修正，猜測標記為猜測；可提議查看 prior art、你的專案或網路。理解後才用白話為工作定規模：又快又清楚的事立刻做掉、小改動在對話中議定、專案寫成設計文件——可推翻，工作變大自動升一級。
- Builder check 取代 spec-document 審查者（#2463）：全新 subagent 以「將要實作這份設計的人」的視角讀設計、列出動工前還需要問什麼；brainstorming 回答答得了的、小決定自己定並標記為自己的，只把會改變做出來的東西的問題帶給你——一輪解決。
- 技術選擇的所有權（#2482/#2483）：brainstorming 會探詢 platform、語言、函式庫、媒介哪些你想自己拿——你有意見就討論、交給它就挑合理預設並告訴你選了什麼。起因是一個 session 設計了 iOS app、從未問平台、結果做出 web app；即使跳過提問此探詢仍進行。
- 視覺 companion（#2463、#2362/#2364）：畫面、排版、流程、圖表等「看比讀有幫助」時提議視覺 companion，不再附 token 成本警告；修復內容含
$'、$&序列被String.replace當替換模式吃掉的問題——改為字面插入。 - Antigravity 原生 plugin（#2479）：新增
.antigravity-plugin/plugin.json（Marketplace 名稱、logo、建議 prompts），agy plugin install安裝指令不變——此前會退回 Gemini CLI extension 匯入並在每個 session 拒絕 Claude 格式 hooks（invalid hook）。Antigravity 無 session-start hook 事件，改以 skill 探索啟動（using-superpowers的描述促使模型載入），在 agy 1.3.1 以 12 次執行驗證；README 與 porting guide 同步修正（它們曾描述一個從未存在的 hook 與安裝腳本）。 - Hooks 修復（#2310/#2349、#2393）：SessionStart 不再經
PATH查找dirname/cat/bash——啟動PATH壞掉時 bootstrap 不再掉；Windowsrun-hook.cmd找得到 per-user Git（%LOCALAPPDATA%\Programs\Git）、跳過需要 distro 的 WSLbash.exelauncher、不再執行當前目錄裡的bash/where（此前 repo 可植入bash.cmd在 session 啟動時被執行），並把 hook exit code 如實傳給 harness。 - 其他 skill 修復：
sdd-workspace不再以*覆寫 repo 自己 commit 的.superpowers/sdd/.gitignore（#2161/#2399）；Windows 上 plan marker 改以 repo-relative 記錄（#2149）；task-done記錄「通過但無輸出」的測試（→ (no output)，#2385/#2388）；code review 範例改用cut避免$1被參數取代（#2311/#2361）；systematic-debugging 範例不再印出 secret 值（#2375/#2380）；Hermes skill 清單顯示 frontmatter description（#2284）。
v6.4.2
舊版本2026-09-25- 2026-10-07 查核：上游最新 release 仍為 v6.4.2（2026-09-25 發布），其後無新版本。
- 版本定位：v6.4.1→v6.4.2。單一主軸是
writing-plans產出更精簡的計畫——計畫只記錄決策，不再把程式碼抄進去。起因是部分前沿模型（含 Opus 5.5）寫計畫時會「過度熱心」，在設計階段就試圖把整個專案實作出來；修正後重現原始回報，scratch builds 消失，計畫撰寫時間降為約四分之一、token 約三分之一（#2333）。感謝 Harper Reed 的回報與 session bundle。 - 計畫只記錄決策：計畫是決策的記錄，不是程式碼的逐字稿。新章節「What a Step Contains」取代「No Placeholders」——測試步驟寫出測試名稱與斷言；程式碼步驟給出精確簽名、檔案與規格給定的值，只有演算法無法由這些決定時才附 body；驗證步驟給出指令與通過時的輸出；引用其他任務則透過該任務的 Interfaces 區塊。佔位符（placeholder）仍被點名為相反的失敗。
- 自我審查檢查比例：計畫會拿自身長度與規格比較。計畫若比規格長好幾倍，就是逐字稿；當程式碼區塊佔比過高，會把 body 換成簽名與測試斷言。
- 步驟大小重新定義：計畫的讀者被描述為「知道精確介面與測試後就能寫出道地程式碼的工程師」，取代原本的「zero context、questionable taste」；步驟大小改以「一個動作 + 一個可檢查的結果」為單位，不再用 2–5 分鐘估算。
- 驗證：新 skill 寫出的每份計畫在 Sonnet 5 上通過 9/9 planted-defect probes，與全程式碼計畫的結果相同。
- 移除：
plan-document-reviewer-prompt.md（已無任何引用）；CLAUDE.md移除——Claude Code 現在直接讀AGENTS.md，但只在沒有CLAUDE.md時才讀，保留一行指標反而會遮住真正的指引。 - 既有使用者影響：既有計畫不受影響；升級後新寫的計畫明顯更短、更快產出，實作者拿到的仍是精確介面與測試，而不是整段程式碼。
- 學習重點：這是「計畫 vs 實作」職責邊界的修正——當規劃用的模型有能力直接寫出程式碼，它會忍不住把計畫寫成實作（plan as transcript）；把計畫內容收斂到「決策」，並用與規格的長度比例自我審查，是防止 agent 越界的輕量護欄。
v6.4.1
舊版本2026-09-19- 版本定位：v6.3.0→v6.4.1。v6.4.0 從未實際發布，v6.4.1 是這批變更的第一個 release；原本預定的
proving-it-works-with-a-movieskill 保留在後續版本。主軸是新增diagnosing-superpowersskill、executing-plans重建成 Native execution，以及三個新 harness（OpenCode 2.0、Muse、Qwen Code）。 - 新 Skill：diagnosing-superpowers（#2236/#2287）：當一個 session 出問題（重複做工、計畫被無視、skill 沒觸發、帳單異常），可以要求 agent「診斷這個 session 的 superpowers 哪裡出了問題」。它會與你一起 pin down 問題、讀磁碟上的 transcripts，並以
path:line證據回報每個發現；視要求可建立 scrubbed bundle 或草擬 GitHub issue 供你核准。支援當前或過去 session。 - executing-plans 重建為 Native execution（#2318）：舊版只是 64 行的 stub，效果與沒裝 plugin 相同。重建後 session 在與 subagent-driven development 相同的 workspace、ledger 與 stopping rules 下自行實作每個任務，最後派發一次全新 whole-branch review 給最強模型。
task-start與task-donehelpers 維持 ledger 與 test log 的誠實。這是執行計畫最便宜的方式，中等型號 session model 即可運行。 - 行為改變：executing-plans 不再每幾個任務停下來與你確認，而是跑完整個計畫後做一次總 review；計畫 handoff 現在提供 Subagent-driven 與 Native 兩種方式、說明各自成本，並依計畫內容推薦其一（#2258/#2318）。
- Writing Plans 強化（#2258）：核准想法或範圍不再等同於核准一份你還沒看過的計畫——你會先審查已儲存的計畫，任何東西才開始執行；計畫新增 Review Focus section（最多五個輸入或 failure mode）。
- 新 Harness 支援：OpenCode 2.0、Muse、Qwen Code 三個平台加入安裝支援。
- 既有使用者影響：習慣 executing-plans 中途暫停確認的使用者，升級後流程會改為「跑完再一次 review」；需要頻繁介入的高風險計畫可改用 subagent-driven development。
- 學習重點：Native vs Subagent-driven 的取捨是「互動成本 vs 隔離成本」的教科書案例——inline 執行省下 subagent dispatch 開銷，但共用同一 session context；diagnosing-superpowers 則示範了「讓 agent 讀自己的 transcripts 找根因」的自省（introspection）模式。
- 版本定位：v6.3.0→v6.4.1。v6.4.0 從未實際發布，v6.4.1 是這批變更的第一個 release；原本預定的
v6.3.0
舊版本2026-08-12- version 欄位更新為
v6.3.0，與上游最新 release 一致（2026-08-12 發布）。 - Harness 支援擴充：Devin CLI（
devin plugins install obra/superpowers，session 起始自動觸發 skills，#1995）；Hermes Agent（git clone 安裝，原生 loader 註冊、首回合載入 bootstrap，#1922/#2025）；Grok Build CLI 加入安裝文件（#1919）。 - Brainstorming 儀式依任務規模縮放：請求分類為 spike / bounded / architectural，小任務跳過雙文件儀式，所有路徑仍會在實作前停下等待核准（#2063）。
- Subagent-Driven Development 多項改進：controller 不再因非災難性計畫衝突卡住——改為記錄裁決後繼續，僅破壞性或不可逆動作才暫停（#2077，一個捐贈 session 曾因此在可由 controller 決定的問題上卡了近 9 小時）；pre-dispatch 衝突掃描改將檢查寫入 ledger（#2080）；小且同形任務批次為單一 dispatch 大幅降低 subagent 成本（#2078）；implementer 與 reviewer 不得再自行 spawn subagent 以消除重複審查（#2059）；計畫帶
Spec:指標並於 setup 讀取規格（#2086）；reviewer 對無法判讀的證據改為重讀而非重跑測試（#2089），circuit-breaker 裁決現顯示於 Finish 報告。 - Codex：subagent 等待改為 event-driven 而非高頻輪詢、spawn 時明確釘住 model 與 reasoning effort、並依 Codex 原始碼校正多代理參考（#2060/#2061/#2062）。
- Finishing a Development Branch：
git worktree remove因未提交工作拒絕時改為停止、列出檔案並詢問，不再動用--force摧毀 untracked 檔案（#2016/#1223/#2024）。 - 修正：
render-graphs.js（writing-skills）在 Windows 可用；修正 Copilot CLI 在 Windows 的背景化指引（#1929/#2006）；bump-version.sh涵蓋 Hermes manifest。 - 文件：README 加入目錄並重組 Getting Started。
- version 欄位更新為
v6.2.0
舊版本2026-08-10- version 欄位為
v6.2.0，與上游最新 release/tag 一致（2026-07-24 發布）。上游無中介版本，release 仍為最新。 - Subagent-Driven Development 兩個結構性改動：sdd-workspace 改為 plan-scoped（
.superpowers/sdd/<plan-basename>/）避免跨計畫污染、fix loop 改為 resume-the-implementer 並加入 five-round circuit breaker。 testing-anti-patterns.md重寫為writing-good-tests.md（正面 catalog、加入 falsifiability 紀律、關閉 string-presence trap 與 change-detector trap 兩個漏洞）。finishing-a-development-branch不再提供「Discard this work」選項（改為 explicit-request-only，需 typed-confirmation）；PR creation 改為 forge-agnostic，並修正 worktree cleanup silently no-op 的 bug。- 一輪全庫壓縮战役：移除
brainstorming、systematic-debugging、verification-before-completion等 11 個 SKILL 的 recap/persuasion prose，每個刪减都經 subagent probe micro-tested。 - Windows：SessionStart hook 改經 Git Bash dispatch（修 #1751 PowerShell parser error 與 #1918 cmd.exe 路徑截斷）。
- Harness Support：恢复 v6.1.0 誤刪的 Gemini CLI 支援（#1959）。
- 上游 main 分支最新 commit 為
2026-07-28T19:25:36Z（release 之後），屬 commit-level 變動、無新版 release。
- version 欄位為
圖例
- 當前版本 本站現在記錄的版本
- 舊版本 已被取代，保留作歷史對照
- 已同步 與上游 release 對齊
- 僅上游變動 上游 main 有 commit，但未發佈新版