乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > 20 个 AI 编程超能力,让你的 AI 工具真正会干活:superpowers-zh 完全使用教程

20 个 AI 编程超能力,让你的 AI 工具真正会干活:superpowers-zh 完全使用教程

当前时间： 2026-04-19 01:36:00 更新时间： 2026-04-19 分类：软件教程 评论(0)

20 个 AI 编程超能力,让你的 AI 工具真正会干活:superpowers-zh 完全使用教程

上游 156k+ stars 的 superpowers 完整汉化 + 6 个中国原创 skills。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。支持 Claude Code / Cursor / Copilot 等 16 种 AI 编程工具。

你让 AI 写代码，它立刻动手——然后你花两小时改它的烂摊子。装上这 20 个 skills，AI 会先问你三个问题，再动一行代码。

一、这个项目是什么？解决什么问题？

你有没有遇到过这种情况：让 AI 工具加个功能，它二话不说直接开始写代码，写出来的东西格式不对、没考虑边界、大数据量直接 OOM？

问题的根源是：AI 工具知道怎么写代码，但不知道怎么干活。

superpowers-zh 解决的就是这个问题。它不是教 AI 某个框架怎么用，而是教它工作方法论——怎么先想清楚再动手、怎么做 TDD、怎么系统化调试、怎么做代码审查。

装了和没装的区别

| | 没装 superpowers-zh | 装了 superpowers-zh |

| 你说 | “给用户模块加个批量导出功能” | “给用户模块加个批量导出功能” |

| AI 做 | 直接写代码，没分页，大数据量 OOM | 先问：导出格式？数据量多大？需要异步处理吗？给出 2-3 个方案，确认后再动手 |

| 结果 | 反复修改，浪费时间 | 一次到位，质量可控 |

项目来源

superpowers 是目前最火的 AI 编程 skills 框架（116k+ GitHub stars）。superpowers-zh 是它的中文社区版，在完整翻译 14 个 skills 的基础上，新增了 6 个面向中国开发者的原创 skills。

| 维度 | 数据 |

| Skills 总数 | 20 个（14 翻译 + 6 原创） |

| 支持的 AI 工具 | 16 种 |

| 安装方式 | npx superpowers-zh 一条命令 |

| 开源协议 | MIT（可商用） |

二、20 个 Skills 全景地图

这 20 个 skills 覆盖了软件开发的完整生命周期，按用途可分为五大类。

第一类：需求与设计（动手之前先想清楚）

| Skill | 中文名 | 做什么 |

| brainstorming | 头脑风暴 | 需求分析 → 方案对比 → 设计规格文档。铁律：设计批准前不许写一行代码 |

| writing-plans | 编写计划 | 把设计规格拆成可执行的实施步骤，每步 2-5 分钟，不允许出现任何占位符 |

第二类：编码与实现（按规矩办事）

| Skill | 中文名 | 做什么 |

| executing-plans | 执行计划 | 按计划逐步实施，每 3 个任务做一次检查点审查 |

| test-driven-development | 测试驱动开发 | 铁律：没有失败的测试，就不写生产代码。 先写了代码？删掉，从头来 |

| subagent-driven-development | 子 Agent 驱动开发 | 每个任务派遣独立 agent 执行，两轮审查（规格合规 + 代码质量） |

| dispatching-parallel-agents | 派遣并行 Agent | 多个独立任务并发执行，加速开发 |

| using-git-worktrees | Git Worktree 使用 | 用 worktree 隔离特性开发，不切分支 |

| finishing-a-development-branch | 完成开发分支 | 合并 / 推送 PR / 保留 / 丢弃四选一 |

第三类：质量保障（不放过任何问题）

| Skill | 中文名 | 做什么 |

| systematic-debugging | 系统化调试 | 四阶段法：根因定位 → 模式分析 → 假设验证 → 实施修复。铁律：没找到根因不许修 |

| requesting-code-review | 请求代码审查 | 派遣代码审查 agent 检查提交质量 |

| receiving-code-review | 接收代码审查 | 技术严谨地处理审查反馈，拒绝敷衍式”说得好！” |

| verification-before-completion | 完成前验证 | 铁律：声称完成前必须跑验证，拿出证据。 禁用”应该没问题”“大概可以了” |

第四类：元技能与扩展

| Skill | 中文名 | 做什么 |

| using-superpowers | 使用 Superpowers | 元技能：怎么发现和调用其他 skills，优先级规则 |

| writing-skills | 编写 Skills | 创建新 skill 的方法论 |

第五类：中国特色 Skills（6 个原创）

