superpowers-zh 是什麼、怎麼安裝：Superpowers 中文版（完整漢化 + 中文代碼審查、Git 工作流等原創技能）

本文根據 jnMetaCode/superpowers-zh 倉庫 README 整理，資料核對於 2026-10-11。這是社區項目，不是 Superpowers 原作者的官方中文版。

是什麼

Superpowers 是目前 Star 數最高的 Skills 開發流程框架，但它的技能全是英文，安裝方式也主要照顧海外的工具。superpowers-zh 是開發者 jnMetaCode 維護的中文社區版：把上游技能完整翻譯成中文（技術術語保留英文），再補上一些面向國內開發環境的內容。

README 用一個例子說明裝和不裝的區別：你說「給用戶模組加個批量導出功能」，沒裝時智能體直接開始寫代碼；裝了之後它會先問導出格式、數據量、權限要求，給出兩三個方案，確認後再動手——這正是上游 brainstorming 技能的行為，只是全程中文。

與上游的差異，README 列了一張對比表，要點有三：

• 安裝方式：上游按工具分別安裝，這裏是一條 npx superpowers-zh 自動識別項目裏的工具並安裝；
• 支持的工具：號稱 26 款，除了 Claude Code、Cursor、Codex 等，還包括 Trae、Qoder（阿里）、CodeBuddy（騰訊）、華為雲碼道 CodeArts、Kiro、Qwen Code 等；
• 本地化內容：Git 平台示例覆蓋 Gitee、Coding、極狐 GitLab、CNB，代碼審查風格適配國內團隊的溝通習慣。

截至 2026-10-11，GitHub 顯示該倉庫約 8291 Star、769 Fork，最近一次推送在 2026-10-08。

包含哪些 Skill

README 的統計是 21 個：

• 15 個翻譯技能：對應上游的 brainstorming、writing-plans、test-driven-development、systematic-debugging 等；
• 4 個原創技能（都是手動調用，不會自動觸發）：chinese-code-review（符合國內團隊文化的代碼審查規範）、chinese-git-workflow（適配 Gitee / Coding / 極狐 GitLab / CNB）、chinese-documentation（中文排版、中英混排、避免機翻味）、chinese-commit-conventions（中文提交資訊規範）；
• 2 個上游已移除、本項目保留的技能：mcp-builder 和 workflow-runner。

README 解釋了原創技能設計成手動調用的原因：它們是參考資料而非工作流，避免干擾上游技能的自動調度。

怎麼安裝

在項目目錄裏運行：

bash
npx superpowers-zh

它會識別當前項目使用的工具並把技能裝到對應目錄（例如 Claude Code 是 .claude/skills/，Cursor 是 .cursor/skills/，Codex 是 .agents/skills/）。識別不出來時用 --tool <名稱> 指定，例如 npx superpowers-zh --tool cline；個別工具需要 --global。

怎麼用

• 裝好後照常用中文提需求，流程類技能會自動觸發；
• 需要中文規範時手動調用：/chinese-code-review、/chinese-commit-conventions 等；
• 各技能的具體行為可參考本站對上游 Superpowers 各個技能的介紹。

適合誰 / 不適合誰

適合： 團隊成員更習慣中文交流、希望智能體的提問和計劃文檔都是中文的開發者；使用 Trae、Qoder、CodeBuddy 等上游沒有照顧到的國產工具的用戶；代碼託管在 Gitee、Coding 等平台的團隊。

不適合： 已經在用英文原版並且運轉良好的人——兩者不要同時安裝，同名技能會衝突；追求與上游完全同步的人，翻譯版本難免滯後。

注意事項

• 許可證：MIT，上游 obra/superpowers 同為 MIT。
• 這是社區分支：翻譯質素和更新節奏取決於維護者，上游改動（Superpowers 更新很頻繁）不會立刻體現。遇到行為與上游文檔不一致時，以實際安裝的 SKILL.md 為準。
• README 含推廣內容：倉庫說明裏有維護者的免費課程、贊助商資訊和其個人的其他工具推薦，與技能本身無關，按需取用。
• 安裝腳本會寫入多個目錄：npx 會下載並執行 npm 包，裝之前可先看 npm 頁面和倉庫裏的安裝腳本；它會在項目裏創建各工具的技能目錄和規則文件。
• 第三方技能安裝前建議抽讀幾個 SKILL.md。