聊聊 Superpowers 真實使用體驗，我遇到了這些坑

作者：牛牛碼特
日期：2026年4月13日 上午2:31
來源：WeChat 原文

✦整理版優先睇

速讀 5 個重點 高亮

Superpowers 真實體驗：流程規範但唔係萬能，核心需求一定要自己把關

整理版摘要

呢篇文章係作者牛哥分享佢用 Claude 搭配 Superpowers 插件做一個多文件合併 PDF 網頁工具嘅真實經驗。Superpowers 係一套規範化嘅 AI 開發工作流插件，會引導用戶逐步完成需求澄清、設計文檔、執行計劃同代碼生成，聽落好工程化好可控。但作者實際用落發現有幾個大坑：設計文檔好靚但核心需求無講清楚，最終方案行唔通；AI 唔會自覺跟足流程，成日跳過中間步驟；Subagent 模式太慢太繁瑣，細 project 用反而拖慢效率。

作者最終結論係：Superpowers 係個好嘅效率放大器，但絕對唔係全自動開發神器。要做出真正可用嘅工具，關鍵係自己講細需求、驗證方案、把控關鍵環節，唔好賴曬俾 AI。文章提供咗具體嘅教訓同建議，例如一開頭就要強制 AI 跟足完整流程、細 project 唔好開 Subagent、核心需求要寫到最透最盡。

  • Superpowers 雖然有規範流程，但需求冇講透，設計文檔再靚都會翻車；核心功能（例如 Markdown 複雜語法）必須一開始就講清楚。
  • AI 會慣性偷懶跳步驟，就算用 Superpowers 都要主動落指令強制佢跟足「需求 → 設計 → 計劃 → 代碼」完整鏈路。
  • Subagent 模式拆得太細、執行慢，而且審查只睇格式唔驗功能，細 project 用直接生成代碼反而更快更準。
  • 成功關鍵係「需求講細、方案驗真、把控環節」，唔好完全信賴 AI 自動執行。
  • Superpowers 本質係效率放大器，唔係自動化神器；開發者先係最終負責人，AI 只係工具。
整理重點

Superpowers 係乜？點解會用佢？

作者牛哥最近用 Claude 搭配 Superpowers 做咗個多文件合併 PDF 嘅網頁工具。佢話 Superpowers 係一套規範化嘅 AI 開發工作流插件，主要適配 Claude Code，亦支援其他 AI 開發環境。

佢唔似普通對話咁任意發揮，而係有固定邏輯：引導你講清楚想法 → 產出完整設計文檔 → 制定執行計劃 → 再生成代碼。每一步都要你確認先至繼續，聽落好工程化好可控。

Superpowers 會主動追問細節、補全信息，從設計文檔到最終代碼一條龍輸出

作者一開始覺得用 Superpowers 做個小工具簡直大材小用，點知實際用落就接連踩坑。

整理重點

坑一：設計文檔再完善，都唔代表行得通

Superpowers 喺梳理需求時問咗幾個問題，就好快輸出咗一份好全面嘅設計文檔。作者當時仲諗「咁細嘅工具用 Superpowers，大材小用」，結果一運行就翻車。

作者反思：設計方案仔細，但關鍵嘅 Markdown 複雜渲染需求冇講清楚，AI 自然唔會知。最終得到嘅只係一份睇落專業但跑唔通嘅「靚文檔」。

核心功能一定要從一開始就講明白、講透徹，唔好賴 AI 幫你背鍋

整理重點

坑二：流程擺喺度，AI 都唔會自覺遵守

經歷第一次失敗後，作者重新用 Superpowers 梳理需求，今次直接講明要完整支援 GFM 語法、URL 圖片同 Mermaid 圖表。結果幾乎一次就成功。

但過程中 Superpowers 跳過咗設計文檔同執行計劃，直接生成代碼

作者原以為用 Superpowers 就等於俾 AI 套上流程枷鎖，但 AI 仍然會自行判斷「需求傾完，直接寫 code 最有效率」，忽略中間環節。

只有明確要求一步一來，先至可以堵住 AI 偷懶跳步嘅空間

整理重點

坑三：Subagent 模式又慢又煩，細 Project 唔好開

Superpowers 提供兩種執行模式：Subagent 子代理驅動模式（將任務拆細，多代理協同）同埋普通直接執行模式（一次過生成完整代碼）。Subagent 係官方推薦，但作者話問題好明顯。

  1. 1 速度慢得離譜：一個簡單小工具拆成 8 個任務，每個任務分 3 個子代理（一個寫 code，兩個審查校驗）。
  2. 2 審查只係睇格式同語法規範，同埋係咪同設計文檔字面一致，並唔會真正校驗功能正唔正常。
  3. 3 就算行完 Subagent 全程，最後都可能拎到一份「檢查全過但完全唔符合預期」嘅工具。

