~/教學/PLAN.md

文章 / Claude Code

Superpowers:讓 Claude Code 先問清楚、寫計畫、先寫測試,跑過檢查才說做完

Superpowers 是免費開源的 Claude Code 外掛。一行指令裝好,它就會先問你問題、寫成計畫、先寫測試再寫程式。附安裝指令、第一句怎麼說和真實計畫範例。

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

01先看結果:Claude 寫程式之前交出的計畫

Reels 畫面:3D 筆電上是終端機,顯示 Training Collapsible Sections Implementation Plan 和 Task 1 到 Task 7,旁邊紅色印章寫它自己寫的
真實產出:我們自己專案裡,Superpowers 寫好的計畫檔(只截標題和任務清單)。

照著做完,你的 Claude Code 會變成這樣:

  1. 動手之前,先一次問你一個問題,把你要的東西問清楚。
  2. 把做法寫成一份計畫,拆成一個個小任務,每個任務寫明要改哪些檔案、怎麼測。
  3. 先寫會失敗的測試,再寫程式讓它通過。
  4. 沒真的跑過檢查,它不會跟你說「做完了」。

02第 1 步:一行指令安裝

Reels 畫面:GitHub 上 Superpowers 的 README,Claude Code 的安裝指令被圈起來,下方卡片寫 /plugin install superpowers@claude-plugins-official
README 裡 Claude Code 的安裝方式:從 Anthropic 官方外掛市集裝。

Superpowers 是 Jesse Vincent(GitHub 上的 obra)和 Prime Radiant 做的免費開源外掛,MIT 授權。打開 Claude Code,輸入這一行:

安裝指令(Anthropic 官方市集)
/plugin install superpowers@claude-plugins-official

也可以從作者自己的市集裝,兩行分開輸入:

另一種裝法(Superpowers 市集)
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

03第 2 步:說你要做什麼,讓它先問你

Reels 畫面:Superpowers README 的 The Basic Workflow,第 1 項 brainstorming 被圈起來
README 的流程第 1 項:brainstorming,先把你要的東西問清楚。

照平常一樣講你要做的東西就好。brainstorming 這個技能會先接手:每次只問一個問題,問完會把它的理解講給你聽,讓你修正。小改動在對話裡講好就開始;比較大的專案,它會寫一份設計文件給你看。

第一句(換成你的功能)
我想做[你的功能,例如:讓訓練頁面每一段都可以收合]。先問我問題,確定我要什麼,再寫計畫給我看。

04第 3 步:看計畫,點頭了它才開始寫

Reels 畫面:筆電上的計畫檔,Task 1 到 Task 7 一行一行被螢光筆標起來,上方標籤寫第 2 步寫計畫
同一份真實計畫:拆成 7 個任務。

設計你同意之後,writing-plans 會寫出實作計畫,存在專案的 docs/superpowers/plans/年-月-日-功能名稱.md。README 說每個任務大約 2 到 5 分鐘,而且都寫明:

  1. 要新增或修改哪些檔案(完整路徑)。
  2. 要寫哪個測試、怎麼跑、預期看到什麼。
  3. 做完要怎麼確認,然後 commit。
看完計畫後(要改就說,沒問題就說開始)
計畫我看過了,[要改的地方,例如:Task 3 先不要做]。改好就開始。

05第 4 步:先寫測試,跑過檢查才說做完

Reels 畫面:計畫裡的步驟,Step 1 Write the failing test、fails: module not found 被標紅、Step 4 Run it passes 被標綠
真實計畫裡的步驟:先寫會失敗的測試,跑一次看它失敗,再寫程式,再跑一次看它通過。

test-driven-development 的規則是:沒有先失敗過的測試,就不寫正式程式碼。所以每個任務都是同一個節奏:

  1. 寫一個測試,跑一次,確定它失敗(紅燈)。
  2. 寫最少的程式讓它通過(綠燈)。
  3. 整理一下,再跑一次,然後 commit。
Reels 畫面:燈光變暗後亮回來,筆電上是 verification-before-completion 的 The Iron Law,一個寫著跑過了的綠色徽章從筆電彈出來
verification-before-completion:沒有剛跑過的檢查結果,就不准說做完。

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

Reels 畫面:Claw'd 站在工作台上,問清楚、寫計畫、先寫測試、跑過檢查四個方塊一個個打勾變綠,牆上螢幕是真實計畫
四關都過了:問清楚、寫計畫、先寫測試、跑過檢查。

06要注意

  1. 它會先問、先寫計畫,所以一開始比較慢;只是想快速試個點子,就跟它說只是試試,它會跳過計畫和測試。
  2. 計畫和設計檔會存進你的專案(docs/superpowers/),要不要一起 commit,你自己決定。
  3. brainstorming 的視覺輔助畫面會從官方網站載入 Prime Radiant 的 logo(含版本號,不含你的專案內容);不想要就設環境變數 SUPERPOWERS_DISABLE_TELEMETRY=1。
  4. 外掛是第三方的,裝之前可以先到 GitHub 看原始碼。
  5. 這篇是在主頁連結輸入關鍵字 PLAN 找到的,不會私訊。

資料來源

延伸閱讀