mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-02 22:54:06 +08:00

Files

AI不止语 1081cefc42 fix(docs,site): README 把 2 个上游 skill 算成「中国特色」；二维码缺 height；官网外链没人验活

按主站逐项核对时查出的三处，都不是新引入的，是一直没人发现。

## ① README 的「中国特色 Skills（6 个）」与官网自相矛盾

三处口径本来就不一致：

| 位置 | 原来的说法 |
|---|---|
| 官网统计块 | 4 中国原创 |
| `.claude-plugin/plugin.json` | 20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留）|
| 两版 README | **6 个中国特色 Skills** ← 只有它是 6 |

README 把 `mcp-builder` 和 `workflow-runner` 也算进了「中国特色」。用 GitHub API 核过：
**上游 obra/superpowers 现有 14 个 skill，本仓 20 个，多出的正是 4 个 `chinese-*` 加这两个。**
它们来自上游、上游后来移除、本 fork 保留继续维护 —— 跟中国特色没有任何关系，把它们
算成中国原创等于虚报了 50% 的原创量。

改：规模表列名改「中国原创 Skills」值改 4（附注另有 2 个上游历史保留）；小节标题拆成
「中国原创（4 个）· 上游历史保留（2 个）」；表格里这两行的「上游有吗？」由「无」改为
「曾有，上游已移除」——原来写「无」会被读成「我们原创的」，正是错误的来源。简繁同步。

（`using-superpowers` 正文里的「中国特色技能路由」是真实存在的小节名，不动。）

## ② 页脚三个二维码缺 height，加载时把页脚顶下去

`<img width="158">` 没有 height，浏览器算不出宽高比，图一到位就发生布局偏移（CLS）。
赞助商 banner 和 logo 都是齐的，只有二维码漏了。

没有写死数字，而是新增零依赖的 `imageSize()`（PNG 读 IHDR、JPEG 逐段找 SOFn），
构建时从文件读真实尺寸：258×258 / 1125×1680 / 316×316，与 `sips` 实测逐一吻合。
换二维码时属性自动跟随，不会悄悄退回错的比例。

顺带用同一个函数补了一条门禁：**赞助商声明的 `w`/`h` 必须与素材真实尺寸一致** ——
换了 banner 忘了改数字，页面就会按错的宽高比预留位置。

## ③ 外链验活门禁扫不到官网，三条付费展位链接一直无人看守

`verify-release` H 段只扫 `docs/*.md` 与两版 README，`site/build.mjs` 不在列。也就是
旗舰赞助商与两个常规位的推广链接挂掉了不会有任何人知道 —— 而这是要赔的。

扫描范围加上 `site/build.mjs`，并把 `compshare|cubence` 移出排除名单（原来被当噪音跳过），
正则补 `?=&` 让带 aff/referral 参数的推广链接被完整验证而不是截断到路径。
覆盖链接 45 → 52 条。

排除名单新增 `googletagmanager|google-analytics`：它们在 build.mjs 里是 **CSP 白名单条目
不是链接**，裸域 `googletagmanager.com` 实测返回 404，纳入等于凭空造一条误报 ——
这条门禁最忌讳的就是误报。

## 反向验证（三条逐一造错，必须拦下）

- 把官网的 book.aibuzhiyu.com 改成不存在的路径 -> `死链（404）`，FAIL 1
- 把 infistar banner 的 w/h 改成 800×368 -> 构建退出码 1，
  `banner 尺寸对不上：声明 800×368，实际 1269×337`
- 二维码尺寸不再有写死数字（`width="158"` 已从源码消失）

## 全量测试

官网 66 页构建 / 站内死链 0 / 无效 href="#" 0 / **缺 height 的 img 0**（原为 3）；
audit 170 pass 0 fail；verify-release 115 pass 0 fail；CI 等价 20 skills 0 错误 v1.7.11；
tests/kimi · pi · opencode · brainstorm-server 全 PASS。

2026-09-02 21:19:58 +08:00

29 KiB

Raw Blame History

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

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

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

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

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

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

🆕 v1.7.11 更新亮點 —— Codex / VS Code / Windsurf / Qwen Code / DeerFlow / Claw Code 使用者請重裝（此前裝了等於沒裝）：

🐛 Codex CLI —— 專案級裝到 .codex/skills，而官方掃描清單裡從來沒有這個目錄。改為 .agents/skills，重裝會自動清舊位置

🐛 VS Code (Copilot) —— 裝的 20 個檔案 Copilot 一個都不讀，且不寫任何引導。現在產生 .github/instructions/superpowers-zh.instructions.md（applyTo: "**"）

🐛 Windsurf —— --global 裝到 ~/.windsurf/skills，官方使用者級路徑是 ~/.codeium/windsurf/skills/。全域裝過的請重裝