簡單項目完全冇必要開 Subagent，一次執行到位反而效率更高

作者建議：Subagent 模式更適閤中大型複雜工程，用喺小工具度純屬多此一舉。

整理重點

真實感受總結：Superpowers 係放大器，唔係自動化神器

整體嚟講，Superpowers 確實可以令開發流程更規範、更有條理，但佢唔係全自動開發神器，而係一個規範流程 + 效率放大器。

核心需求一定要寫到最透最盡，先係用好 Superpowers 嘅正確姿勢

最近牛哥用 Claude 搭配 Superpowers，做咗一個多文件合併為 PDF 嘅網頁工具。全程跟住佢嘅工作流行落嚟，體驗好兩極：交互好順、思路好清晰，但都實實在在踩咗幾個坑。
今日就完整噉講嚇真實使用感受，俾想用佢嚟做開發嘅朋友少少參考。

Superpowers 係咩嚟？


簡單嚟講，Superpowers 係一套規範化嘅 AI 開發工作流插件，目前主流適配 Claude Code，亦支持其他 AI 開發環境。
佢唔似普通對話噉想到邊寫到邊，而係有一套固定邏輯：
一步步引導你將諗法講清楚 → 幫你產出完整設計文檔 → 制定可執行嘅開發計劃 → 再按計劃生成代碼。
每一步完成之後，都會等你確認，先至進入下一階段，睇落非常工程化、好可控。
上手都簡單，打開 Claude Code 命令行，直接輸入指令就得：
圖片
跟住 Superpowers 會主動追問細節、補齊資訊，從設計文檔、開發計劃到最終代碼，一條龍輸出，全程順暢唔窒。
圖片
最後整出嚟嘅網頁工具，同設計文檔裏面嘅原型圖完全對得上，還原度滿分：
圖片
但係如果真係以為佢可以一步到位、直接交出可以用嘅工具，咁就太樂觀啦。由最初嘅需求，到最終用得嘅成品，我仲係接連踩咗幾個坑。

坑一：設計文檔完善，唔代表行得通


Superpowers 喺梳理需求時算係細緻，同我溝通完幾個問題之後，好快就輸出咗一份設計文檔。乍睇落內容非常全面，條理亦好規整：
圖片
我當時睇住呢份設計文檔仲心諗：咁細個工具用 Superpowers，簡直大材小用！
結果一運行直接出事。初頭只係一啲小問題，修修補補都算接受得到，直至遇到咗無從入手嘅致命 bug：呢套方案根本唔支援 Markdown 複雜語法！
多個 MD 檔案合併成 PDF 時，各種渲染問題接踵而至：表格渲染錯亂、URL 圖片加載空白。Mermaid 圖表同代碼塊只顯示原始文本等等...
（下圖係合併為 PDF 之後嘅實際效果）
圖片

而對呢啲語法嘅轉換，正正係我做呢個工具最核心嘅需求。我靜落嚟反思：
點解設計方案咁詳細，最後都係出事？
講白啲，都係需求冇梳理到位。喺需求澄清階段，Superpowers 的確主動同我確認咗格式、排序、水印呢啲嘢，但就係冇提過 Markdown 複雜渲染嘅事。
當我同 AI 喺最開始就一齊漏咗關鍵細節，最終整出嚟嘅嘢自然達唔到預期。當然，都唔好指望 AI 幫你孭鑊，講到底都係要自己對產品負責。
核心功能一定要由頭到尾講清楚、講透徹，否則最後攞到嘅只係一份睇落專業但係行唔通嘅『靚文檔』。

坑二：話好嘅流程，AI 唔會自覺遵守