| Skill | 中文名 | 做什么 |

| chinese-code-review | 中文代码审查 | 平衡技术严谨和团队和谐。用建议而非命令，用提问而非否定。带优先级标签：[必须修复] [建议修改] [仅供参考] |

| chinese-git-workflow | 中文 Git 工作流 | 适配 Gitee / Coding / 极狐 GitLab，三种工作流模式（主干开发 / Git Flow / 简化混合） |

| chinese-documentation | 中文技术文档 | 中文排版规范、中英混排规则、告别机翻味。哪些术语该翻译、哪些不该翻译 |

| chinese-commit-conventions | 中文提交规范 | feat(用户模块): 添加手机号一键登录功能，type 用英文、scope 和 subject 用中文 |

| mcp-builder | MCP 服务器构建 | 从设计到部署的完整 MCP 服务器构建方法论 |

| workflow-runner | 工作流执行器 | 在 AI 工具内直接运行 agency-orchestrator 的 YAML 多角色工作流，无需 API key |

三、安装：一条命令搞定

方式一：npx 安装（推荐）

cd /your/projectnpx superpowers-zh

脚本会自动检测你项目中使用的 AI 工具（通过 .claude/、.cursor/、.codex/ 等目录判断），然后把 20 个 skills 安装到正确位置。

方式二：手动安装

# 克隆仓库git clone https://github.com/jnMetaCode/superpowers-zh.git# 复制到你使用的工具目录（选一个）cp -r superpowers-zh/skills /your/project/.claude/skills      # Claude Codecp -r superpowers-zh/skills /your/project/.cursor/skills      # Cursorcp -r superpowers-zh/skills /your/project/.hermes/skills      # Hermes Agentcp -r superpowers-zh/skills /your/project/.codex/skills       # Codex CLIcp -r superpowers-zh/skills /your/project/.kiro/steering      # Kirocp -r superpowers-zh/skills /your/project/.windsurf/skills    # Windsurfcp -r superpowers-zh/skills /your/project/.gemini/skills      # Gemini CLIcp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)cp -r superpowers-zh/skills /your/project/skills              # OpenClaw

方式三：在配置文件中引用（按需加载）

如果你不想安装全部 20 个 skills，或者想精确控制哪些 skills 生效，可以在项目配置文件中手动引用特定 skills。适合对 AI 工具有定制化需求的团队。

在你的 CLAUDE.md 或 GEMINI.md 中添加引用：

@./skills/using-superpowers/SKILL.md@./skills/brainstorming/SKILL.md@./skills/test-driven-development/SKILL.md

和 npx 安装的区别：npx 会把所有 20 个 skills 复制到项目目录；配置文件引用方式只加载你指定的 skills，更轻量。

安装后验证

安装成功后，在 AI 工具中输入：

帮我加一个用户批量导出功能

如果 AI 先提问、出方案、等你确认再动手（而不是直接写代码），说明 skills 已生效。

📸 建议插图：安装前后的 AI 对话对比截图——左边直接写代码，右边先提问再动手

四、核心工作流：从需求到上线

superpowers-zh 最大的价值不是单个 skill，而是它定义了一个完整的开发工作流。以下是推荐的使用顺序：

完整流程

用户提需求    ↓① 头脑风暴（brainstorming）    → 提出澄清问题，探索需求    → 给出 2-3 个方案和权衡    → 设计批准后输出规格文档    ↓② 编写计划（writing-plans）    → 把规格拆成原子级步骤    → 每步 2-5 分钟，代码完整    ↓③ 执行计划（executing-plans）    → 逐步实施，每 3 步审查    → 遇到阻塞立即停止    ↓④ 测试驱动开发（TDD）—— 贯穿③的每一步    → 先写失败测试    → 写最少代码让测试通过    → 重构    ↓⑤ 请求代码审查（requesting-code-review）    → 派遣审查 agent    → 按优先级分类反馈    ↓⑥ 完成前验证（verification-before-completion）    → 跑测试、lint、构建    → 拿出证据    ↓⑦ 完成开发分支（finishing-a-development-branch）    → 合并 / 推送 PR / 保留 / 丢弃

流程中的三条铁律

这三条规则没有例外，AI 必须严格遵守：

铁律 1：设计先行

头脑风暴的设计方案获得用户批准之前，不许写任何代码、搭任何项目。哪怕是”简单的”待办事项列表也不行。

铁律 2：测试先行

没有失败的测试，就不写生产代码。先写了代码再补测试？删掉代码，从测试开始重来。

铁律 3：证据先行

