前言¶
在 Cursor、Claude Code 等環境裏寫代碼，常見情況是：需求一多就跳過設計直接改文件，測試和 Code Review 靠自覺，分支收尾也缺少固定步驟。對話式 Agent 能寫代碼，但缺少一條可重複走完的鏈路。
下面介紹 SkillHub 上的 Superpowers。它把「頭腦風暴 → 設計 → 計劃 → TDD → 子 Agent 開發 → 代碼審查 → 分支收尾」串成一套方法論，並以 Skill 形式交給 Agent 執行，適用於新功能、重構、修 bug 等編程任務。
這是什麼¶
Superpowers 是一套完整的軟件開發方法論與 Skill 組合系統，由社區發佈者 user_14606527 維護，座標爲 @user_14606527/superpowers-skill，當前版本 1.0.1，分類爲 dev-programming，來源標註爲 community，說明自 obra/superpowers 移植而來。
SkillHub 頁面簡介將其定位爲：提供結構化、可重複的工作流，用於 coding、建項目、重構、修 bug 或任意編程任務。標籤 requires_api_key=false，表示安裝後一般不需要額外 API Key 才能啓用 Skill 本身。
核心功能¶
依據官方簡介，Superpowers 覆蓋以下階段（名稱保持原文）：
- brainstorming：在寫代碼前澄清目標與約束。
- design：形成可執行的設計結論，避免直接堆實現。
- planning：把設計拆成可驗證的步驟。
- TDD：以測試驅動的方式推進實現。
- subagent-driven dev：在合適環節用子 Agent 分擔探索或並行任務。
- code review：在合併前做結構化的代碼審查。
- finishing branch：完成分支上的收尾工作（如測試、文檔、合併前檢查等，具體步驟以 Skill 內
SKILL.md爲準）。
整體是「方法論 + 多個 Skill 組合」，而不是單點提示詞：Agent 讀取 Skill 後，應按上述順序組織對話與工具調用，而不是每次從零即興發揮。
安裝與啓用¶
通過 SkillHub CLI（推薦）¶
SkillHub 安裝說明見 skillhub.cn/install/skillhub.md。先確認本機是否已有 CLI：
command -v skillhub && skillhub --version
若未安裝，可執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝 Superpowers 時，必須用 --dir 指向當前 Agent 的 skills 目錄；默認裝到 ./skills/ 時，部分客戶端不會自動加載。
在 Cursor 中，skills 目錄一般爲：
skillhub install @user_14606527/superpowers-skill --dir ~/.cursor/skills/
其他常見路徑（來自 SkillHub 安裝文檔，按你實際使用的客戶端選擇）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/ - Windsurf：
~/.codeium/windsurf/skills/或項目下的.windsurf/skills/
安裝完成後，按你所用客戶端的要求重啓或刷新 Agent，使新 Skill 被索引。
通過自然語言讓 Agent 安裝¶
SkillHub 技能頁提供的安裝提示爲：請 Agent 根據 https://skillhub.cn/install/skillhub.md 安裝 @user_14606527/superpowers-skill。適合已打開對話、希望由 Agent 代勞 CLI 的場景；仍須指定正確的 --dir，否則 Skill 可能裝到錯誤位置。
典型用法¶
官方頁面未給出單獨的業務 demo 倉庫；典型用法是：在編程類任務中啓用 Superpowers，讓 Agent 按工作流階段推進，而不是隻回答單輪補丁。
可復現的起步方式示例：
- 完成上述安裝，確認 Skill 出現在對應 skills 目錄。
- 在 Cursor（或其他已配置目錄的客戶端）中發起任務，例如：「用 Superpowers 流程：先 brainstorm，再 design 和 plan，然後 TDD 實現某某功能。」
- 觀察 Agent 是否分階段產出（需求/設計/計劃/測試與實現/審查/分支收尾），並在每階段確認後再進入下一步。
若需覈對某一階段的具體指令或子 Skill 名稱，應打開安裝後的 SKILL.md 及同目錄下的引用文件；本文僅依據 SkillHub 公開簡介與安裝說明，不展開未在頁面上列出的內部文件名。
適用場景與注意¶
適合誰
- 希望 Agent 參與完整開發週期、而不只是「改一行代碼」的個人或小團隊。
- 需要 repeatable workflow：多次任務走同一套 brainstorming → finishing branch。
- 已在用 Cursor / Claude Code / Codex 等支持 Skills 目錄的客戶端。
限制與注意
- 工作流比自由對話更長，小改動可能顯得「重」；可明確要求 Agent 跳過不適用的階段，但仍以 Skill 內規則爲準。
- 子 Agent、TDD、代碼審查的效果取決於底層模型與項目測試基建；Skill 提供結構，不替代 CI 或人工終審。
- 版本以 SkillHub 爲準（當前 1.0.1）；升級可用
skillhub的 update 類命令（參見 SkillHub 安裝文檔第三節），並再次指定--dir。 - SkillHub 抓取信息顯示：評分 100000，下載 34976，分類 dev-programming；具體統計會隨平臺更新變化，以 技能頁 爲準。
結尾¶
Superpowers 把 obra/superpowers 的方法論落到 SkillHub 可安裝的 Skill 上，用固定階段約束 Agent 的軟件開發過程。若你希望編程任務默認走「先想清再寫、先測再合、審查後再收尾」，可以從安裝 @user_14606527/superpowers-skill 開始。
官方入口：
