20 個(gè) AI 編程超能力,讓你的 AI 工具真正會(huì)干活:superpowers-zh 詳細(xì)使用教程

上游 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.mdGEMINI.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 步檢查清單):

  1. 探索項(xiàng)目上下文 — 檢查文件、文檔、最近的 commit
  2. 提供視覺伴侶 — 如果主題涉及視覺問題(獨(dú)立消息)
  3. 提出澄清問題 — 每次一個(gè),了解目的/約束/成功標(biāo)準(zhǔn)
  4. 提出 2-3 種方案 — 附帶權(quán)衡分析和推薦
  5. 展示設(shè)計(jì) — 分節(jié)展示,每節(jié)獲得用戶批準(zhǔn)
  6. 編寫設(shè)計(jì)文檔 — 保存到 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md
  7. 規(guī)格自檢 — 檢查占位符、矛盾、模糊性
  8. 用戶審查規(guī)格
  9. 過渡到實(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

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容