~/教學/PLAN.md
Superpowers:讓 Claude Code 先問清楚、寫計畫、先寫測試,跑過檢查才說做完
Superpowers 是免費開源的 Claude Code 外掛。一行指令裝好,它就會先問你問題、寫成計畫、先寫測試再寫程式。附安裝指令、第一句怎麼說和真實計畫範例。
叫 AI 直接寫程式,常常寫到一半才發現它誤會了你的意思,只好整段重來。Superpowers 是一個免費開源的 Claude Code 外掛,讓它在動手之前先慢下來:先問清楚你要什麼、寫成計畫給你看、先寫測試再寫程式,最後沒跑過檢查就不准說做完。這篇是 Reels 裡 PLAN 那支影片的完整版:安裝指令、第一句怎麼說、計畫裡會有什麼,以及我們自己專案裡它寫的真實計畫。
01先看結果:Claude 寫程式之前交出的計畫

照著做完,你的 Claude Code 會變成這樣:
- 動手之前,先一次問你一個問題,把你要的東西問清楚。
- 把做法寫成一份計畫,拆成一個個小任務,每個任務寫明要改哪些檔案、怎麼測。
- 先寫會失敗的測試,再寫程式讓它通過。
- 沒真的跑過檢查,它不會跟你說「做完了」。
02第 1 步:一行指令安裝

Superpowers 是 Jesse Vincent(GitHub 上的 obra)和 Prime Radiant 做的免費開源外掛,MIT 授權。打開 Claude Code,輸入這一行:
/plugin install superpowers@claude-plugins-official
也可以從作者自己的市集裝,兩行分開輸入:
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace
03第 2 步:說你要做什麼,讓它先問你

照平常一樣講你要做的東西就好。brainstorming 這個技能會先接手:每次只問一個問題,問完會把它的理解講給你聽,讓你修正。小改動在對話裡講好就開始;比較大的專案,它會寫一份設計文件給你看。
我想做[你的功能,例如:讓訓練頁面每一段都可以收合]。先問我問題,確定我要什麼,再寫計畫給我看。
04第 3 步:看計畫,點頭了它才開始寫

設計你同意之後,writing-plans 會寫出實作計畫,存在專案的 docs/superpowers/plans/年-月-日-功能名稱.md。README 說每個任務大約 2 到 5 分鐘,而且都寫明:
- 要新增或修改哪些檔案(完整路徑)。
- 要寫哪個測試、怎麼跑、預期看到什麼。
- 做完要怎麼確認,然後 commit。
計畫我看過了,[要改的地方,例如:Task 3 先不要做]。改好就開始。
05第 4 步:先寫測試,跑過檢查才說做完

test-driven-development 的規則是:沒有先失敗過的測試,就不寫正式程式碼。所以每個任務都是同一個節奏:
- 寫一個測試,跑一次,確定它失敗(紅燈)。
- 寫最少的程式讓它通過(綠燈)。
- 整理一下,再跑一次,然後 commit。

最後一關是 verification-before-completion:它要說「好了、修好了、測試過了」之前,必須先在這一輪真的跑過檢查指令、讀完結果。所以它說做完的時候,會附上跑過的證據。

06要注意
- 它會先問、先寫計畫,所以一開始比較慢;只是想快速試個點子,就跟它說只是試試,它會跳過計畫和測試。
- 計畫和設計檔會存進你的專案(docs/superpowers/),要不要一起 commit,你自己決定。
- brainstorming 的視覺輔助畫面會從官方網站載入 Prime Radiant 的 logo(含版本號,不含你的專案內容);不想要就設環境變數 SUPERPOWERS_DISABLE_TELEMETRY=1。
- 外掛是第三方的,裝之前可以先到 GitHub 看原始碼。
- 這篇是在主頁連結輸入關鍵字 PLAN 找到的,不會私訊。
資料來源
下一支 Reel 想學什麼?
我每天測 Claude 和 AI 工具,把真的有用的做成 Reel。追蹤 @vivianlin.tech,新教學一出來就看得到。