Superpowers-給AI編程代理裝上一套完整工程技能

作者:阿福研習社
日期:2026年4月27日 上午12:02
來源:WeChat 原文

整理版優先睇

速讀 5 個重點 高亮

Superpowers 係一套幫 AI 編碼代理提升工程規範嘅技能框架,安裝後 AI 會自動執行開發流程。

整理版摘要

呢篇文章介紹 GitHub 上一個叫 Superpowers 嘅開源項目(16.8k Star),由 Jesse Vincent(obra)同 Prime Radiant 團隊開發,屬於 MIT 協議。作者嘅目標係解決 AI 編碼代理(如 Claude Code、Cursor、Trae)成日亂寫代碼、唔問需求就開工、唔做測試就話完成嘅問題。整體結論係:Superpowers 提供一套可組合嘅技能框架,令 AI 遵循正確嘅軟件開發工作流程,從而提高代碼質量同開發效率。

Superpowers 包含七個自動觸發嘅階段:brainstorming(先搞清楚需求)、using-git-worktrees(建立隔離環境)、writing-plans(拆成細任務)、subagent-driven-development(並行開發同審查)、test-driven-development(強制 TDD 循環)、requesting-code-review(自動代碼審查)、finishing-a-development-branch(完成後驗證清理)。同時,佢跟隨四大原則:TDD 優先、系統化除錯、簡化複雜性、證據優於聲明。

安裝方法好簡單,可以手動複製技能檔案到 Trae 嘅 skills 目錄,或者用 openskills 工具自動安裝。裝咗之後,AI 編程代理嘅行為會有明顯改善:主動提問、拆分任務、先寫測試、有系統地除錯。呢套框…

  • Superpowers 提供七階段工作流程,從 brainstorming 到完成驗證,確保開發規範唔會出錯。
  • 安裝方法有兩種:手動複製技能檔案到 .trae/skills 目錄,或者用 openskills 工具自動安裝,後者可以揀選部分技能。
  • 安裝後 AI 會主動提問、自動拆解任務、強制先寫測試再寫代碼,出錯時跟系統化除錯流程。
  • 適用範圍包括 AI 編程重度用戶、團隊協作、學習 TDD 嘅開發者,同埋需要規範開發流程嘅團隊。
  • 使用時要注意目錄差異(國際版 .trae,國內版 .trae-cn),同埋小修小補唔需要行曬全部技能,避免浪費時間。
值得記低
連結 github.com

Superpowers GitHub 倉庫

項目主頁,包含所有技能檔案同文檔。

整理重點

Superpowers:AI 編碼代理嘅工程技能庫

Star 數已經飆到 16.8 萬,呢個項目由 Jesse Vincent(obra)同 Prime Radiant 團隊開發,專注研究點樣令 AI 編碼更可靠。Superpowers 本質上係一套可組合嘅技能框架,畀編碼代理(Claude Code、Cursor、Trae 等)喺寫代碼時遵循正確嘅工程流程。

核心工作流分為 7 個階段,全部自動觸發

  1. 1 brainstorming:動手前先提問,搞清楚需求
  2. 2 using-git-worktrees:用 git worktree 創建隔離開發環境
  3. 3 writing-plans:將大任務拆成 2-5 分鐘嘅細塊
  4. 4 subagent-driven-development:子代理並行開工,兩階段審查
  5. 5 test-driven-development:強制 RED-GREEN-REFACTOR 循環
  6. 6 requesting-code-review:任務之間自動代碼審查
  7. 7 finishing-a-development-branch:完成後驗證測試並清理

四大原則TDD 優先、系統化除錯、簡化複雜性、證據優於聲明

整理重點

喺 Trae 中安裝 Superpowers

Trae 原生支援 Skills 功能,安裝超簡單

方法一係手動安裝,五分鐘搞掂:首先 clone 倉庫,然後喺項目根目錄創建 .trae/skills(國際版)或 .trae-cn/skills(國內版),再將 superpowers/.claude/ 下嘅所有技能文件夾複製過去,最後重啟 Trae。驗證方法係問 AI「你有 superpowers 嗎?」。

方法二用 openskills 工具自動安裝:全域安裝 openskills,然後執行 openskills install obra/superpowers,最後同步到 AGENTS.md。呢個方法可以選擇性地安裝部分技能。

