superpowers-zh（AI 編程超能力 · 中文增強版）

🌐 简体中文 | 繁體中文 | English (upstream)

🦸 superpowers（250k+ ⭐）完整漢化 + 4 個中國原創 skills — 讓 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 20 款 AI 編程工具真正會幹活。從頭腦風暴到程式碼審查，從 TDD 到除錯，每個 skill 都是經過實戰驗證的工作方法論。

Chinese community edition of superpowers — 20 skills across 20 AI coding tools, including full translations and China-specific development skills.

📖 免費配套學習 → 從零學會 AI 編程(180 節)＋ AI 智能體課程(40 節)— 繁體中文實作課程,免費

📖 免費配套學習 → 從零學會 AI 編程：180 節免費實操課 + 《AI 編程實戰三卷書》線上閱讀 + 實戰社群 · superpowers 裝好後配上方法論效率翻倍 · 永久免費

🆕 v1.7.0 更新亮點（完整 Release Notes →）

• 🌍 全域安裝 npx superpowers-zh --global —— 一次安裝、所有專案共享，多專案使用者告別逐個重裝
• 🧩 新增 騰訊 CodeBuddy 與 華為雲碼道 CodeArts 兩款國產 IDE（工具數 18 → 20）
• 🌐 官網 sp.aiolaola.com + README 新增繁體中文（簡 / 繁 / EN 三語）

📊 專案規模

❤️ 贊助商  _{🙏 想出現在這裡？聯絡 [email protected] 贊助}

感謝 優雲智算 贊助本專案！優雲智算是 UCloud 旗下 AI 雲平台，主打包月、按次的高性價比國模 Agent Plan 方案，支援 GLM-5.2，低至 49 元/月起。同時提供官轉穩定海外模型。支援接入 Claude Code、Codex 及 API 呼叫。支援企業高併發、7×24 技術支援、自助開票。 🎁 透過此連結註冊的使用者，可得免費 5 元平台體驗金！

這是什麼？

superpowers 是目前最火的 AI 編程 skills 框架（250k+ stars），為 AI 編程工具提供系統化的工作方法論。

superpowers-zh 在完整翻譯的基礎上，新增了面向中國開發者的特色 skills。

你：給使用者模組加個批次匯出功能
AI：好的，我來實作...（直接開始寫程式碼）
    export async function exportUsers() { ... }
你：等等，格式不對，沒分頁，大量資料會 OOM...

你：給使用者模組加個批次匯出功能
AI：在開始實作之前，我需要了解幾個關鍵問題：
    1. 匯出格式是 CSV 還是 Excel？
    2. 預計資料量多大？需要非同步處理嗎？
    3. 有權限要求嗎？
    → 給出 2-3 個方案，確認後再動手

🆚 與英文上游的區別（老被問，一次說清）

一句話總結： 英文上游 = 方法論核心；中文增強版 = 方法論核心 + 20 款工具一鍵適配 + 國內 Git/CI 生態 + 中文化表達習慣。

🤖 支援 20 款主流 AI 編程工具

執行 npx superpowers-zh 會自動偵測你專案中使用的工具，將 20 個 skills 安裝到正確位置。

翻譯的 Skills（14 個）

🇨🇳 中國特色 Skills（6 個）

⚠️ 下表前 4 個 chinese-* 為「手動呼叫」skill——不會自動觸發，需在對話中顯式輸入 /chinese-xxx 才會載入。 設計為參考資料而非工作流，避免污染上游 skill 的自動排程（如 requesting-code-review、brainstorming 等）。

快速開始

方式一：npm 安裝（推薦）

專案級（預設，裝到目前專案）：

cd /your/project
npx superpowers-zh

⚠️ 專案級安裝不要在主目錄（~）下跑。v1.2.1 起會拒絕並提示，舊版本會把 skills 和 CLAUDE.md 等 bootstrap 檔案寫到你的 home 目錄，污染所有專案。如已誤裝見下文「解除安裝 / 誤裝清理」。想讓 skills 對所有專案生效，請用下面的全域安裝，而不是在 ~ 下跑專案級。

全域安裝（v1.7.0+，裝到使用者目錄，所有專案共享，適合同時維護多個專案）：