🆕 Qwen Code / Claw Code 補 bootstrap，CodeBuddy / CodeArts 補 --global（全域支援 9 → 11 款）

📋 其餘改動（DeerFlow 偵測標記、4 條死連結含 2 條編造的儲存庫地址、官網工具牆 20 → 23、5 條新門禁…）見 完整 Release Notes →

📊 專案規模

📦 翻譯 Skills	🇨🇳 中國原創 Skills	🤖 支援工具
14	4 _{另有 2 個上游歷史保留}	Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（騰訊）/ CodeArts（華為雲碼道）/ Cline / Kilo Code / Crush

❤️ 贊助商 _{🙏 想出現在這裡？聯絡 jnMetaCode@qq.com 贊助}

superpowers-zh × Infistar.cc 無限星河｜全模型 API · 為 AI 編程注入穩定動力

感謝 Infistar.cc 無限星河贊助並為 superpowers-zh 使用者提供模型服務支援！

⚡ 穩定承載複雜開發任務：提供高可用模型通道與多節點冗餘，價格低至官方渠道 1 折，穩定支援需求分析、方案規劃、TDD、除錯及程式碼審查等長任務。
🧠 一個 API Key 接入主流模型：全面支援 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek 等模型，適配 Claude Code、Codex、Cursor、Windsurf、Kiro 等 AI 編程工具。
🛠️ 賦能完整開發工作流：結合 superpowers-zh 的系統化 Skills，讓 AI 更好地完成頭腦風暴、計畫執行、問題排查和品質檢查。

🎁 superpowers-zh 使用者專屬福利：透過此連結註冊並完成首次呼叫，即可領取 5 美元等值測試額度！

優雲智算 by UCloud — 熱門國產模型按次調用套餐包，低至 49 元/月起

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

Cubence — 專業 AI API 閘道，穩定高效的 API 中轉服務，支援 Claude Code、Codex、Gemini 等多種模型

感謝 Cubence 對本專案的支持。Cubence 是一家致力為客戶提供穩定、高效的 API 中轉服務商。從 25 年 9 月營運至今，提供了 Claude Code、Codex、Gemini 等多種模型支援。🎁 Cubence 為本開源專案的使用者提供了特別的專屬優惠碼 AGENCY，透過此連結註冊的使用者，首次購買即可享受 9 折優惠！

這是什麼？

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

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

沒裝 superpowers-zh：

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

裝了 superpowers-zh：

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

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

維度	superpowers（英文上游）	superpowers-zh（中文增強版）
⭐ Star 數	250k+	—
📦 Skills 總數	14	20（14 翻譯 + 4 國產原創 + 2 上游歷史保留）
🌐 語言	英文	中文（技術術語保留英文）
🤖 支援工具	6 款：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI	23 款：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code / OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（騰訊） / CodeArts（華為雲碼道） / Cline / Kilo Code / Crush
⚡ 安裝方式	按工具分別裝（每款一條不同的 plugin marketplace 命令）	`npx superpowers-zh` 一條命令自動識別專案裡的工具並安裝；識別不出可 `--tool <name>` 顯式指定
🇨🇳 Git 平台	GitHub 為主	GitHub + Gitee + Coding + 極狐 GitLab + CNB（騰訊雲原生建置）
🇨🇳 CI/CD 範例	GitHub Actions	GitHub Actions + Gitee Go + Coding CI + 極狐 CI + `.cnb.yml`
🇨🇳 程式碼審查風格	西方直接風格	適配國內團隊溝通文化
🇨🇳 Git 提交規範	無	Conventional Commits 中文適配
🇨🇳 中文文件規範	無	中文排版 + 中英混排規則 + 告別機翻味
➕ MCP 伺服器建置	無	獨立 `mcp-builder` skill
➕ 工作流執行器	無	獨立 `workflow-runner` skill（多角色 YAML 編排）
➕ 翻譯 skill 內的增量	—	僅 2 處，均在正文顯式標註「本節是 superpowers-zh 的增量內容」：`executing-plans` 的「常見異常處理」、`using-superpowers` 的「中國特色技能路由」。上游各節均為逐節翻譯，不被改動；audit 會強制未標註的增量報錯
🔄 版本跟進	獨立迭代	同步上游 + 國產增量疊加
🤝 接受新 skill PR	一般不接受（原文："we don't generally accept contributions of new skills"）	歡迎 PR（中國開發者痛點優先）
💬 社群	Discord	微信公眾號「AI不止語」+ 微信群 + QQ 群
📜 License	MIT	MIT

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

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

