TechSpecs搜尋

Theme / v6.3.0

Superpowers

AI 開發方法論

主題首頁GitHub ↗
實戰範例

實戰範例 009：第一次觸發一個 skill - 在待辦 app 加上依優先順序排序

從安裝 Superpowers 到觸發 brainstorming skill 的入門 hello-world 體驗

情境

你剛聽說 Superpowers 這個 plugin，想試試看「skill」到底是什麼感覺。最常見的第一個練習，是拿手邊一個小功能來試觸發。

我們就用這個當題目：在一個簡單的待辦 app 上，加上「依優先順序排序」。

直覺做法是直接跟 AI 說「幫我加排序」，然後 AI 就開始改檔案。問題是這種方式常常做出你不想要的東西，因為 AI 自己腦補了一堆決定。

這個範例帶你走一遍最基本的流程：裝好 Superpowers，觸發一個 skill，看看 AI 怎麼「先想再動手」。

第 1 步：在 Claude Code 安裝 Superpowers

Superpowers 在 Claude Code 上是 plugin 形式。打開 Claude Code 對話框，直接輸入這行：

/plugin install superpowers@claude-plugins-official

裝好之後，你會看到 12 個 skills 跟 4 個 workflows 可用。除了 Claude Code 之外，Superpowers 也支援 Cursor、Codex、OpenCode、Kimi Code、Pi、Antigravity 等平台，不過 Claude Code 是官方推薦、整合最完整的那一個。

如果你用的是其他平台，安裝方式會不一樣，但觸發 skill 的語法是通用的。

第 2 步：先別急著叫 AI 寫 code

很多人在觸發 skill 之前，會先問「這個 skill 到底要幹嘛？」。其實最快的方式是直接拿一個小任務來試，邊做邊學。

我們就拿前面那個排序需求當練習。重點不是做出多漂亮的排序，而是體驗「skill 改變了 AI 的行為模式」這件事。

第 3 步：觸發 brainstorming skill

所有 skill 的觸發語法都一樣：使用 <skill-name> skill，<具體任務>。記住這個格式，後面 11 個 skill 都這樣用。

觸發：

使用 brainstorming skill，在待辦 app 加上「依優先順序排序」功能

AI 回應摘要：

## 排序功能的三個方向

### 方向 A：DB 加 priority 欄位，SQL ORDER BY 排序
- 優點：排序永久一致、效能好、server 端可控
- 缺點：要改 schema、要寫 migration、每筆 todo 都要設預設值

### 方向 B：前端 in-memory 排序
- 優點：零後端改動、馬上能做、互動即時
- 缺點：重新整理會不見、多裝置不同步

### 方向 C：UI 拖拉排序，存 sort_order 欄位
- 優點：使用者直接拉、直覺、可視
- 缺點：要寫 drag-drop 互動、要處理衝突

### 建議：方向 B
範圍最小、當下能驗收。先做 in-memory，之後若需要跨裝置再升級到 A。

第 4 步：看到建議後，再決定下一步

注意 AI 沒有直接寫 code。它先列了三個方向、各自的優缺點，最後給一個建議。

這時你可以回「就照方向 B 做」，AI 才會進入實作。你也可以回「我比較想要 A，因為我需要跨裝置同步」，AI 就會改走 A 的路線。

主導權一直在你手上，這是 skill 跟「直接叫 AI 辦事」最大的差別。

為什麼這跟「直接叫 AI 寫 code」不同？

如果你沒有用 skill，同樣一句「幫我加排序」，AI 通常會直接挑一個方向（可能是 A，也可能是 C）就開始改檔案。你根本來不及喊停，等察覺不對勁，5 個檔案已經被改過了。

brainstorming skill 強制 AI 在寫任何 code 之前，先把可能的選項列出來、比較優缺點、給建議。這個「先想再動手」的紀律，就是 Superpowers 對新手最重要的入門體驗。

沒用 skill 用 brainstorming skill
AI 直接挑方向開始寫 AI 先列 2 到 3 個方向給你看
你只能事後 review diff 你能在動手前就改方向
改 schema 的決定可能被偷渡 schema 改動會被明確標示

拿到方向之後呢？

brainstorming 只負責「想方向」，不負責寫 code。要進入實作，可以接著用：

  • writing-plans 把選定的方向拆成階段計畫
  • test-driven-development 紅綠重構一步步實作
  • 或直接用 quick-flow workflow 把這幾個 skill 串起來

下一個範例（010）會示範怎麼把模糊需求拆成計畫，再下一個（011）會走完一遍 quick-flow。

關鍵學習點

  • Skill 觸發格式固定：使用 <skill-name> skill，<具體任務>。記住這一句，12 個 skill 都能上手。
  • brainstorming skill 的價值不在「幫你決定」，而在「強制先列出選項」。看清選項才能做選擇。
  • 第一個練習不用挑大任務，拿手邊的小功能（排序、篩選、欄位改名）來觸發就夠了。
  • 從方向 B 開始、之後再升級到 A，是工程上常見的「先求有、再求好」節奏。skill 不會逼你一次做完整。