npx superpowers-zh --global                 # 自動偵測已裝工具
npx superpowers-zh --global --tool claude   # 或指定工具

全域安裝把 skills 裝到工具的使用者級目錄（如 ~/.claude/skills），一次安裝所有專案自動可用，更新時也只需重裝一次。專案級優先、全域兜底，二者可共存。

支援通用全域安裝的工具（均為 docs 已證實的使用者級載入路徑）：Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode。其中 Codex CLI 全域裝到 ~/.agents/skills（Codex 啟動掃描目錄）。其餘工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Hermes / Claw）規則是專案級或存於應用內設定，--global 會提示改用專案級；Gemini CLI / Antigravity 有各自專屬的全域方式（Gemini 走擴充目錄），見對應 docs/README.*.md。

方式二：手動安裝（low-fidelity，僅作備選）

⚠️ 手動 cp -r skills 是低保版安裝，不等同於完整 plugin。

superpowers-zh 是一個完整 plugin，包含：skills/（20 個能力）+ hooks/（SessionStart 鉤子，讓 skill 在合適時機自動觸發）+ CLAUDE.md / GEMINI.md 等 bootstrap 引導檔案 + 4 套 plugin manifest（Claude Code / Cursor / Codex / Marketplace）。

下面的 cp -r skills 命令只複製 skills 目錄，不會自動設定 hooks、不會產生 bootstrap 引導。結果：skills 物理上存在，但 AI 不會在合適時機自動呼叫，需要你每次手動喊 "use brainstorming skill" 之類。

強烈推薦用方式一 npx superpowers-zh —— 它會一鍵處理 skills 複製 + bootstrap 產生 + hooks 設定 + 工具特定適配。僅在 npx 不可用（極端無網路環境）時才退到手動。

# 複製倉庫
git clone https://github.com/jnMetaCode/superpowers-zh.git

# 複製 skills 到你的專案（選擇你使用的工具）
cp -r superpowers-zh/skills /your/project/.claude/skills      # Claude Code / Copilot CLI
cp -r superpowers-zh/skills /your/project/.hermes/skills      # Hermes Agent
cp -r superpowers-zh/skills /your/project/.cursor/skills      # Cursor
cp -r superpowers-zh/skills /your/project/.codex/skills       # Codex CLI
cp -r superpowers-zh/skills /your/project/.kiro/steering      # Kiro
cp -r superpowers-zh/skills /your/project/skills/custom       # DeerFlow 2.0
cp -r superpowers-zh/skills /your/project/.trae/rules         # Trae
cp -r superpowers-zh/skills /your/project/.agents        # Antigravity
cp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)
cp -r superpowers-zh/skills /your/project/skills              # OpenClaw
cp -r superpowers-zh/skills /your/project/.windsurf/skills   # Windsurf
cp -r superpowers-zh/skills /your/project/.gemini/skills     # Gemini CLI
cp -r superpowers-zh/skills /your/project/.aider/skills      # Aider
cp -r superpowers-zh/skills /your/project/.opencode/skills   # OpenCode
cp -r superpowers-zh/skills /your/project/.qwen/skills       # Qwen Code
cp -r superpowers-zh/skills /your/project/.claw/skills       # Claw Code（Rust 版）
cp -r superpowers-zh/skills /your/project/.qoder/skills      # Qoder（阿里 AI IDE）

方式三：在設定檔中引用

根據你使用的工具，在對應設定檔中引用 skills：

詳細安裝指南：Kiro · DeerFlow · Trae · Antigravity · VS Code · Codex · OpenCode · OpenClaw · Windsurf · Gemini CLI · Aider · Qwen Code · Hermes Agent · Qoder · CodeBuddy · 華為雲碼道 · Kimi Code · Pi

解除安裝 / 誤裝清理（v1.2.1+）

cd /your/project          # 或 cd ~ 如果誤裝到了主目錄
npx superpowers-zh@latest --uninstall

會做這些：