工具	類型	一鍵安裝	手動安裝
Claude Code	CLI	`npx superpowers-zh`	`.claude/skills/`
Copilot CLI	CLI	`npx superpowers-zh --tool copilot`	`.claude/skills/`
Hermes Agent	CLI	`npx superpowers-zh --global --tool hermes`	`~/.hermes/skills/`
Cursor	IDE	`npx superpowers-zh`	`.cursor/skills/`
Windsurf	IDE	`npx superpowers-zh`	`.windsurf/skills/`（全局 `~/.codeium/windsurf/skills/`）
Kiro	IDE	`npx superpowers-zh`	`.kiro/skills/`
Gemini CLI	CLI	`npx superpowers-zh`	`.gemini/skills/`
Codex CLI	CLI	`npx superpowers-zh`	`.agents/skills/`
Aider	CLI	`npx superpowers-zh`	`.aider/skills/`
Trae	IDE	`npx superpowers-zh`	`.trae/skills/` + `.trae/rules/`
VS Code (Copilot)	IDE 外掛	`npx superpowers-zh`	`.github/superpowers/` + `.github/instructions/`
DeerFlow 2.0	Agent 框架	`npx superpowers-zh`	`skills/custom/`
OpenCode	CLI	`npx superpowers-zh`	`.opencode/skills/`
OpenClaw	CLI	`npx superpowers-zh`	`skills/`
Qwen Code	CLI	`npx superpowers-zh`	`.qwen/skills/` + `QWEN.md`
Antigravity	IDE	`npx superpowers-zh`	`.agents/skills/`
Claw Code	CLI (Rust)	`npx superpowers-zh`	`.claw/skills/`
Qoder (阿里 AI IDE)	IDE	`npx superpowers-zh`	`.qoder/skills/` + `.qoder/rules/`
CodeBuddy (騰訊 AI IDE)	IDE	`npx superpowers-zh`	`.codebuddy/skills/` + `CODEBUDDY.md`
華為雲碼道 CodeArts	IDE	`npx superpowers-zh`	`.codeartsdoer/skills/`
Cline	IDE 外掛	`npx superpowers-zh --tool cline`	`.cline/skills/` + `.clinerules/`
Kilo Code	IDE 外掛	`npx superpowers-zh --tool kilocode`	`.kilocode/skills/` + `.kilocode/rules/`
Crush	CLI	`npx superpowers-zh`	`.crush/skills/`

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

翻譯的 Skills（14 個）

Skill	用途
頭腦風暴 (brainstorming)	需求分析 → 設計規格，不寫程式碼先想清楚
編寫計畫 (writing-plans)	把規格拆成可執行的實施步驟
執行計畫 (executing-plans)	按計畫逐步實施，每步驗證
測試驅動開發 (test-driven-development)	嚴格 TDD：先寫測試，再寫程式碼
系統化除錯 (systematic-debugging)	四階段除錯法：定位→分析→假設→修復
請求程式碼審查 (requesting-code-review)	派遣審查 agent 檢查程式碼品質
接收程式碼審查 (receiving-code-review)	技術嚴謹地處理審查回饋，拒絕敷衍
完成前驗證 (verification-before-completion)	證據先行——聲稱完成前必須跑驗證
派遣並行 Agent (dispatching-parallel-agents)	多任務並行執行
子 Agent 驅動開發 (subagent-driven-development)	每個任務一個 agent，兩輪審查
Git Worktree 使用 (using-git-worktrees)	隔離式特性開發
完成開發分支 (finishing-a-development-branch)	合併/PR/保留/丟棄四選一
編寫 Skills (writing-skills)	建立新 skill 的方法論
使用 Superpowers (using-superpowers)	元技能：如何呼叫和優先使用 skills

🇨🇳 中國原創 Skills（4 個）· 上游歷史保留（2 個）

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

⚠️ 表格最後兩個（mcp-builder / workflow-runner）不是中國原創 —— 它們來自上游，上游後來移除了，本 fork 保留下來繼續維護。全倉 20 個 skill = 14 翻譯 + 4 中國原創 + 2 上游歷史保留。

Skill	用途	呼叫方式	上游有嗎？
中文程式碼審查 (chinese-code-review)	符合國內團隊文化的程式碼審查規範	`/chinese-code-review`（手動）	無
中文 Git 工作流 (chinese-git-workflow)	適配 Gitee/Coding/極狐 GitLab/CNB	`/chinese-git-workflow`（手動）	無
中文技術文件 (chinese-documentation)	中文排版規範、中英混排、告別機翻味	`/chinese-documentation`（手動）	無
中文提交規範 (chinese-commit-conventions)	適配國內團隊的 commit message 規範	`/chinese-commit-conventions`（手動）	無
MCP 伺服器建置 (mcp-builder)	建置生產級 MCP 工具，擴展 AI 能力邊界	自動	曾有，上游已移除
工作流執行器 (workflow-runner)	在 AI 工具內執行多角色 YAML 工作流	自動	曾有，上游已移除

快速開始