經歷咗之前嘅失敗之後，我唔死心，打算重新同 Superpowers 完整梳理一次需求，再睇睇實際效果。今次我喺需求溝通階段就直接講到明：必須完整支援 GFM 語法、URL 圖片同 Mermaid 圖表嘅正常渲染。最終幾乎一次就攞到滿意嘅效果：
圖片
但係喺執行過程入面，我都遇到咗一個流程上嘅坑：Superpowers 進行咗需求對話之後，直接跳過設計文檔、執行計劃呢兩個核心環節，自顧自就生成咗代碼。
圖片
我原本以為運行 Superpowers，就等於俾 AI 套咗流程嘅枷鎖，會嚴格跟從「需求澄清 → 設計文檔 → 執行計劃 → 代碼生成」嘅完整鏈路。
但實際執行入面，AI 都係改唔到急於出結果嘅本能，成日想跳過佢覺得「多餘」嘅步驟就算你明確話用 Superpowers，佢都係會自行判斷「需求傾透了，直接寫代碼先係最有效率」，將中間關鍵環節全部忽略。
所以想 AI 嚴格遵守流程，必須喺溝通開始時主動強制約束：
嚴格按照 Superpowers 嘅完整流程執行：必須先完成 brainstorming 需求對話 → 生成完整設計文檔 → 生成詳細執行計劃 → 最後先寫代碼，絕對禁止跳過任何環節，禁止直接生成代碼。
只有明確要求佢一步一步嚟，先至可以徹底堵住佢偷懶跳步嘅空間。

坑三：Subagent 模式繁瑣耗時，小項目慎用


最後講嚇代碼執行階段嘅問題，Superpowers 提供咗兩種運行方式：
  • Subagent 子代理驅動模式：將任務拆分，多代理協同執行
  • 普通直接執行模式：一次性生成完整代碼，步驟簡單、速度更快
圖片
好明顯，Subagent 模式更規範，亦係官方推薦做法。但實際用起嚟問題好明顯：速度慢到離譜！
就我咁一個簡單嘅小工具，佢拆成咗 8 個任務，每個任務仲分配 3 個子代理：一個負責寫代碼，另外兩個負責審查校驗。
圖片
而且呢度嘅審查，重點淨係睇住代碼格式、語法規範，以及係咪同設計文檔字面一致，並唔會真正校驗功能用唔用到、頁面渲染正唔正常。
即係話，就算你乖乖地行完 Subagent 全程，最後攞到嘅都可能係一份「檢查全部過，但係根本唔符合預期」嘅工具。
所以呢度俾大家一個實用嘅建議：優先保證設計文檔正確、核心需求寫全寫透代碼生成階段，簡單項目完全冇必要開 Subagent，一次執行到位反而效率更高。Subagent 模式更適閤中大型複雜工程，用喺小工具上純屬多此一舉。

講嚇真實使用感受


整體用落嚟，Superpowers 的確可以令開發流程更規範、更有條理，但佢唔係全自動開發神器，更加似一個規範流程 + 效率放大器。
佢可以幫你梳理邏輯、提升產出速度，但冇法幫你明確需求、冇法幫你保證功能真正用得想用佢嚟做出真正用得嘅工具，關鍵仲係：
需求講細啲、方案驗真啲、把控關鍵環節，唔好完全交俾 AI 自己行。
------

面試突擊資源推薦：
✅學習網站：https://niuniumart.com
✅刷題闖關+模擬面試：牛面Offer小程序
✅後端訓練營：Java/Go 後端訓練營

最近牛哥用 Claude 搭配 Superpowers，做了一個多文件合併為 PDF 的網頁工具。全程跟着它的工作流走下來，體驗很兩極：交互很順、思路很清晰，但也實實在在踩了好幾個坑。
今天就完整聊聊真實使用感受，給想用它做開發的朋友一點參考。

Superpowers 是什麼？


簡單來說，Superpowers 是一套規範化的AI開發工作流插件，目前主流適配 Claude Code，也支持其他 AI 開發環境。
它不像普通對話那樣想到哪寫到哪，而是有一套固定邏輯：
一步步引導你把想法說清楚 → 幫你產出完整設計文檔 → 制定可執行的開發計劃 → 再按計劃生成代碼。
每一步完成後，都會等你確認，再進入下一階段，看上去非常工程化、很可控。
上手也簡單，打開 Claude Code 命令行，直接輸入指令就行：
圖片
接着 superpowers 會主動追問細節、補全信息，從設計文檔、開發計劃到最終代碼，一條龍輸出，全程絲滑不卡殼。
圖片
最後做出來的網頁工具，也跟設計文檔裏的原型圖完全對上，還原度拉滿：
圖片
但真要以為它能一步到位、直接交出可用的工具，那就樂觀了。從最初的需求，到最終能用的成品，我還是接連踩了好幾個坑。

坑一：設計文檔完善，不代表行得通