• 刪除所有裝過的 skill 目錄（.claude/skills/、.trae/skills/ 等）
• 刪除獨立 bootstrap 檔案（.trae/rules/superpowers-zh.md、.qoder/rules/superpowers-zh.md、.agents/rules.md）
• 清理追加到 CLAUDE.md / HERMES.md / GEMINI.md / CONVENTIONS.md 裡的 superpowers-zh 段，保留你自己寫的內容

資料安全說明：v1.2.1 起，安裝會把追加內容包在 <!-- superpowers-zh:begin/end --> 哨兵註解之間，解除安裝按哨兵精確切除。識別不可靠時跳過 + 警告，絕不會誤刪使用者內容。

其他參數：

貢獻

歡迎參與！翻譯改進、新增 skills、Bug 修復都可以。

貢獻方向

我們只接收符合 superpowers 定位的 skill——AI 編程工作流方法論。好的 skill 應該：

• 教 AI 助手怎麼幹活，而不是某個框架/語言的教程
• 解決上游英文版不涵蓋的中國開發者痛點
• 有明確的步驟、檢查清單、範例，AI 載入後能直接執行

歡迎提 Issue 討論你的想法！

交流 · Community

微信掃碼關注

微信公眾號 「AI不止語」（微信搜尋 AI_BuZhiYu）— 技術問答 · 專案更新 · 實戰文章 管道 加入方式 QQ 2群 點擊加入（群號 1071280067） 微信群 關注公眾號後回覆「群」取得入群方式

🌟 相關專案生態

八個專案組合使用，涵蓋 AI 編程 + AI 影片創作 + 桌面陪伴的完整鏈路。

專案	定位	一句話
superpowers-zh（本專案）	🧠 工作方法論	20 個 skills 教 AI 怎麼幹活（TDD / 除錯 / 程式碼審查等）
agency-agents-zh	🎭 專家角色庫	211 個即插即用 AI 專家，含 46 中國原創（小紅書 / 抖音 / 飛書 / 釘釘）
agency-orchestrator	🚀 編排引擎	一句話 → 211 專家協作，幾分鐘出方案（9 家 LLM / 6 免費）
ai-coding-guide	📖 實戰教程	66 個 Claude Code 技巧 + 9 款工具最佳實踐 + 設定範本
shellward	🛡️ 安全中介軟體	8 層防禦 + DLP 資料流 + 注入偵測，零依賴（含 MCP Server）
🆕 ai-shortfilm-prompts	🎬 影片提示詞	Mx-Shell《喪屍清道夫》5 段式方法論 + Skill，Seedance / 小雲雀 / Sora / 可靈 / 即夢通用
🆕 local-agent-toolkit	🛠️ Agent 本地三件套	給 agent 配上記憶 / 技能管理 / 執行追蹤，零依賴、資料不出本機；本倉庫 skills 可用 npx @jnmetacode/skillet add jnMetaCode/superpowers-zh/skills/<名稱> 一鍵安裝
🆕 codepet	🐾 桌面養成桌寵	碼寵 CodePet —— 你寫程式碼 / 用 Claude Code，它就漲經驗、升級、換狀態、跳舞。全本地、隱私優先、開源

🔥 重點推薦：agency-orchestrator — 一句話調度 211 個 AI 專家協作，幾分鐘交付完整方案

以前寫個方案：你當指揮官，把 AI 輪流扮演 5 個角色，複製貼上 10 次，1 小時沒了。

現在： 丟一句話進去 "做一個電商退款流程"，產品 → 架構 → 安全 → 測試 → DBA 自動接力，幾分鐘完整方案落地。

• 🎭 211+ 專家角色（含 46 個中國市場原創：小紅書 / 抖音 / 微信 / 飛書 / 釘釘）
• 🧩 零程式碼 YAML，一行 prompt 就能跑
• 💰 9 家 LLM 可選（DeepSeek / Claude / OpenAI / Ollama 等，6 家免費）
• 🔗 與 superpowers-zh 互補：本專案管"怎麼做"（方法論），orchestrator 管"誰來做"（角色協作）

👉 立即體驗 agency-orchestrator →

致謝

• 原始英文版：obra/superpowers（MIT 協議）
• 感謝 @obra 建立了這個優秀的專案

授權條款

MIT License — 自由使用，商業或個人均可。