方式一：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 · Crush · Hermes Agent · CodeBuddy · CodeArts。其中 Codex CLI 全域裝到 ~/.agents/skills（Codex 啟動掃描目錄）。其餘工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Claw / Cline / Kilo Code）規則是專案級或存於應用內設定，--global 會提示改用專案級；Gemini CLI / Antigravity 有各自專屬的全域方式（Gemini 走擴充目錄），見對應 docs/README.*.md。

	專案級（預設）	全域（`--global`）
安裝位置	`<專案>/.claude/skills` 等	`~/.claude/skills` 等使用者級目錄
生效範圍	僅目前專案	所有專案
適合	單專案、需專案內版本固定	多專案、想一次裝好到處可用
解除安裝	`npx superpowers-zh --uninstall`	`npx superpowers-zh --global --uninstall`

方式二：Claude Code Plugin Marketplace

僅限 Claude Code。 走官方 plugin 機制安裝，好處是升級只要一條 claude plugin update，不用重跑 npx：

claude plugin marketplace add jnMetaCode/superpowers-zh
claude plugin install superpowers-zh@superpowers-zh

裝完 claude plugin list 應該看到：

  ❯ superpowers-zh@superpowers-zh
    Version: <当前版本>
    Scope: user
    Status: ✔ enabled

升級與卸載：

claude plugin marketplace update superpowers-zh          # 先刷新 marketplace 快取
claude plugin update superpowers-zh@superpowers-zh       # 再升級 plugin（需重啟生效）
claude plugin uninstall superpowers-zh@superpowers-zh    # 卸載

和方式一怎麼選？ marketplace 裝的是完整 plugin（skills + hooks + bootstrap 由 Claude Code 統一託管、隨版本更新），但只服務 Claude Code 一款工具。要裝給其餘 19 款工具，仍然用方式一的 npx superpowers-zh。兩者可以共存，但同一個專案裡別重複裝 Claude Code，否則 skills 會出現兩份。

方式三：手動安裝（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/skills        # 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：

工具	設定檔	說明
Claude Code	`CLAUDE.md`	專案根目錄
Copilot CLI	`CLAUDE.md`	與 Claude Code 共用外掛格式
Hermes Agent	`HERMES.md` 或 `.hermes.md`	專案根目錄，安裝時自動產生
Kiro	`.kiro/steering/superpowers-zh.md`（索引，`inclusion: always`）+ `.kiro/skills/`	steering 每輪常駐，故只放索引
DeerFlow 2.0	`skills/custom/*/SKILL.md`	位元組跳動開源 SuperAgent，自動發現自訂 skills
Trae	`.trae/rules/project_rules.md`	專案級規則
Antigravity	`GEMINI.md` 或 `AGENTS.md`	專案根目錄
VS Code	`.github/copilot-instructions.md`	Copilot 自訂指令
Cursor	`.cursor/rules/*.md`	專案級規則目錄
OpenClaw	`skills/*/SKILL.md`	工作區級 skills 目錄，自動發現
Windsurf	`.windsurf/skills/*/SKILL.md`	專案級 skills 目錄
Gemini CLI	`.gemini/skills/*/SKILL.md`	專案級 skills 目錄
Aider	`.aider/skills/*/SKILL.md`	專案級 skills 目錄
OpenCode	`.opencode/skills/*/SKILL.md`	專案級 skills 目錄
Hermes Agent	`.hermes/skills/*/SKILL.md`	專案級 skills 目錄
Qwen Code	`.qwen/skills/*/SKILL.md`	專案級 skills 目錄
Claw Code	`.claw/skills/*/SKILL.md`	Rust 版 CLI agent，相容 Claude Code 的 SKILL.md 格式
Qoder	`.qoder/skills/*/SKILL.md` + `.qoder/rules/superpowers-zh.md`	阿里 AI IDE，自動產生 `trigger: always_on` 的 bootstrap rule

詳細安裝指南：Kiro · DeerFlow · Trae · Antigravity · VS Code · Codex · OpenCode · OpenClaw · Windsurf · Gemini CLI · Aider · Qwen Code · Hermes Agent · Claw Code · 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 起，安裝會把追加內容包在  哨兵註解之間，解除安裝按哨兵精確切除。識別不可靠時跳過 + 警告，絕不會誤刪使用者內容。

其他參數：

參數	用途
`--tool <name>`	自動偵測不到時顯式指定（cursor / trae / hermes / 等）
`--force`	允許在主目錄(~)安裝（預設拒絕，不建議）
`--uninstall`	解除安裝目前目錄下的 superpowers-zh
`--help` / `--version`	說明 / 版本

貢獻

歡迎參與！翻譯改進、新增 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 — 自由使用，商業或個人均可。

🦸 AI 編程超能力：讓 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具真正會幹活

Star 本專案 · 提交 Issue · 貢獻程式碼

29 KiB Raw Blame History Unescape Escape