声称任务完成之前，必须实际运行验证命令并给出证据。禁止使用”应该没问题””大概可以了”这类措辞。

五、重点 Skill 详解

1. 头脑风暴（brainstorming）—— 最该用却最常跳过的

触发时机： 任何创造性工作之前——创建功能、构建组件、添加功能、修改行为。

完整流程（9 步检查清单）：

  1. 探索项目上下文 — 检查文件、文档、最近的 commit
  2. 提供视觉伴侣 — 如果主题涉及视觉问题（独立消息）
  3. 提出澄清问题 — 每次一个，了解目的/约束/成功标准
  4. 提出 2-3 种方案 — 附带权衡分析和推荐
  5. 展示设计 — 分节展示，每节获得用户批准
  6. 编写设计文档 — 保存到 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md
  7. 规格自检 — 检查占位符、矛盾、模糊性
  8. 用户审查规格
  9. 过渡到实现 — 自动调用 writing-plans

反模式防护：

“这个太简单了，不需要设计” —— 不行。每个项目都走这个流程。”简单”的项目恰恰是未经检验的假设造成最多浪费的地方。

📸 建议插图：brainstorming 实际运行截图——AI 提出澄清问题、给出多个方案对比

2. 测试驱动开发（TDD）—— 最严格的 Skill

红-绿-重构循环：

红（写失败测试）→ 绿（最少代码让测试通过）→ 重构（清理代码，测试保持通过）    ↑                                                              ↓    └──────────────────────────────────────────────────────────────┘

为什么必须先看到测试失败？

如果你写了一个测试，它直接就通过了，你怎么知道它测的是不是你想测的东西？可能它根本没测到任何真实行为。先看到失败，才能证明这个测试有意义。

14 种常见借口和反驳（Skill 内置）：

比如”这个太简单了不需要测试”——越简单越快写测试，没有理由跳过。

“时间紧”——不写测试的技术债会让你更慢。

适用范围： 新功能、Bug 修复、重构、行为变更。

仅有的例外（需要人类确认）： 一次性原型、生成的代码、配置文件。

📸 建议插图：TDD 红-绿-重构循环的终端截图——先看到测试失败（红），再看到通过（绿）

3. 系统化调试（systematic-debugging）—— 告别”试试这个试试那个”

大多数人调试的方式：看到报错 → 猜一个可能的原因 → 改代码试试 → 不行再猜另一个。效率极低。

系统化调试的四阶段法：

阶段 1：根因定位

  • 读完整错误信息 → 复现问题 → 检查最近变更 → 收集证据

阶段 2：模式分析

  • 找到能正常工作的类似代码 → 对比异同 → 缩小范围

阶段 3：假设与验证

  • 形成单一假设 → 设计最小测试 → 验证后再继续

阶段 4：实施修复

  • 写失败测试 → 实施单一修复 → 验证

铁律： 没有根因分析，不许直接修。最多尝试 3 次修复，3 次都失败就要质疑架构而非代码。

4. 中文代码审查（chinese-code-review）—— 平衡严谨与和谐

解决的问题： 西方代码审查风格直接了当（“This is wrong, change it”），但在国内团队中容易伤面子、影响协作。superpowers-zh 的中文代码审查 skill 在保持技术严谨的同时，适配国内团队文化。

核心原则： 用建议而非命令，用提问而非否定。

优先级标签系统：

| 标签 | 含义 | 处理方式 |

———|

| [必须修复] | 影响功能/安全/性能的问题 | 必须修改才能合并 |

| [建议修改] | 有更好的写法 | 建议修改，可讨论 |

| [仅供参考] | 代码风格、个人偏好 | 知道就好 |

| [问题] | 不确定意图 | 需要作者解释 |

审查模板：

[建议修改] 并发处理可以优化这里用 sync.Mutex 保护 map，但在读多写少的场景下，使用 sync.RWMutex 可以显著提升并发读性能。建议：将 sync.Mutex 替换为 sync.RWMutex，读操作使用 RLock()，写操作使用 Lock()。参考：https://pkg.go.dev/sync#RWMutex

反模式警示：

  • 过度客气导致掩盖 Bug
  • 对资深同事降低标准
  • 在风格问题上打口水仗

5. 中文提交规范（chinese-commit-conventions）

格式：<type>(<scope>): <subject>

type 用英文（方便工具解析），scope 和 subject 用中文（方便团队阅读）：

feat(用户模块): 添加手机号一键登录功能fix(订单): 修复并发下单导致库存超卖的问题perf(搜索): 优化商品搜索响应时间从 800ms 降至 200msdocs(API): 补充支付回调接口文档refactor(权限): 将 RBAC 权限校验抽取为独立中间件