手動安裝命令 bash
git clone https://github.com/obra/superpowers.git
mkdir -p .trae/skills   # 或 .trae-cn/skills
cp -r superpowers/.claude/* .trae/skills/
# 重啟 Trae
整理重點

安裝之後嘅實際體驗

AI 會開始主動提問,唔會再一嚟就開寫

呢個係 brainstorming 技能嘅作用,確保需求清楚先開工。跟住 writing-plans 同 subagent-driven-development 會自動將大需求拆成細任務,每個任務 2-5 分鐘完成。

TDD 流程強制執行,寫功能前先寫測試用例

除錯方面,AI 唔會再靠估,而係跟系統化除錯流程:復現 → 定位原因 → 修復 → 驗證。如果需要指定特定技能,直接喺 prompt 入面講就得,例如「用 brainstorming 技能幫我梳理需求」。

手動指定技能:用「用 test-driven-development 方式實現用戶登錄功能」

整理重點

適用場景同注意事項

適合用嘅人包括:AI 編程重度用戶(令 AI 更可靠減少返工)、團隊協作場景(統一風格同審查標準)、想學 TDD 嘅開發者(AI 手把手帶你行流程)、項目管理混亂嘅團隊(強制規範流程)。

Trae 掃描 skills 目錄時只認直接子目錄,唔可以套太多層

  • Trae CN 同國際版目錄名唔同,要小心區分
  • 唔係所有技能都適合每次開啟,例如小修小補唔需要 brainstorming
  • Superpowers 更新頻繁,建議定期 git pull 同步最新版

168k Star!俾 AI 寫程式助手裝一套「超級技能」,從此寫代碼唔再亂咁嚟

用 AI 寫代碼係爽,但你有冇發現——佢成日自作主張、一路行到黑

唔問需求就開搞,唔寫測試就話搞掂,出咗 Bug 靠估唔靠排查。講白啲,AI 編碼代理缺嘅係一套工程方法論

GitHub 上有個項目叫 SuperpowersStar 數已經飆到 16.8 萬喇。佢就係嚟解決呢個問題嘅——俾 AI 裝上一套完整嘅軟件開發工作流程。


01 Superpowers:AI 編碼代理嘅「工程技能庫」

Star:168k | 語言:Shell + JS | 協議:MIT

作者係 Jesse Vincent(obra)同 Prime Radiant 團隊,呢班人專門研究點樣令 AI 編碼更可靠。

Superpowers 講白啲就係 一套可以組合嘅「技能框架」,令編碼代理(Claude Code、Cursor、Trae 等)寫代碼嘅時候跟返正確嘅工程流程。

核心工作流程(7 個階段自動觸發)

階段
技能
幹啥的
1
brainstorming
鬱手前先提問,搞清楚需求
2
using-git-worktrees
用 git worktree 創建隔離開發環境
3
writing-plans
將大任務拆做 2-5 分鐘嘅小塊
4
subagent-driven-development
子代理並行開工,兩階段審查
5
test-driven-development
強制 RED-GREEN-REFACTOR 循環
6
requesting-code-review
任務之間自動代碼審查
7
finishing-a-development-branch
完成後驗證測試並清理

四大原則

  • TDD 優先 —— 先寫測試再寫代碼
  • 系統化除錯 —— 唔靠估,按流程排查錯誤
  • 簡化複雜性 —— 可以簡單就唔好複雜
  • 證據優於聲明 —— 做完要驗證,唔可以得把口話成功

開源地址:https://github.com/obra/superpowers


02 喺 Trae 點用?兩個方法任揀

Trae 已經原生支援 Skills 功能喇!下面係具體操作步驟。

方法一:手動安裝(推薦,5 分鐘搞掂)

第 1 步:Clone 倉庫

git clone https://github.com/obra/superpowers.git

第 2 步:創建 Trae skills 目錄

喺你個項目根目錄下面執行:

mkdir -p .trae/skills

⚠️ 注意:如果你用嘅係 Trae CN(國內版),目錄名應該係 .trae-cn/skills

第 3 步:複製 skill 檔案

將 superpowers 倉庫中嘅 .claude/ 目錄下面嘅所有技能資料夾複製到 Trae 嘅 skills 目錄:

# 國際版 Trae
cp -r superpowers/.claude/* .trae/skills/

# 或者 Trae CN 版本
cp -r superpowers/.claude/* .trae-cn/skills/

最終目錄結構係咁樣:

你的項目/
├── .trae/              (或 .trae-cn/)
│   └── skills/
│       ├── brainstorming/
│       │   └── SKILL.md
│       ├── test-driven-development/
│       │   └── SKILL.md
│       ├── systematic-debugging/
│       │   └── SKILL.md
│       ├── writing-plans/
│       │   └── SKILL.md
│       └── ...(其他技能文件夾)
├── AGENTS.md           (可選,用於顯式激活)
└── 你的源代碼...

第 4 步:重啟 Trae

熄咗再開返 Trae,等佢重新掃描 skills 目錄。

第 5 步:驗證係咪生效

喺 Trae 嘅聊天視窗輸入:

「你有 superpowers 嗎?」

如果安裝成功,AI 會回覆關於 superpowers 技能嘅相關內容。

方法二:用 OpenSkills 工具自動安裝

# 1. 全局安裝 openskills 工具
npm i -g openskills

# 2. 安裝 superpowers(自定義倉庫)
openskills install obra/superpowers

# 3. 同步到 AGENTS.md
openskills sync

呢個方法嘅好處係可以有選擇咁安裝部分技能,唔使全部裝曬。


03 安裝後嘅實際使用體驗

裝好之後,你喺 Trae 裏面同 AI 對話時會發現幾個明顯變化:

① 佢開始主動提問喇

之前你一講需求佢就直接開寫,而家佢會先問你幾個問題——呢個係 brainstorming 技能喺度起作用。

② 自動拆分任務

大需求會被拆成一堆小任務,每個任務 2-5 分鐘搞得掂——呢個係 writing-plans 和 subagent-driven-development Planner 喺度工作。

③ 先寫測試

寫功能代碼之前會先寫測試用例——TDD 流程強制執行。

④ 出咗 Bug 有章法

唔再係「我估可能係 xxx」,而係跟系統化除錯流程:復現 → 定位原因 → 修復 → 驗證。

手動指定技能

如果想令 AI 用特定技能,直接喺提示詞裏面講就得:

「用 brainstorming 技能幫我梳理一下呢個需求」

「用 test-driven-development 嘅方式實現用戶登錄功能」

「用 systematic-debugging 嘅方法排查呢個 Bug」


04 適用場景 & 注意事項

適合邊個用

人羣
點解需要
AI 編程重度用戶
令 AI 更可靠,減少返工
團隊協作場景
統一代碼風格同審查標準
學 TDD 嘅開發者
AI 手把手帶你行流程
項目管理混亂嘅團隊
強制規範開發流程

幾個注意事項

  1. Trae 掃描嘅係直接子目錄 —— skills 下面唔可以再套太多層級,否則認唔到
  2. Trae CN 同國際版目錄唔同 —— 國內版用 .trae-cn/,國際版用 .trae/
  3. 唔係所有技能都適合每次開啟 —— 例如小修小補唔需要行完整嘅 brainstorming 流程
  4. 版本更新 —— superpowers 更新頻繁,建議定期 git pull 同步最新版

一句講曬

Superpowers 就係俾 AI 編程代理裝上嘅「工程大腦」。佢唔會幫你寫更多代碼,但可以令寫出嚟嘅代碼質量更高、流程更規範。

對於用 Trae / Claude Code / Cursor 呢啲工具寫代碼嘅同學嚟講,呢套技能基本係必裝的


168k Star!給 AI 編程助手裝一套「超級技能」,從此寫代碼不再瞎搞

用 AI 寫代碼是爽,但你有沒有發現——它經常自作主張、一路走到黑

不問需求就開幹,不寫測試就說完成了,出了 Bug 靠猜而不是靠排查。說白了,AI 編碼代理缺的是一套工程方法論

GitHub 上有個項目叫 SuperpowersStar 數已經飆到 16.8 萬了。它就是來解決這個問題的——給 AI 裝上一套完整的軟件開發工作流。


01 Superpowers:AI 編碼代理的「工程技能庫」

Star:168k | 語言:Shell + JS | 協議:MIT

作者是 Jesse Vincent(obra)和 Prime Radiant 團隊,這幫人專門研究怎麼讓 AI 編碼更靠譜。

Superpowers 說白了就是 一套可組合的「技能框架」,讓編碼代理(Claude Code、Cursor、Trae 等)在寫代碼時遵循正確的工程流程。

核心工作流(7 個階段自動觸發)

階段
技能
幹啥的
1
brainstorming
動手前先提問,搞清楚需求
2
using-git-worktrees
用 git worktree 創建隔離開發環境
3
writing-plans
把大任務拆成 2-5 分鐘的小塊
4
subagent-driven-development
子代理並行幹活,兩階段審查
5
test-driven-development
強制 RED-GREEN-REFACTOR 循環
6
requesting-code-review
任務之間自動代碼審查
7
finishing-a-development-branch
完成後驗證測試並清理

四大原則

  • TDD 優先 —— 先寫測試再寫代碼
  • 系統化調試 —— 不靠猜,按流程排錯
  • 簡化複雜性 —— 能簡單就不復雜
  • 證據優於聲明 —— 做完要驗證,不能嘴上說成功

開源地址:https://github.com/obra/superpowers


02 在 Trae 中如何使用?兩種方法任選

Trae 已經原生支持 Skills 功能了!下面是具體操作步驟。

方法一:手動安裝(推薦,5 分鐘搞定)

第 1 步:克隆倉庫

git clone https://github.com/obra/superpowers.git

第 2 步:創建 Trae skills 目錄

在你的項目根目錄下執行:

mkdir -p .trae/skills

⚠️ 注意:如果你用的是 Trae CN(國內版),目錄名應該是 .trae-cn/skills

第 3 步:複製 skill 文件

把 superpowers 倉庫中的 .claude/ 目錄下的所有技能文件夾複製到 Trae 的 skills 目錄:

# 國際版 Trae
cp -r superpowers/.claude/* .trae/skills/

# 或者 Trae CN 版本
cp -r superpowers/.claude/* .trae-cn/skills/

最終目錄結構長這樣:

你的項目/
├── .trae/              (或 .trae-cn/)
│   └── skills/
│       ├── brainstorming/
│       │   └── SKILL.md
│       ├── test-driven-development/
│       │   └── SKILL.md
│       ├── systematic-debugging/
│       │   └── SKILL.md
│       ├── writing-plans/
│       │   └── SKILL.md
│       └── ...(其他技能文件夾)
├── AGENTS.md           (可選,用於顯式激活)
└── 你的源代碼...

第 4 步:重啓 Trae

關閉再打開 Trae,讓它重新掃描 skills 目錄。

第 5 步:驗證是否生效

在 Trae 的聊天窗口輸入:

「你有 superpowers 嗎?」

如果安裝成功,AI 會回覆關於 superpowers 技能的相關內容。

方法二:用 OpenSkills 工具自動安裝

# 1. 全局安裝 openskills 工具
npm i -g openskills

# 2. 安裝 superpowers(自定義倉庫)
openskills install obra/superpowers

# 3. 同步到 AGENTS.md
openskills sync

這個方法的好處是可以選擇性地安裝部分技能,不用全裝。


03 安裝後的實際使用體驗

裝好之後,你在 Trae 裏跟 AI 對話時會發現幾個明顯變化:

① 它開始主動提問了

之前你一說需求它就直接開寫,現在它會先問你幾個問題——這是 brainstorming 技能在起作用。

② 自動拆分任務

大需求會被拆成一堆小任務,每個任務 2-5 分鐘能完成——這是 writing-plans 和 subagent-driven-development 在工作。

③ 先寫測試

寫功能代碼之前會先寫測試用例——TDD 流程強制執行。

④ 出了 Bug 有章法

不再是「我猜可能是 xxx」,而是按照系統化調試流程:復現 → 定位原因 → 修復 → 驗證。

手動指定技能

如果想讓 AI 使用特定技能,直接在提示詞裏說就行:

「用 brainstorming 技能幫我梳理一下這個需求」

「用 test-driven-development 的方式實現用戶登錄功能」

「用 systematic-debugging 的方法排查這個 Bug」


04 適用場景 & 注意事項

適合誰用

人羣
為什麼需要
AI 編程重度用戶
讓 AI 更靠譜,減少返工
團隊協作場景
統一代碼風格和審查標準
學習 TDD 的開發者
AI 手把手帶你走流程
項目管理混亂的團隊
強制規範開發流程

幾個注意事項

  1. Trae 掃描的是直接子目錄 —— skills 下面不能再套太多層級,否則識別不到
  2. Trae CN 和國際版目錄不同 —— 國內版用 .trae-cn/,國際版用 .trae/
  3. 不是所有技能都適合每次開啓 —— 比如小修小補不需要跑完整的 brainstorming 流程
  4. 版本更新 —— superpowers 更新頻繁,建議定期 git pull 同步最新版

一句話總結

Superpowers 就是給 AI 編程代理裝上的「工程大腦」。它不會幫你寫更多代碼,但能讓寫出來的代碼質量更高、流程更規範。

對於用 Trae / Claude Code / Cursor 這些工具寫代碼的同學來說,這套技能基本是必裝的