上游 156k+ stars 的 superpowers 完整漢化 + 6 個(gè)中國原創(chuàng) skills。從頭腦風(fēng)暴到代碼審查,從 TDD 到調(diào)試,每個(gè) skill 都是經(jīng)過實(shí)戰(zhàn)驗(yàn)證的工作方法論。支持 Claude Code / Cursor / Copilot 等 16 種 AI 編程工具。
sp11.png
你讓 AI 寫代碼,它立刻動(dòng)手——然后你花兩小時(shí)改它的爛攤子。裝上這 20 個(gè) skills,AI 會(huì)先問你三個(gè)問題,再動(dòng)一行代碼。
[圖片上傳失敗...(image-abab5a-1776534902278)]
一、這個(gè)項(xiàng)目是什么?解決什么問題?
你有沒有遇到過這種情況:讓 AI 工具加個(gè)功能,它二話不說直接開始寫代碼,寫出來的東西格式不對(duì)、沒考慮邊界、大數(shù)據(jù)量直接 OOM?
問題的根源是:AI 工具知道怎么寫代碼,但不知道怎么干活。
superpowers-zh 解決的就是這個(gè)問題。它不是教 AI 某個(gè)框架怎么用,而是教它工作方法論——怎么先想清楚再動(dòng)手、怎么做 TDD、怎么系統(tǒng)化調(diào)試、怎么做代碼審查。
裝了和沒裝的區(qū)別
| | 沒裝 superpowers-zh | 裝了 superpowers-zh |
| 你說 | "給用戶模塊加個(gè)批量導(dǎo)出功能" | "給用戶模塊加個(gè)批量導(dǎo)出功能" |
| AI 做 | 直接寫代碼,沒分頁,大數(shù)據(jù)量 OOM | 先問:導(dǎo)出格式?數(shù)據(jù)量多大?需要異步處理嗎?給出 2-3 個(gè)方案,確認(rèn)后再動(dòng)手 |
| 結(jié)果 | 反復(fù)修改,浪費(fèi)時(shí)間 | 一次到位,質(zhì)量可控 |
項(xiàng)目來源
superpowers 是目前最火的 AI 編程 skills 框架(116k+ GitHub stars)。superpowers-zh 是它的中文社區(qū)版,在完整翻譯 14 個(gè) skills 的基礎(chǔ)上,新增了 6 個(gè)面向中國開發(fā)者的原創(chuàng) skills。
| 維度 | 數(shù)據(jù) |
| Skills 總數(shù) | 20 個(gè)(14 翻譯 + 6 原創(chuàng)) |
| 支持的 AI 工具 | 16 種 |
| 安裝方式 | npx superpowers-zh 一條命令 |
| 開源協(xié)議 | MIT(可商用) |
二、20 個(gè) Skills 全景地圖
這 20 個(gè) skills 覆蓋了軟件開發(fā)的完整生命周期,按用途可分為五大類。
第一類:需求與設(shè)計(jì)(動(dòng)手之前先想清楚)
| Skill | 中文名 | 做什么 |
| brainstorming | 頭腦風(fēng)暴 | 需求分析 → 方案對(duì)比 → 設(shè)計(jì)規(guī)格文檔。鐵律:設(shè)計(jì)批準(zhǔn)前不許寫一行代碼 |
| writing-plans | 編寫計(jì)劃 | 把設(shè)計(jì)規(guī)格拆成可執(zhí)行的實(shí)施步驟,每步 2-5 分鐘,不允許出現(xiàn)任何占位符 |
第二類:編碼與實(shí)現(xiàn)(按規(guī)矩辦事)
| Skill | 中文名 | 做什么 |
| executing-plans | 執(zhí)行計(jì)劃 | 按計(jì)劃逐步實(shí)施,每 3 個(gè)任務(wù)做一次檢查點(diǎn)審查 |
| test-driven-development | 測(cè)試驅(qū)動(dòng)開發(fā) | 鐵律:沒有失敗的測(cè)試,就不寫生產(chǎn)代碼。 先寫了代碼?刪掉,從頭來 |
| subagent-driven-development | 子 Agent 驅(qū)動(dòng)開發(fā) | 每個(gè)任務(wù)派遣獨(dú)立 agent 執(zhí)行,兩輪審查(規(guī)格合規(guī) + 代碼質(zhì)量) |
| dispatching-parallel-agents | 派遣并行 Agent | 多個(gè)獨(dú)立任務(wù)并發(fā)執(zhí)行,加速開發(fā) |
| using-git-worktrees | Git Worktree 使用 | 用 worktree 隔離特性開發(fā),不切分支 |
| finishing-a-development-branch | 完成開發(fā)分支 | 合并 / 推送 PR / 保留 / 丟棄四選一 |
第三類:質(zhì)量保障(不放過任何問題)
| Skill | 中文名 | 做什么 |
| systematic-debugging | 系統(tǒng)化調(diào)試 | 四階段法:根因定位 → 模式分析 → 假設(shè)驗(yàn)證 → 實(shí)施修復(fù)。鐵律:沒找到根因不許修 |
| requesting-code-review | 請(qǐng)求代碼審查 | 派遣代碼審查 agent 檢查提交質(zhì)量 |
| receiving-code-review | 接收代碼審查 | 技術(shù)嚴(yán)謹(jǐn)?shù)靥幚韺彶榉答?,拒絕敷衍式"說得好!" |
| verification-before-completion | 完成前驗(yàn)證 | 鐵律:聲稱完成前必須跑驗(yàn)證,拿出證據(jù)。 禁用"應(yīng)該沒問題""大概可以了" |
第四類:元技能與擴(kuò)展
| Skill | 中文名 | 做什么 |
| using-superpowers | 使用 Superpowers | 元技能:怎么發(fā)現(xiàn)和調(diào)用其他 skills,優(yōu)先級(jí)規(guī)則 |
| writing-skills | 編寫 Skills | 創(chuàng)建新 skill 的方法論 |
第五類:中國特色 Skills(6 個(gè)原創(chuàng))
| Skill | 中文名 | 做什么 |
| chinese-code-review | 中文代碼審查 | 平衡技術(shù)嚴(yán)謹(jǐn)和團(tuán)隊(duì)和諧。用建議而非命令,用提問而非否定。帶優(yōu)先級(jí)標(biāo)簽:[必須修復(fù)] [建議修改] [僅供參考] |
| chinese-git-workflow | 中文 Git 工作流 | 適配 Gitee / Coding / 極狐 GitLab,三種工作流模式(主干開發(fā) / Git Flow / 簡化混合) |
| chinese-documentation | 中文技術(shù)文檔 | 中文排版規(guī)范、中英混排規(guī)則、告別機(jī)翻味。哪些術(shù)語該翻譯、哪些不該翻譯 |
| chinese-commit-conventions | 中文提交規(guī)范 | feat(用戶模塊): 添加手機(jī)號(hào)一鍵登錄功能,type 用英文、scope 和 subject 用中文 |
| mcp-builder | MCP 服務(wù)器構(gòu)建 | 從設(shè)計(jì)到部署的完整 MCP 服務(wù)器構(gòu)建方法論 |
| workflow-runner | 工作流執(zhí)行器 | 在 AI 工具內(nèi)直接運(yùn)行 agency-orchestrator 的 YAML 多角色工作流,無需 API key |
三、安裝:一條命令搞定
方式一:npx 安裝(推薦)
cd /your/project
npx superpowers-zh
腳本會(huì)自動(dòng)檢測(cè)你項(xiàng)目中使用的 AI 工具(通過 .claude/、.cursor/、.codex/ 等目錄判斷),然后把 20 個(gè) skills 安裝到正確位置。
方式二:手動(dòng)安裝
# 克隆倉庫
git clone https://github.com/jnMetaCode/superpowers-zh.git
# 復(fù)制到你使用的工具目錄(選一個(gè))
cp -r superpowers-zh/skills /your/project/.claude/skills # Claude Code
cp -r superpowers-zh/skills /your/project/.cursor/skills # Cursor
cp -r superpowers-zh/skills /your/project/.hermes/skills # Hermes Agent
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/.windsurf/skills # Windsurf
cp -r superpowers-zh/skills /your/project/.gemini/skills # Gemini CLI
cp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)
cp -r superpowers-zh/skills /your/project/skills # OpenClaw
方式三:在配置文件中引用(按需加載)
如果你不想安裝全部 20 個(gè) skills,或者想精確控制哪些 skills 生效,可以在項(xiàng)目配置文件中手動(dòng)引用特定 skills。適合對(duì) AI 工具有定制化需求的團(tuán)隊(duì)。
在你的 CLAUDE.md 或 GEMINI.md 中添加引用:
@./skills/using-superpowers/SKILL.md
@./skills/brainstorming/SKILL.md
@./skills/test-driven-development/SKILL.md
和 npx 安裝的區(qū)別:npx 會(huì)把所有 20 個(gè) skills 復(fù)制到項(xiàng)目目錄;配置文件引用方式只加載你指定的 skills,更輕量。
安裝后驗(yàn)證
安裝成功后,在 AI 工具中輸入:
幫我加一個(gè)用戶批量導(dǎo)出功能
如果 AI 先提問、出方案、等你確認(rèn)再動(dòng)手(而不是直接寫代碼),說明 skills 已生效。
?? 建議插圖:安裝前后的 AI 對(duì)話對(duì)比截圖——左邊直接寫代碼,右邊先提問再動(dòng)手
四、核心工作流:從需求到上線
superpowers-zh 最大的價(jià)值不是單個(gè) skill,而是它定義了一個(gè)完整的開發(fā)工作流。以下是推薦的使用順序:
完整流程
用戶提需求
↓
① 頭腦風(fēng)暴(brainstorming)
→ 提出澄清問題,探索需求
→ 給出 2-3 個(gè)方案和權(quán)衡
→ 設(shè)計(jì)批準(zhǔn)后輸出規(guī)格文檔
↓
② 編寫計(jì)劃(writing-plans)
→ 把規(guī)格拆成原子級(jí)步驟
→ 每步 2-5 分鐘,代碼完整
↓
③ 執(zhí)行計(jì)劃(executing-plans)
→ 逐步實(shí)施,每 3 步審查
→ 遇到阻塞立即停止
↓
④ 測(cè)試驅(qū)動(dòng)開發(fā)(TDD)—— 貫穿③的每一步
→ 先寫失敗測(cè)試
→ 寫最少代碼讓測(cè)試通過
→ 重構(gòu)
↓
⑤ 請(qǐng)求代碼審查(requesting-code-review)
→ 派遣審查 agent
→ 按優(yōu)先級(jí)分類反饋
↓
⑥ 完成前驗(yàn)證(verification-before-completion)
→ 跑測(cè)試、lint、構(gòu)建
→ 拿出證據(jù)
↓
⑦ 完成開發(fā)分支(finishing-a-development-branch)
→ 合并 / 推送 PR / 保留 / 丟棄
流程中的三條鐵律
這三條規(guī)則沒有例外,AI 必須嚴(yán)格遵守:
鐵律 1:設(shè)計(jì)先行
頭腦風(fēng)暴的設(shè)計(jì)方案獲得用戶批準(zhǔn)之前,不許寫任何代碼、搭任何項(xiàng)目。哪怕是"簡單的"待辦事項(xiàng)列表也不行。
鐵律 2:測(cè)試先行
沒有失敗的測(cè)試,就不寫生產(chǎn)代碼。先寫了代碼再補(bǔ)測(cè)試?刪掉代碼,從測(cè)試開始重來。
鐵律 3:證據(jù)先行
聲稱任務(wù)完成之前,必須實(shí)際運(yùn)行驗(yàn)證命令并給出證據(jù)。禁止使用"應(yīng)該沒問題""大概可以了"這類措辭。
五、重點(diǎn) Skill 詳解
1. 頭腦風(fēng)暴(brainstorming)—— 最該用卻最常跳過的
觸發(fā)時(shí)機(jī): 任何創(chuàng)造性工作之前——?jiǎng)?chuàng)建功能、構(gòu)建組件、添加功能、修改行為。
完整流程(9 步檢查清單):
- 探索項(xiàng)目上下文 — 檢查文件、文檔、最近的 commit
- 提供視覺伴侶 — 如果主題涉及視覺問題(獨(dú)立消息)
- 提出澄清問題 — 每次一個(gè),了解目的/約束/成功標(biāo)準(zhǔn)
- 提出 2-3 種方案 — 附帶權(quán)衡分析和推薦
- 展示設(shè)計(jì) — 分節(jié)展示,每節(jié)獲得用戶批準(zhǔn)
- 編寫設(shè)計(jì)文檔 — 保存到
docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md - 規(guī)格自檢 — 檢查占位符、矛盾、模糊性
- 用戶審查規(guī)格
- 過渡到實(shí)現(xiàn) — 自動(dòng)調(diào)用 writing-plans
反模式防護(hù):
"這個(gè)太簡單了,不需要設(shè)計(jì)" —— 不行。每個(gè)項(xiàng)目都走這個(gè)流程。"簡單"的項(xiàng)目恰恰是未經(jīng)檢驗(yàn)的假設(shè)造成最多浪費(fèi)的地方。
?? 建議插圖:brainstorming 實(shí)際運(yùn)行截圖——AI 提出澄清問題、給出多個(gè)方案對(duì)比
2. 測(cè)試驅(qū)動(dòng)開發(fā)(TDD)—— 最嚴(yán)格的 Skill
紅-綠-重構(gòu)循環(huán):
紅(寫失敗測(cè)試)→ 綠(最少代碼讓測(cè)試通過)→ 重構(gòu)(清理代碼,測(cè)試保持通過)
↑ ↓
└──────────────────────────────────────────────────────────────┘
為什么必須先看到測(cè)試失???
如果你寫了一個(gè)測(cè)試,它直接就通過了,你怎么知道它測(cè)的是不是你想測(cè)的東西?可能它根本沒測(cè)到任何真實(shí)行為。先看到失敗,才能證明這個(gè)測(cè)試有意義。
14 種常見借口和反駁(Skill 內(nèi)置):
比如"這個(gè)太簡單了不需要測(cè)試"——越簡單越快寫測(cè)試,沒有理由跳過。
"時(shí)間緊"——不寫測(cè)試的技術(shù)債會(huì)讓你更慢。
適用范圍: 新功能、Bug 修復(fù)、重構(gòu)、行為變更。
僅有的例外(需要人類確認(rèn)): 一次性原型、生成的代碼、配置文件。
?? 建議插圖:TDD 紅-綠-重構(gòu)循環(huán)的終端截圖——先看到測(cè)試失敗(紅),再看到通過(綠)
3. 系統(tǒng)化調(diào)試(systematic-debugging)—— 告別"試試這個(gè)試試那個(gè)"
大多數(shù)人調(diào)試的方式:看到報(bào)錯(cuò) → 猜一個(gè)可能的原因 → 改代碼試試 → 不行再猜另一個(gè)。效率極低。
系統(tǒng)化調(diào)試的四階段法:
階段 1:根因定位
- 讀完整錯(cuò)誤信息 → 復(fù)現(xiàn)問題 → 檢查最近變更 → 收集證據(jù)
階段 2:模式分析
- 找到能正常工作的類似代碼 → 對(duì)比異同 → 縮小范圍
階段 3:假設(shè)與驗(yàn)證
- 形成單一假設(shè) → 設(shè)計(jì)最小測(cè)試 → 驗(yàn)證后再繼續(xù)
階段 4:實(shí)施修復(fù)
- 寫失敗測(cè)試 → 實(shí)施單一修復(fù) → 驗(yàn)證
鐵律: 沒有根因分析,不許直接修。最多嘗試 3 次修復(fù),3 次都失敗就要質(zhì)疑架構(gòu)而非代碼。
4. 中文代碼審查(chinese-code-review)—— 平衡嚴(yán)謹(jǐn)與和諧
解決的問題: 西方代碼審查風(fēng)格直接了當(dāng)("This is wrong, change it"),但在國內(nèi)團(tuán)隊(duì)中容易傷面子、影響協(xié)作。superpowers-zh 的中文代碼審查 skill 在保持技術(shù)嚴(yán)謹(jǐn)?shù)耐瑫r(shí),適配國內(nèi)團(tuán)隊(duì)文化。
核心原則: 用建議而非命令,用提問而非否定。
優(yōu)先級(jí)標(biāo)簽系統(tǒng):
| 標(biāo)簽 | 含義 | 處理方式 |
---------|
| [必須修復(fù)] | 影響功能/安全/性能的問題 | 必須修改才能合并 |
| [建議修改] | 有更好的寫法 | 建議修改,可討論 |
| [僅供參考] | 代碼風(fēng)格、個(gè)人偏好 | 知道就好 |
| [問題] | 不確定意圖 | 需要作者解釋 |
審查模板:
[建議修改] 并發(fā)處理可以優(yōu)化
這里用 sync.Mutex 保護(hù) map,但在讀多寫少的場(chǎng)景下,
使用 sync.RWMutex 可以顯著提升并發(fā)讀性能。
建議:將 sync.Mutex 替換為 sync.RWMutex,
讀操作使用 RLock(),寫操作使用 Lock()。
參考:https://pkg.go.dev/sync#RWMutex
反模式警示:
- 過度客氣導(dǎo)致掩蓋 Bug
- 對(duì)資深同事降低標(biāo)準(zhǔn)
- 在風(fēng)格問題上打口水仗
5. 中文提交規(guī)范(chinese-commit-conventions)
格式: <type>(<scope>): <subject>
type 用英文(方便工具解析),scope 和 subject 用中文(方便團(tuán)隊(duì)閱讀):
feat(用戶模塊): 添加手機(jī)號(hào)一鍵登錄功能
fix(訂單): 修復(fù)并發(fā)下單導(dǎo)致庫存超賣的問題
perf(搜索): 優(yōu)化商品搜索響應(yīng)時(shí)間從 800ms 降至 200ms
docs(API): 補(bǔ)充支付回調(diào)接口文檔
refactor(權(quán)限): 將 RBAC 權(quán)限校驗(yàn)抽取為獨(dú)立中間件
type 速查表:
| type | 含義 | 示例 |
------|
| feat | 新功能 | 添加微信登錄 |
| fix | Bug 修復(fù) | 修復(fù)超賣問題 |
| perf | 性能優(yōu)化 | 降低搜索延遲 |
| refactor | 重構(gòu) | 抽取中間件 |
| docs | 文檔 | 補(bǔ)充 API 文檔 |
| test | 測(cè)試 | 添加單元測(cè)試 |
| style | 格式 | 代碼風(fēng)格調(diào)整 |
| chore | 構(gòu)建/工具 | 升級(jí)依賴版本 |
| ci | CI/CD | 修改流水線配置 |
| revert | 回退 | 回退某次提交 |
還內(nèi)置了 commitlint + husky 配置,可以直接復(fù)制使用。
6. 工作流執(zhí)行器(workflow-runner)
做什么: 在 Claude Code / Cursor / OpenClaw 中直接運(yùn)行 agency-orchestrator 的 YAML 工作流。無需 API key,當(dāng)前 LLM 就是執(zhí)行引擎。
示例: 一個(gè)產(chǎn)品評(píng)審工作流
name: product-review
agents_dir: agency-agents-zh
inputs:
- name: prd_path
required: true
steps:
- id: pm_review
role: "product/product-manager"
task: "審查 {{prd_path}} 這份 PRD,輸出改進(jìn)建議"
output: pm_feedback
- id: arch_review
role: "engineering/engineering-backend-architect"
task: "基于 PRD 和產(chǎn)品經(jīng)理反饋 {{pm_feedback}},評(píng)估技術(shù)可行性"
output: arch_assessment
depends_on: [pm_review]
AI 會(huì)依次扮演產(chǎn)品經(jīng)理和后端架構(gòu)師,讀取對(duì)應(yīng)角色的 .md 定義文件,以該角色的專業(yè)視角完成任務(wù)。
快速模式: 如果你沒有 YAML 文件,直接描述需求,AI 會(huì)自動(dòng)生成工作流并執(zhí)行。
六、與上游英文版的對(duì)比
| 特性 | superpowers(英文) | superpowers-zh(中文) |
|------|-------------------|----------------------|
| Skills 數(shù)量 | 14 | 20(14 翻譯 + 6 原創(chuàng)) |
| 語言 | 英文 | 中文(技術(shù)術(shù)語保留英文) |
| 代碼審查規(guī)范 | 西方直接風(fēng)格 | 適配國內(nèi)團(tuán)隊(duì)溝通文化 |
| Git 平臺(tái) | GitHub 為主 | GitHub + Gitee + Coding + 極狐 GitLab |
| Git 提交規(guī)范 | 無 | Conventional Commits 中文適配 |
| 文檔規(guī)范 | 英文 | 中文排版規(guī)范 + 中英混排 |
| MCP 構(gòu)建 | 無 | MCP 服務(wù)器構(gòu)建方法論 |
| 工作流編排 | 無 | 多角色 YAML 工作流執(zhí)行器 |
七、16 種工具的安裝方式
| 工具 | 類型 | 安裝命令 | Skills 目錄 |
---------|------------|
| Claude Code | CLI | npx superpowers-zh | .claude/skills/ |
| Copilot CLI | CLI | npx superpowers-zh --tool copilot | .claude/skills/ |
| Hermes Agent | CLI | npx superpowers-zh --tool hermes | .hermes/skills/ |
| Cursor | IDE | npx superpowers-zh | .cursor/skills/ |
| Windsurf | IDE | npx superpowers-zh | .windsurf/skills/ |
| Kiro | IDE | npx superpowers-zh | .kiro/steering/ |
| Gemini CLI | CLI | npx superpowers-zh | .gemini/skills/ |
| Codex CLI | CLI | npx superpowers-zh | .codex/skills/ |
| Aider | CLI | npx superpowers-zh | .aider/skills/ |
| Trae | IDE | npx superpowers-zh | .trae/skills/ |
| VS Code (Copilot) | IDE | npx superpowers-zh | .github/superpowers/ |
| DeerFlow 2.0 | 框架 | npx superpowers-zh | skills/custom/ |
| OpenCode | CLI | npx superpowers-zh | .opencode/skills/ |
| OpenClaw | CLI | npx superpowers-zh | skills/ |
| Qwen Code | IDE | npx superpowers-zh | .qwen/skills/ |
| Antigravity | CLI | npx superpowers-zh | .antigravity/skills/ |
npx superpowers-zh會(huì)自動(dòng)檢測(cè)項(xiàng)目中使用的工具并安裝到正確位置。
八、實(shí)戰(zhàn)使用場(chǎng)景
場(chǎng)景 1:從零開發(fā)一個(gè)新功能
你:我要給后臺(tái)管理系統(tǒng)加一個(gè)操作日志功能
→ 自動(dòng)觸發(fā) brainstorming:
AI 問:記錄哪些操作?需要搜索/篩選嗎?保留多久?
AI 給出 2 個(gè)方案:數(shù)據(jù)庫存儲(chǔ) vs 日志服務(wù)
你選方案 1,AI 輸出規(guī)格文檔
→ 自動(dòng)觸發(fā) writing-plans:
AI 把規(guī)格拆成 8 個(gè)步驟,每步代碼完整
→ 自動(dòng)觸發(fā) executing-plans + TDD:
每個(gè)步驟先寫測(cè)試,再寫代碼,每 3 步檢查一次
→ 自動(dòng)觸發(fā) requesting-code-review:
AI 派遣審查 agent,按 [必須修復(fù)]/[建議修改]/[僅供參考] 分級(jí)反饋
→ 自動(dòng)觸發(fā) verification-before-completion:
跑測(cè)試、lint、構(gòu)建,全部通過
場(chǎng)景 2:修一個(gè)復(fù)雜 Bug
你:線上用戶反饋并發(fā)下單時(shí)偶爾出現(xiàn)庫存超賣
→ 自動(dòng)觸發(fā) systematic-debugging:
階段 1(根因定位):
- 讀完整錯(cuò)誤日志和用戶反饋
- 復(fù)現(xiàn)問題:模擬并發(fā)請(qǐng)求
- 檢查最近 3 天的庫存相關(guān) commit
階段 2(模式分析):
- 找到其他已正確處理并發(fā)的模塊
- 對(duì)比發(fā)現(xiàn):庫存扣減沒有用數(shù)據(jù)庫鎖
階段 3(假設(shè)驗(yàn)證):
- 假設(shè):缺少 SELECT FOR UPDATE 導(dǎo)致并發(fā)讀到臟數(shù)據(jù)
- 最小測(cè)試:寫并發(fā)測(cè)試驗(yàn)證假設(shè)
階段 4(修復(fù)):
- 先寫失敗的并發(fā)測(cè)試
- 添加行級(jí)鎖,測(cè)試通過
場(chǎng)景 3:用工作流執(zhí)行器做產(chǎn)品評(píng)審
前置條件: 這個(gè)場(chǎng)景需要同時(shí)安裝 agency-agents-zh(提供角色定義文件)。安裝方式見上一篇教程,或直接運(yùn)行
npx agency-agents-zh。
你:運(yùn)行 workflows/product-review.yaml,PRD 路徑是 docs/prd-v2.md
→ workflow-runner 讀取 YAML,發(fā)現(xiàn)兩個(gè)步驟:
1. 產(chǎn)品經(jīng)理審查 PRD
2. 后端架構(gòu)師評(píng)估技術(shù)可行性(依賴步驟 1 的輸出)
→ AI 讀取 product-manager.md 角色定義,以產(chǎn)品經(jīng)理視角審查 PRD
→ 輸出改進(jìn)建議
→ AI 讀取 backend-architect.md 角色定義,結(jié)合 PM 反饋評(píng)估可行性
→ 輸出技術(shù)評(píng)估報(bào)告
→ 所有輸出保存到 .ao-output/product-review-2026-04-18/
九、實(shí)用技巧
1. Skills 的自動(dòng)觸發(fā)
安裝后你不需要手動(dòng)調(diào)用 skill 名稱。Skills 有自動(dòng)觸發(fā)規(guī)則——當(dāng) AI 檢測(cè)到你的請(qǐng)求匹配某個(gè) skill 的適用場(chǎng)景時(shí),會(huì)自動(dòng)加載執(zhí)行。
例如:
- 你說"加個(gè)功能" → 自動(dòng)觸發(fā) brainstorming
- 你說"這個(gè) Bug 怎么修" → 自動(dòng)觸發(fā) systematic-debugging
- 你說"幫我審查一下代碼" → 自動(dòng)觸發(fā) requesting-code-review
元技能規(guī)則(using-superpowers): 只要有 1% 的可能性某個(gè) skill 適用,就必須調(diào)用它。
2. 設(shè)計(jì)文檔和計(jì)劃的存儲(chǔ)位置
- 設(shè)計(jì)規(guī)格:
docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md - 實(shí)施計(jì)劃:
docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md
這些文件會(huì)被 git commit,形成項(xiàng)目的決策記錄。
3. 中英混排術(shù)語規(guī)則(chinese-documentation skill)
不翻譯的術(shù)語: React、Kubernetes、Redis、MySQL、API、SDK、CLI、debounce、throttle
要翻譯的術(shù)語: 版本控制、框架、數(shù)據(jù)庫、服務(wù)器
首次出現(xiàn)格式: 中文(English),如"模型上下文協(xié)議(Model Context Protocol)"
排版規(guī)則: 中文與英文/數(shù)字之間加空格,中文用全角標(biāo)點(diǎn),代碼塊內(nèi)用半角標(biāo)點(diǎn)。
4. 自定義或添加 Skill
每個(gè) skill 都是一個(gè)目錄,包含一個(gè) SKILL.md 文件。你可以:
- 修改現(xiàn)有 skill 的規(guī)則以適應(yīng)你團(tuán)隊(duì)的習(xí)慣
- 參考
writing-skills技能創(chuàng)建全新的 skill - 通過 PR 貢獻(xiàn)給社區(qū)
Skill 文件格式:
---
name: your-skill-name
description: "觸發(fā)條件描述"
---
# Skill 標(biāo)題
## 何時(shí)使用
## 流程
## 鐵律
## 反模式
十、常見問題
Q:和 agency-agents-zh 有什么關(guān)系?
A:互補(bǔ)關(guān)系。agency-agents-zh 提供 211 個(gè)專業(yè)角色定義(前端開發(fā)者、安全工程師、小紅書運(yùn)營等),superpowers-zh 提供 20 個(gè)工作方法論(TDD、調(diào)試、代碼審查等)??梢酝瑫r(shí)安裝,互不沖突。workflow-runner skill 可以調(diào)用 agency-agents-zh 的角色來執(zhí)行多角色工作流。
Q:每個(gè)項(xiàng)目都要安裝一遍嗎?
A:是的,skills 安裝在項(xiàng)目目錄下(如 .claude/skills/),是項(xiàng)目級(jí)的。這樣不同項(xiàng)目可以有不同的 skills 配置。
Q:會(huì)影響 AI 的響應(yīng)速度嗎?
A:Skills 只在匹配時(shí)加載,不會(huì)預(yù)加載所有 20 個(gè)。對(duì)響應(yīng)速度影響很小。
Q:可以只安裝部分 skills 嗎?
A:可以。手動(dòng)復(fù)制你需要的 skill 目錄即可。比如只要 TDD 和調(diào)試:
cp -r superpowers-zh/skills/test-driven-development .claude/skills/
cp -r superpowers-zh/skills/systematic-debugging .claude/skills/
Q:支持 Windows 嗎?
A:支持。npx superpowers-zh 在 Windows / macOS / Linux 上都能運(yùn)行,只需要安裝 Node.js(建議 v18+)。Skills 本身是 Markdown 文件,跨平臺(tái)無障礙。
Q:和上游英文版沖突嗎?
A:不沖突。superpowers-zh 是獨(dú)立的中文版本,文件名和目錄結(jié)構(gòu)與上游一致但內(nèi)容是中文。不建議同時(shí)安裝兩個(gè)版本。
總結(jié)
superpowers-zh 不是讓 AI "更聰明",而是讓 AI "更靠譜":
- 20 個(gè)經(jīng)過實(shí)戰(zhàn)驗(yàn)證的工作方法論,覆蓋從需求到上線的完整流程
- 三條鐵律(設(shè)計(jì)先行、測(cè)試先行、證據(jù)先行),杜絕 AI 一上來就寫代碼
- 6 個(gè)中國特色 skills,適配國內(nèi)團(tuán)隊(duì)文化、平臺(tái)和工具鏈
- 16 種 AI 工具支持,一條命令安裝
- 上游 116k+ stars 的方法論沉淀,不是憑空造輪子
一條命令開始使用:
cd /your/project
npx superpowers-zh
然后像往常一樣和 AI 對(duì)話。你會(huì)發(fā)現(xiàn)它不再急著寫代碼了——它會(huì)先問你幾個(gè)問題。
十一、社區(qū)與資源
社區(qū)
- 關(guān)注 AI不止語
- 1071280067
- GitHub:github.com/jnMetaCode/superpowers-zh
相關(guān)項(xiàng)目
| 項(xiàng)目 | 說明 |
| agency-agents-zh | 211 個(gè) AI 專家角色,覆蓋 18 個(gè)部門,一鍵安裝 |
| agency-orchestrator | 一句話調(diào)度多個(gè) AI 專家自動(dòng)協(xié)作,幾分鐘交付完整方案 |
| ai-coding-guide | AI 編程 學(xué)習(xí)實(shí)戰(zhàn)指南 — 66 個(gè) Claude Code 技巧 + 9 款工具最佳實(shí)踐 |
| shellward | AI 智能體安全中間件 — 注入檢測(cè)、數(shù)據(jù)防泄露、命令安全 |
覺得有用?
- 給個(gè) Star → github.com/jnMetaCode/superpowers-zh
- 轉(zhuǎn)發(fā)給同事 → 團(tuán)隊(duì)一起裝,效果更好
*本文介紹的 superpowers-zh 項(xiàng)目基于 MIT 開源協(xié)議,GitHub 倉庫:github.com/jnMetaCode/superpowers-zh