Superpowers 在梳理需求時還算細緻，和我溝通完幾個問題後，很快就輸出了一份設計文檔。乍看上去內容非常全面，條理也很規整：
圖片
我當時看着這份設計文檔還心想：這麼個小工具用 Superpowers，簡直大材小用!
結果一運行直接翻車。剛開始只是些小問題，修修補補倒也能接受，直到遇到了無從下手的致命 bug：這套方案壓根不支持 Markdown 複雜語法！
多個 MD 文件合併成 PDF 時，各種渲染問題接踵而至：表格渲染錯亂、URL 圖片加載空白。Mermaid 圖表和代碼塊只顯示原始文本等等...
（下圖為合併為 PDF 後的實際效果）
圖片

而對這些語法的轉換，正是我做這個工具最核心的需求。我靜下心來反思：
為什麼設計方案如此詳細，最後還是翻車了？
說白了，還是需求沒梳理到位。在需求澄清階段，Superpowers 確實主動跟我確認了格式、排序、水印這些東西，可就是沒提過 Markdown 複雜渲染的事。
當我和 AI 在最開始就一起漏掉了關鍵細節，最終做出來的東西自然達不到預期。當然，也別指望 AI 幫你背鍋，說到底還是得自己對產品負責。
核心功能一定要從一開始就說明白、講透徹，不然最後拿到的只是一份看起來專業卻跑不通的“漂亮文檔”。

坑二：說好的流程，AI 不會自覺遵守


在經歷了前面的失敗後，我不死心，打算重新和 Superpowers 完整梳理一遍需求，再看看實際效果。這次我在需求溝通階段就直接把話講透：必須完整支持 GFM 語法、URL 圖片和 Mermaid 圖表的正常渲染。最終幾乎一次就拿到了滿意的效果：
圖片
但在執行過程中，我也遇到了一個流程上的坑：Superpowers 進行了需求對話後，直接跳過設計文檔、執行計劃這兩個核心環節，自顧自生成了代碼。
圖片
我原以為運行 Superpowers，就等於給 AI 套上了流程枷鎖，會嚴格遵循「需求澄清 → 設計文檔 → 執行計劃 → 代碼生成」的完整鏈路。
但實際執行中，AI 還是改不了急於出結果的本能，總想着跳過它覺得“多餘”的步驟。就算你明確說用 Superpowers，它還是會自行判斷 “需求聊透了，直接寫代碼才是最高效的”，把中間關鍵環節全忽略。
所以想要 AI 嚴格遵守流程，必須在溝通開始時主動強制約束：
嚴格按照 Superpowers 的完整流程執行：必須先完成 brainstorming 需求對話 → 生成完整設計文檔 → 生成詳細執行計劃 → 最後再寫代碼，絕對禁止跳過任何環節，禁止直接生成代碼。
只有明確要求它一步一來，才能徹底堵住它偷懶跳步的空間。

坑三：Subagent模式繁瑣耗時，小項目慎用


最後再說說代碼執行階段的問題，Superpowers 提供了兩種運行方式：
  • Subagent 子代理驅動模式：把任務拆分，多代理協同執行
  • 普通直接執行模式：一次性生成完整代碼，步驟簡單、速度更快
圖片
很明顯，Subagent 模式更規範，也是官方推薦做法。但實際用起來問題很明顯：速度慢得離譜！
就我這麼一個簡單的小工具，它拆成了 8 個任務，每個任務還分配 3 個子代理：一個負責寫代碼，另外兩個負責審查校驗。
圖片
而且這裏的審查，重點只盯着代碼格式、語法規範，以及是否和設計文檔字面一致，並不會真正校驗功能能不能用、頁面渲染正不正常。
也就是說，哪怕你老老實實走完 Subagent 全程，最後拿到的也可能是一份“檢查全過，卻根本不符合預期”的工具。
因此這裏給大家一個實用的建議：優先保證設計文檔正確、核心需求寫全寫透。代碼生成階段，簡單項目完全沒必要開 Subagent，一次執行到位反而效率更高。Subagent 模式更適合中大型複雜工程，用在小工具上純屬多此一舉。

聊聊真實使用感受


整體用下來，Superpowers 確實能讓開發流程更規範、更有條理，但它不是全自動開發神器，更像一個規範流程 + 效率放大器。
它可以幫你梳理邏輯、提升產出速度，但沒法替你明確需求、替你保證功能真正可用。想用它做出真正能用的工具，關鍵還是：
需求講細、方案驗真、把控關鍵環節，別完全丟給 AI 自己跑。
------

面試突擊資源推薦：
✅學習網站：https://niuniumart.com
✅刷題闖關+模擬面試：牛面Offer小程序
✅後端訓練營：Java/Go 後端訓練營