任務太大、一個 chat 裝不下時可以用它：多步驟研究、長 refactor，或任何需要撐過 /clear 和 context reset 的工作。

它會建三個 markdown 檔，agent 每次大動作前都會重新讀一次：

• task_plan.md 放計畫。
• findings.md 放過程中學到的東西。
• progress.md 放已經做完什麼。

安裝指令：

Prompt 範例：

• Use planning-with-files to migrate our Next.js pages router to the App Router.

當 agent 很容易跳過思考、直接動 code 時，可以用 Superpowers。它不是單一 skill，而是一整套 skill pack，會要求 agent 走完幾個 checkpoint 才能說做完。

• brainstorm 先決定方向。
• plan 先寫出預計怎麼改。
• TDD 在風險夠高時先寫會失敗的測試。
• debug 找 root cause，不是猜了就改。
• review 對照 plan 檢查改動。
• verify 證明結果真的能動。

安裝指令：

開發新功能 prompt：

• Use Superpowers to add a rate limiter to my API.

修 bug prompt：

• Use Superpowers to fix the bug where users get logged out after refresh.

當你發現自己第三次在貼類似的指示，就可以用 skill-creator。不要每次重講整套流程，把它包成 skill，agent 之後就能照著做。

它會幫你建好標準資料夾：

• SKILL.md 說明什麼時候用、怎麼用。
• scripts/ 放輔助 script。
• references/ 放更長的文件。
• assets/ 放範本。

安裝指令：

封裝寫作格式 prompt：

• Use skill-creator to package my weekly update format: bullet points grouped by project, link to the PR, one-line outcome, no emojis.

封裝 review checklist prompt：

• Use skill-creator to turn my code-review checklist in review-notes.md into a reusable skill.

實際使用時，可以照 memory、process、reuse 的順序來：

• 先用 planning-with-files，讓 agent 在 reset 之後還記得在做什麼。
• 品質要求比較高的工作，用 Superpowers 加上 checkpoint。
• 當一個流程已經重複做過兩次，用 skill-creator 把它封裝起來。

裝完這三個之後，提醒 agent 的時間會變少，檢查實際產出的時間會變多。