Superpowers 漸進式使用過程和最佳實踐
大家好，我是雙越。[wangEditor](https://link.juejin.cn?target=https%3A%2F%2Fwww.wangeditor.com%2F) 作者，前百度、滴滴資深前端工程師，慕課網金牌講師，PMP，[前端面試派](https://link.juejin.cn?target=https%3A%2F%2Fwww.mianshipai.com%2F) 作者。我正致力於兩個項目的開發和升級，感興趣的可以私訊我，加入專案小組。
本文記錄了我使用 Claude Code + Superpowers 的整個實踐過程，最後總結出了最佳實踐的方式。供大家參考。
開始
Superpowers 是一套 AI 智慧體 Skill 技能框架和軟體開發的方法論，可以用於多種 AI 程式設計工具，如 CC、Cursor 等。
安裝上它，即可讓你的 AI 程式設計工具擁有最強大的軟體研發能力，符合 Harness 工程的標準。
安裝
新建一個 Node.js 專案，用於體驗 superpowers
我用的是 Claude Code，直接參考 Superpowers 文件來安裝外掛即可。如果你是其他 AI 程式設計工具，文件裡也有相應的安裝方式。
bash 体验AI代码助手 代码解读复制代码/plugin install superpowers@claude-plugins-official安裝完成以後，可以看到專案中的這個設定。
啟動 Claude Code 輸入 /skill 可以看到和它相關的很多技能
初體驗
從一個簡單的需求開始，給 CC 輸入如下指令
bash 体验AI代码助手 代码解读复制代码开发一个控制台应用，一个 AI chat ，
用户在控制台输入文字，传递给 AI 接口，AI返回文字，和用户聊天。
AI 接口使用 kimi API https://platform.kimi.com/docs/guide/start-using-kimi-api#node-js
APIkey在.env文件中的 MOONSHOT_API_KEY 。
先不要使用任何框架，代码和功能越简单越好。然後它開始腦力激盪，並和使用者確認了一些模糊的問題 —— 這一點很好，很驚艷。
因為在預設情況下，CC 或其他 AI 工具，使用者只要一輸入，就開始非常激進地寫程式碼。甚至有時候你讓它做一個按鈕，它直接給你激進地開發一個表單。像一頭脫韁的野馬。
然後她顯示一個設計思路，使用者確認是否正確。一開始就效果如此明顯，點讚～
確認以後，它就開始寫 spec 文件，也就是技術方案文件，而且文件還存放在 docs 目錄下。
我們日常聊的 plan mode 是先寫計畫再實作，它這裡光寫計畫就分了好幾個步驟。步驟越多，寫出來的就越清楚明確。
然後它讓使用者確認這個文件是否有問題，使用者確認同意之後，它才開始寫程式碼。寫完程式碼，我自己執行測試，通過了。
初體驗的疑問
雖然它的腦力激盪、寫設計思路、寫 spec 文件很驚艷到我，但這次流程過於簡單了。
沒有測試、沒有 code review，也沒有用 subagent。我問 CC，它就說複雜任務可以，現在是簡單任務沒必要。
繼續體驗
開發第二個功能：讓這個 AI chat 支援多輪對話。這個功能稍微複雜一點。
和上次一樣，它開始腦力激盪、詢問模糊問題、寫 spec 文件。
除了 spec，這次它還寫了 plan 文件，也存放在了 docs 目錄下。看來它判斷這次的功能複雜一些。
PS. spec 是需求和設計，說清楚功能和範圍即可，內容比較少。plan 是說清楚一步一步怎麼做，要拆分任務和步驟，內容比較多。
確認了 spec 和 plan 文件之後，它開始寫程式碼。
這次，它就提示我可以開啟 subagent-driven，使用多個 subagent 完成多個 task。
在 subagent 中執行 code review，是它判斷複雜功能，自動執行的。
開發過程中自動執行 git commit，這也是 AI 程式設計需要做的。
最後程式碼寫完，我自己測試成功——它依然沒有 test 測試過程。
而且，這個功能雖然複雜一點，但也就是 50 行程式碼的工作量，它跑了 10 分鐘，感覺太慢了。
總之比上次好多了，至少有了 review、subagent 和 git commit
為何沒有 test？
去網上查別人的使用攻略，別人說要提到一些關鍵字：TDD、先寫測試、程式碼走查等
再開發一個任務試試：
bash 体验AI代码助手 代码解读复制代码开发新功能：
首先，新增一个 bash_tool 用于执行 shell 脚本。tool 内部限制，只能操作 ./data 目录下的文件，其他目录不能操作。
然后，调用 AI 接口时传入这个 tool ，做一个简单的 ReAct agent。
先写测试后开发，写代码代码做 code review它依然是腦力激盪、詢問模糊問題、寫設計思路、寫 spec 和 plan 文件。
這次果然考慮到了測試，在文件中就寫出了。
開始開發，推薦 subagent 方式，拆分 4 個任務。
開始一個一個執行，過程比較慢。
執行測試，測試通過。現在開始程式碼走查 review
review 查出問題了，它繼續派 agent 修復
最終任務結束，review 修復問題，測試通過，並 git 提交記錄。這個過程就比較完美了。
提出更多要求
再開發一個新需求，嘗試用 git worktree，開發完修改 README 文件。
diff 体验AI代码助手 代码解读复制代码开发新功能：
当前的 bash_tool 安全性还是不能保障，它不仅可以修改文件，还能执行其他 shell 命令，危险。
所以删掉 bash_tool ，增加 write_file_tool read_file_tool new_file_tool 三个 tool ，这三个 tool 也只能操作 ./data 目录下的文件，其他目录不可以。
流程要求：
- 在一个独立的 git worktree 开发，不要在当前 main 分支开发
- 先写测试再开发
- 写完代码要 code review
- 更新 README.md 文档
- 测试、review 没问题，提交 git commit和之前一樣：腦力激盪、寫設計方案、寫 spec 和 plan 文件，讓使用者確認。執行時推薦使用 subagent-driven，拆分多個任務，每個任務派發一個 subagent。
按照我們的要求，它要建立 git worktree
同意，它就自動建立
拆分了 7 個任務，一步一步執行，時間比較慢。
PS. 因為 git worktree 是不同的目錄，所以開發過程中會有很多審批，就有點煩人
終於執行到最後一步了，已經 20 多分鐘了
處理完了，它詢問 worktree branch 應該怎麼處理？
我先保持現狀，自己測試一下。
自測通過，再手動合併到 main 分支
css 体验AI代码助手 代码解读复制代码把这个 worktree branch 合并到 main 分支整合測試
其實也可以讓 AI 執行整合測試。PS. 後續可以把這個加入到最開始的提示詞中
arduino 体验AI代码助手 代码解读复制代码你来执行集成测试。npm run build 然后 npm run start 启动
先和 AI 打招呼，闲聊两句
然后让 AI 创建一个新文件，读取这个文件，再编辑这个问题，再读取这个文件
遇到问题请你自己修复，直到能满足这个集成测试經過 2 分鐘執行，測試通過了。還是 AI 自動執行比較好，人工是最不穩定的。
最佳實踐
Superpowers 定義的研發流程如下，這也是我們傳統的軟體研發流程，每個公司的實踐情況不一樣。
markdown 体验AI代码助手 代码解读复制代码1. Brainstorming（腦力激盪）
↓ 透過問答釐清需求
↓ 分塊展示設計方案並等待確認
↓ 人工確認最終設計
2. Git Worktree（環境隔離）
↓ 建立獨立的 Git 工作樹
3. Writing Plans（任務拆解）
↓ 將任務拆分為 2–5 分鐘的小步驟
4. Subagent Development（子智慧體開發）
↓ 每個任務啟動獨立子智慧體
↓ 兩階段審查：規範合規 + 程式碼品質
5. TDD（測試驅動開發）
↓ 按 RED–GREEN–REFACTOR 迴圈實作
6. Code Review（程式碼審查）
↓ 對實作進行最終品質檢查
7. Finish Branch（完成）Superpowers 可以很聰明地處理很多事情，例如
- 腦力激盪，詢問模糊問題
- 編寫 spec 和 plan 文件
- 拆分多任務並使用 subagent 執行
但有些地方還需要自己在提示詞中說明：
第一，簡單任務，提示詞應該包括：
css 体验AI代码助手 代码解读复制代码单独 git branch
单元测试/TDD
code review
git commit第二，複雜任務，提示詞應該包括：
css 体验AI代码助手 代码解读复制代码单独 git worktree
单元测试/TDD
集成测试
code review
更新 README.md有了這些說明，它才會執行得更加規範。否則讓它自由發揮，就會有很多不確定性。
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式