type 速查表：

| type | 含义 | 示例 |

——|

| feat | 新功能 | 添加微信登录 |

| fix | Bug 修复 | 修复超卖问题 |

| perf | 性能优化 | 降低搜索延迟 |

| refactor | 重构 | 抽取中间件 |

| docs | 文档 | 补充 API 文档 |

| test | 测试 | 添加单元测试 |

| style | 格式 | 代码风格调整 |

| chore | 构建/工具 | 升级依赖版本 |

| ci | CI/CD | 修改流水线配置 |

| revert | 回退 | 回退某次提交 |

还内置了 commitlint + husky 配置，可以直接复制使用。

6. 工作流执行器（workflow-runner）

做什么： 在 Claude Code / Cursor / OpenClaw 中直接运行 agency-orchestrator 的 YAML 工作流。无需 API key，当前 LLM 就是执行引擎。

示例： 一个产品评审工作流

name: product-reviewagents_dir: agency-agents-zhinputs:  - name: prd_path    required: truesteps:  - id: pm_review    role: "product/product-manager"    task: "审查 {{prd_path}} 这份 PRD，输出改进建议"    output: pm_feedback  - id: arch_review    role: "engineering/engineering-backend-architect"    task: "基于 PRD 和产品经理反馈 {{pm_feedback}}，评估技术可行性"    output: arch_assessment    depends_on: [pm_review]

AI 会依次扮演产品经理和后端架构师，读取对应角色的 .md 定义文件，以该角色的专业视角完成任务。

快速模式： 如果你没有 YAML 文件，直接描述需求，AI 会自动生成工作流并执行。

六、与上游英文版的对比

| 特性 | superpowers（英文） | superpowers-zh（中文） |

|——|——————-|———————-|

| Skills 数量 | 14 | 20（14 翻译 + 6 原创） |

| 语言 | 英文 | 中文（技术术语保留英文） |

| 代码审查规范 | 西方直接风格 | 适配国内团队沟通文化 |

| Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 GitLab |

| Git 提交规范 | 无 | Conventional Commits 中文适配 |

| 文档规范 | 英文 | 中文排版规范 + 中英混排 |

| MCP 构建 | 无 | MCP 服务器构建方法论 |

| 工作流编排 | 无 | 多角色 YAML 工作流执行器 |

七、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 会自动检测项目中使用的工具并安装到正确位置。

八、实战使用场景

场景 1：从零开发一个新功能

你：我要给后台管理系统加一个操作日志功能→ 自动触发 brainstorming：  AI 问：记录哪些操作？需要搜索/筛选吗？保留多久？  AI 给出 2 个方案：数据库存储 vs 日志服务  你选方案 1，AI 输出规格文档→ 自动触发 writing-plans：  AI 把规格拆成 8 个步骤，每步代码完整→ 自动触发 executing-plans + TDD：  每个步骤先写测试，再写代码，每 3 步检查一次→ 自动触发 requesting-code-review：  AI 派遣审查 agent，按 [必须修复]/[建议修改]/[仅供参考] 分级反馈→ 自动触发 verification-before-completion：  跑测试、lint、构建，全部通过

场景 2：修一个复杂 Bug

你：线上用户反馈并发下单时偶尔出现库存超卖→ 自动触发 systematic-debugging：  阶段 1（根因定位）：  - 读完整错误日志和用户反馈  - 复现问题：模拟并发请求  - 检查最近 3 天的库存相关 commit  阶段 2（模式分析）：  - 找到其他已正确处理并发的模块  - 对比发现：库存扣减没有用数据库锁  阶段 3（假设验证）：  - 假设：缺少 SELECT FOR UPDATE 导致并发读到脏数据  - 最小测试：写并发测试验证假设  阶段 4（修复）：  - 先写失败的并发测试  - 添加行级锁，测试通过

场景 3：用工作流执行器做产品评审

前置条件： 这个场景需要同时安装 agency-agents-zh（提供角色定义文件）。安装方式见上一篇教程，或直接运行 npx agency-agents-zh。

你：运行 workflows/product-review.yaml，PRD 路径是 docs/prd-v2.md→ workflow-runner 读取 YAML，发现两个步骤：  1. 产品经理审查 PRD  2. 后端架构师评估技术可行性（依赖步骤 1 的输出）→ AI 读取 product-manager.md 角色定义，以产品经理视角审查 PRD→ 输出改进建议→ AI 读取 backend-architect.md 角色定义，结合 PM 反馈评估可行性→ 输出技术评估报告→ 所有输出保存到 .ao-output/product-review-2026-04-18/

