跳到主內容

Theme / v7.0.2

Superpowers

AI 開發方法論

基礎觀念

v7.0.1:Brainstorming 重新調校與 Skill 瘦身

🟡 中階|v7.0.0 → v7.0.1:brainstorming 在重建後的重新調校——先挖掘 context 再提問、只問還不知道的事、方法選擇與設計文件不可跳過;三個長 skill 拆分 references/ 以撐過 Claude Code compaction 的 20,000 字元截斷。含互動測驗與升級檢查清單。

概述

Superpowers v7.0.1(2026-10-21 發布)是 v7.0.0 重建 brainstorming 之後的重新調校 (retune) release:

“This release retunes brainstorming after its rebuild in v7.0.0. Many of you told us, rightly, that the new default questions got annoying fast and felt formulaic.”

官方承認 v7.0.0 的預設提問「很快就讓人覺得煩、而且像套公式」,因此 v7.0.1 的主軸是:

“Brainstorming now digs for context before it asks anything, and tries to ask better questions.”

先挖掘 context 再提問,並嘗試問更好的問題。第二主軸則是「trims three long skills so they better survive compaction on Claude Code」——把三個過長的 skill 瘦身,讓它們撐得過 Claude Code 的 compaction(壓縮截斷)。第三部分是貢獻流程變更:issue 與 PR 模板要求人工撰寫的摘要。

區塊 一句話
Brainstorming 調校 先讀專案再提問、只問還開著的那一件事、指名時不再提議跳過、先列方法並寫設計文件
Skill 瘦身 三個長 skill 拆分 references/ 或刪重複,加 20,000 bytes 測試護欄
貢獻流程 issue/PR 模板要求人工摘要;不接受修別人 issue 的 agent 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 會先讀完它們才發出第一則訊息,不再重問這些內容已經回答的事。這直接修正了 v7.0.0「每個 session 都以同樣方式開場」的公式化感。

問更好的問題:只問還開著的那件事(#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.”

當你已經說出想要什麼,它會帶著在專案裡查到的東西播回(play back)你的請求,只問還開著的那一件事。

“Later questions build on your answers and on what it found, and say what the answer would change.”

後續問題建立在你的回答與它查到的內容上,並且說明這個答案會改變什麼——讓每個問題都有明確的用途。

只在自行啟動時提供跳過(#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.”

它會列出兩三種做法(approaches)、推薦其中一種並請你選擇,然後寫出設計文件——小改動就寫短的——在你同意之前不做任何東西。這是針對一個真實失敗模式的重點修補:

“it skipped the doc without asking in 24 of 24 runs before this change and 3 of 24 after.”

官方測試場景中,改動前 24 次執行有 24 次跳過設計文件直接開工;改動後只剩 24 次中的 3 次。

官方也邀請持續回饋:

“If brainstorming’s questions in 7.0.1 still don’t feel right, please comment on #2530. Examples help most: what you asked, what it asked back, and what you wish it had asked.”

覺得提問還是不對就到 #2530 留言,最有用的是例子:你問了什麼、它回了什麼、你希望它問什麼。

Skill 瘦身:撐過 compaction 的 20,000 字元截斷

問題的根源在 Claude Code 的 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.”

compaction 之後,Claude Code 重新附加每個 skill 時會在 20,000 字元處截斷——超過的部分在該 session 的剩餘時間裡等於不存在。後果不是抽象的:

“subagent-driven development lost its five-round limit and ran 18 fix rounds on one task.”

一個回報的 session 中,subagent-driven development 因截斷失去了五輪修正的上限,對單一任務跑了 18 輪修正(#2481,感謝 @dan-1492 回報)。

三個 skill 的瘦身策略

Skill 做法 PR
subagent-driven-development 把 fix loop、final review、report handling、resuming、preflight、batching、cannot-verify 指引移入 references/ #2565
writing-skills 把輔助文件、SKILL.md 模板與 discovery 指引、bulletproofing、flowchart 慣例移入 references/ #2564
executing-plans 直接刪除與上方規則重複的 Example Workflow #2563

subagent-driven-development 的拆分保留了按需載入:

“It reads each file from disk at the step that needs it.”

需要的步驟才從磁碟讀取對應檔案——內容沒有減少,只是不再全部塞進截斷線之前。

用測試守住瘦身成果(#2565)

“tests/skill-size/test-skill-size.sh fails when any SKILL.md reaches 20,000 bytes.”

新增的測試在任何 SKILL.md 達到 20,000 bytes 時直接失敗——把「skill 不能超過截斷線」從文件規範變成 CI 紅燈。

貢獻流程變更(#2569)

  • 模板要求人工摘要:

    “Issue and PR templates now ask who is filing and what their human partner asked for, plus a summary of under 200 words written by a human.”

    issue 與 PR 模板現在要求說明提交者是誰、其 human partner 要求了什麼,以及一份由人類撰寫、200 字以內的摘要;bug report 另外要求說明如何確認問題在沒有 Superpowers 時不會發生。

  • 不接受修別人 issue 的 agent PR:

    “We don’t accept agent-written PRs that fix someone else’s issue unless a maintainer asked for one.”

    除非維護者要求,專案不接受由 agent 撰寫、修正別人的 issue 的 PR——如果你的 human partner 遇到同樣問題,應把報告加到既有 issue 上。PR 模板、AGENTS.md 與 README 都寫明這條規則。

  • diagnosing-superpowers 跟進:它草擬的 issue 也加入同樣兩個區塊,摘要還是佔位符時不會送出;其預填連結改為開啟 Bug Report 模板,Session Diagnosis Report 模板已移除。

隨堂測驗

隨堂測驗

v7.0.1 的 brainstorming 在既有專案裡的第一則訊息之前會做什麼?

💡 想先看個提示?

v7.0.0 的問題是「公式化」,v7.0.1 的解法是先看過你的專案。

隨堂測驗

你用 /brainstorming 指名啟動時,v7.0.1 還會提供「跳過提問」選項嗎?

💡 想先看個提示?

你既然點名了,它就不再問你要不要跳過。

隨堂測驗

在官方測試場景中,「跳過設計文件直接開工」的次數從改動前到改動後變成多少?

💡 想先看個提示?

改善了但沒有歸零。

隨堂測驗

Claude Code compaction 之後,超過 20,000 字元的 skill 內容會發生什麼?

💡 想先看個提示?

這是靜默失敗——skill 看起來在,但後半段規則不在。

隨堂測驗

v7.0.1 對「修別人 issue 的 agent PR」的政策是什麼?

💡 想先看個提示?

政策有明確的例外條件。

動手升級檢查清單

升級 v7.0.1:動手檢查清單

逐項勾選,確認你已完成升級必要的步驟(進度會保存在此瀏覽器)

0 / 5

延伸閱讀

  • 官方 v7.0.1 release notes
  • 前一課:v700-brainstorming-antigravity——v7.0.0 的 brainstorming 重建
  • 基礎課:beginner-guide——Superpowers 功能導覽
  • 本主題 Changelog:完整的 v7.0.1 條目