上游 116k+ 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/project
npx 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 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 个 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 步检查清单）：
- 探索项目上下文 — 检查文件、文档、最近的 commit
- 提供视觉伴侣 — 如果主题涉及视觉问题（独立消息）
- 提出澄清问题 — 每次一个，了解目的/约束/成功标准
- 提出 2-3 种方案 — 附带权衡分析和推荐
- 展示设计 — 分节展示，每节获得用户批准
- 编写设计文档 — 保存到
docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md - 规格自检 — 检查占位符、矛盾、模糊性
- 用户审查规格
- 过渡到实现 — 自动调用 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 降至 200ms
docs(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-review
agents_dir: agency-agents-zh
inputs:
- name: prd_path
required: true
steps:
- 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-name
description: "触发条件描述"
---
# 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 是独立的中文版本，文件名和目录结构与上游一致但内容是中文。不建议同时安装两个版本。
十一、社区与资源
社区
- 关注 AI不止语
- 1071280067
- GitHub：github.com/jnMetaCode/superpowers-zh
相关项目
| 项目 | 说明 |
|---|---|
| superpowers（上游） | 原始英文版，116k+ stars |
| agency-agents-zh | 211 个 AI 专家角色，覆盖 18 个部门，一键安装 |
| agency-orchestrator | 一句话调度多个 AI 专家自动协作，几分钟交付完整方案 |
| ai-coding-guide | AI 编程工具实战指南 — 66 个 Claude Code 技巧 + 9 款工具最佳实践 |
| shellward | AI 智能体安全中间件 — 注入检测、数据防泄露、命令安全 |
总结
superpowers-zh 不是让 AI "更聪明"，而是让 AI "更靠谱"：
- 20 个经过实战验证的工作方法论，覆盖从需求到上线的完整流程
- 三条铁律（设计先行、测试先行、证据先行），杜绝 AI 一上来就写代码
- 6 个中国特色 skills，适配国内团队文化、平台和工具链
- 16 种 AI 工具支持，一条命令安装
- 上游 116k+ stars 的方法论沉淀，不是凭空造轮子
一条命令开始使用：
cd /your/project
npx superpowers-zh
然后像往常一样和 AI 对话。你会发现它不再急着写代码了——它会先问你几个问题。
觉得有用？
- 给个 Star → github.com/jnMetaCode/superpowers-zh
- 转发给同事 → 团队一起装，效果更好
*本文介绍的 superpowers-zh 项目基于 MIT 开源协议，GitHub 仓库：github.com/jnMetaCode/superpowers-zh