九、实用技巧

1. Skills 的自动触发

安装后你不需要手动调用 skill 名称。Skills 有自动触发规则——当 AI 检测到你的请求匹配某个 skill 的适用场景时，会自动加载执行。

例如：

  • 你说”加个功能” → 自动触发 brainstorming
  • 你说”这个 Bug 怎么修” → 自动触发 systematic-debugging
  • 你说”帮我审查一下代码” → 自动触发 requesting-code-review

元技能规则（using-superpowers）： 只要有 1% 的可能性某个 skill 适用，就必须调用它。

2. 设计文档和计划的存储位置

  • 设计规格：docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md
  • 实施计划：docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md

这些文件会被 git commit，形成项目的决策记录。

3. 中英混排术语规则（chinese-documentation skill）

不翻译的术语： React、Kubernetes、Redis、MySQL、API、SDK、CLI、debounce、throttle

要翻译的术语： 版本控制、框架、数据库、服务器

首次出现格式： 中文（English），如”模型上下文协议（Model Context Protocol）”

排版规则： 中文与英文/数字之间加空格，中文用全角标点，代码块内用半角标点。

4. 自定义或添加 Skill

每个 skill 都是一个目录，包含一个 SKILL.md 文件。你可以：

  • 修改现有 skill 的规则以适应你团队的习惯
  • 参考 writing-skills 技能创建全新的 skill
  • 通过 PR 贡献给社区

Skill 文件格式：

---name: your-skill-namedescription: "触发条件描述"---# Skill 标题## 何时使用## 流程## 铁律## 反模式

十、常见问题

Q：和 agency-agents-zh 有什么关系？

A：互补关系。agency-agents-zh 提供 211 个专业角色定义（前端开发者、安全工程师、小红书运营等），superpowers-zh 提供 20 个工作方法论（TDD、调试、代码审查等）。可以同时安装，互不冲突。workflow-runner skill 可以调用 agency-agents-zh 的角色来执行多角色工作流。

Q：每个项目都要安装一遍吗？

A：是的，skills 安装在项目目录下（如 .claude/skills/），是项目级的。这样不同项目可以有不同的 skills 配置。

Q：会影响 AI 的响应速度吗？

A：Skills 只在匹配时加载，不会预加载所有 20 个。对响应速度影响很小。

Q：可以只安装部分 skills 吗？

A：可以。手动复制你需要的 skill 目录即可。比如只要 TDD 和调试：

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 上都能运行，只需要安装 Node.js（建议 v18+）。Skills 本身是 Markdown 文件，跨平台无障碍。

Q：和上游英文版冲突吗？

A：不冲突。superpowers-zh 是独立的中文版本，文件名和目录结构与上游一致但内容是中文。不建议同时安装两个版本。

总结

superpowers-zh 不是让 AI “更聪明”，而是让 AI “更靠谱”：

  • 20 个经过实战验证的工作方法论
    ，覆盖从需求到上线的完整流程
  • 三条铁律
    （设计先行、测试先行、证据先行），杜绝 AI 一上来就写代码
  • 6 个中国特色 skills
    ，适配国内团队文化、平台和工具链
  • 16 种 AI 工具支持
    ，一条命令安装
  • 上游 116k+ stars 的方法论沉淀
    ，不是凭空造轮子

一条命令开始使用：

cd /your/projectnpx superpowers-zh

然后像往常一样和 AI 对话。你会发现它不再急着写代码了——它会先问你几个问题。

十一、社区与资源

社区

    • 微信公众号：AI不止语（直接关注或搜索：AI_BuZhiYu）

    • QQ 2群：1071280067

    • 微信群：关注公众号后回复「群」获取

    • GitHub：github.com/jnMetaCode/superpowers-zh

    相关项目

    | 项目 | 说明 |

    | agency-agents-zh | 211 个 AI 专家角色，覆盖 18 个部门，一键安装 |

    | agency-orchestrator | 一句话调度多个 AI 专家自动协作，几分钟交付完整方案 |

    | ai-coding-guide | AI 编程 学习实战指南 — 66 个 Claude Code 技巧 + 9 款工具最佳实践 |

    | shellward | AI 智能体安全中间件 — 注入检测、数据防泄露、命令安全 |

    觉得有用？

    • 给个 Star：github.com/jnMetaCode/superpowers-zh
    • 转发给同事
       → 团队一起装，效果更好

    本文介绍的 superpowers-zh 项目基于 MIT 开源协议，

    GitHub 仓库：github.com/jnMetaCode/superpowers-zh