Superpowers-zh：AI 编程从能跑到专业的 20 个能力
Superpowers-zh 是什么？
它不是工具。它是让 AI 工具「真正会干活」的方法论。
上游 superpowers（159k+ ⭐）是内核。Superpowers-zh 是中文增强版。
20 个 skills，分成 5 组：
- 规划组：动手前先想清楚
- 开发组：质量的底层保障
- 审查组：两道防线
- 工具组：工程基础设施
- 元技能组：制造超能力的超能力
对比：装了 vs 没装
没装 superpowers-zh：
你：给用户模块加个批量导出功能
AI：好的，我来实现...（直接开始写代码）
export async function exportUsers() { ... }
你：等等，格式不对，没分页，大数据量会 OOM...装了 superpowers-zh：
你：给用户模块加个批量导出功能
AI：在开始实现之前，我需要了解几个关键问题：
1. 导出格式是 CSV 还是 Excel？
2. 预计数据量多大？需要异步处理吗？
3. 有权限要求吗？
→ 给出 2-3 个方案，确认后再动手差别：
- 前者：AI 直接写代码 → 频繁返工
- 后者：AI 先思考 → 一次做对
第 1 组：规划组 —— 动手前先想清楚
核心思想：不写代码先想清楚。
Skill 1：头脑风暴（Brainstorming）
用途： 需求分析 → 设计规格
AI 会做什么：
- 分析你的需求
- 提出关键问题
- 给出多个方案
- 分析每个方案的优缺点
- 等你确认后再动手
示例：
你：我想做一个用户登录功能
AI：在开始之前，我需要确认几个问题：
- 登录方式：邮箱/手机/第三方？
- 密码策略：复杂度要求？过期策略？
- 安全要求：双因素认证？加密存储？
- 错误处理：密码错误如何提示？账号锁定策略？
→ 给出 3 个方案，从安全性和复杂度分析Skill 2：编写计划（Writing Plans）
用途： 把规格拆成可执行的实施步骤
AI 会做什么：
- 接收头脑风暴的结果
- 拆分成独立的任务
- 定义每个任务的：
- 输入
- 输出
- 验收标准
- 排定任务顺序
示例：
任务 1：设计数据表
输入：用户信息字段
输出：SQL schema
验收：字段完整、索引合理
任务 2：实现注册接口
输入：数据表 schema
输出：API endpoint
验收：测试通过、文档完整
任务 3：实现登录接口
...Skill 3：执行计划（Executing Plans）
用途： 按计划逐步实施，每步验证
AI 会做什么：
- 读取编写计划的输出
- 按顺序执行每个任务
- 每个任务完成后：
- 运行测试
- 检查验收标准
- 确认通过后再进入下一个
- 遇到问题时停下来询问
规划组的三个技能构成一个完整的「思考 → 规划 → 执行」链条。
第 2 组：开发组 —— 质量的底层保障
核心思想：用工程实践保障质量。
Skill 4：测试驱动开发（TDD）
用途： 严格 TDD：先写测试，再写代码
AI 会做什么：
【Red 步骤】
AI 先写测试：
describe('User Login', () => {
it('should login with correct credentials', () => {
// 测试正确凭证登录
})
it('should reject wrong password', () => {
// 测试错误密码拒绝
})
})
【Green 步骤】
AI 运行测试 → 全部失败
AI 实现功能 → 让测试通过
【Refactor 步骤】
AI 检查代码质量
AI 重构代码
AI 再次运行测试 → 仍然通过Skill 5：系统化调试（Systematic Debugging）
用途： 四阶段调试法：定位 → 分析 → 假设 → 修复
AI 会做什么：
阶段 1：定位（Reproduce）
AI 复现问题
AI 收集日志
AI 确认问题边界
阶段 2：分析（Analyse）
AI 分析代码
AI 检查相关逻辑
AI 查找类似问题
阶段 3：假设（Hypothesise）
AI 提出假设
AI 设计验证实验
阶段 4：修复（Fix）
AI 实施修复
AI 添加回归测试
AI 验证修复有效开发组的两个技能：TDD 保障「写得对」，调试保障「改得对」。
第 3 组：审查组 —— 两道防线
核心思想：不信任任何人，包括 AI 自己。
Skill 6：请求代码审查（Requesting Code Review）
用途： 派遣审查 agent 检查代码质量
AI 会做什么：
- 派遣一个独立的审查 agent
- 审查 agent 检查：
- 逻辑正确性
- 边界条件
- 错误处理
- 性能问题
- 安全漏洞
- 生成详细报告
- 提出改进建议
Skill 7：接收代码审查（Receiving Code Review）
用途： 技术严谨地处理审查反馈，拒绝敷衍
AI 会做什么：
收到反馈：『这个函数太复杂，建议拆分』
AI 会：
1. 理解反馈的意图
2. 分析代码是否确实复杂
3. 如果是，设计拆分方案
4. 实施重构
5. 运行测试确保没破坏功能
6. 回复：『已拆分为 A、B 两个函数，测试通过』Skill 8：完成前验证（Verification Before Completion）
用途： 证据先行 —— 声称完成前必须跑验证
AI 会做什么：
AI 声称：『功能已完成』
触发 verification-before-completion skill：
AI 自动：
1. 运行所有测试
2. 检查测试覆盖率
3. 验证验收标准
4. 检查文档完整性
5. 确认没有 TODO
全部通过 → 报告：『已完成并验证』审查组的三个技能：事前审查、事后处理、完成验证。
第 4 组：工具组 —— 工程基础设施
核心思想：用 Git 工作流隔离风险。
Skill 9：Git Worktree 使用
用途： 隔离式特性开发
AI 会做什么：
AI 为每个功能创建独立的 worktree：
project/
├── main（主分支）
├── feature-login（登录功能）
├── feature-export（导出功能）
└── bugfix-123（Bug 修复）
每个 worktree 独立开发，互不影响Skill 10：完成开发分支（Finishing a Development Branch）
用途： 合并/PR/保留/丢弃四选一
AI 会做什么：
开发完成后，AI 引导你选择：
选项 1：合并到主分支
- 运行测试
- 合并代码
- 删除 worktree
选项 2：创建 PR
- 推送到远程
- 创建 Pull Request
- 保留 worktree
选项 3：保留 worktree
- 暂时保留，稍后继续
选项 4：丢弃 worktree
- 删除 worktree 和分支Skill 11：派遣并行 Agent（Dispatching Parallel Agents）
用途： 多任务并发执行
AI 会做什么：
任务：『重构用户模块、订单模块、支付模块』
AI 派遣 3 个并行 agent：
Agent 1：重构用户模块
Agent 2：重构订单模块
Agent 3：重构支付模块
3 个 agent 独立工作，最后 AI 汇总结果Skill 12：子 Agent 驱动开发（Subagent Driven Development）
用途： 每个任务一个 agent，两轮审查
AI 会做什么：
大任务拆成 5 个子任务
每个子任务一个独立 agent：
Agent 1：设计数据表
Agent 2：实现 API
Agent 3：写测试
Agent 4：写文档
Agent 5：代码审查
每个 agent 有独立的上下文窗口工具组的四个技能：Git 隔离 + 并行执行 + 多 Agent 协作。
第 5 组：元技能组 —— 制造超能力的超能力
核心思想：学会制造工具。
Skill 13：编写 Skills（Writing Skills）
用途： 创建新 skill 的方法论
AI 会做什么：
你：『我想创建一个「性能优化」的 skill』
AI 引导你：
1. 定义 skill 的目标
2. 设计 skill 的步骤
3. 编写检查清单
4. 添加示例
5. 测试 skill
生成 SKILL.md 文件Skill 14：使用 Superpowers（Using Superpowers）
用途： 元技能：如何调用和优先使用 skills
AI 会做什么：
遇到任务时，AI 自动：
1. 识别任务类型
2. 选择合适的 skill
3. 加载 skill
4. 按 skill 执行
5. 完成后报告
示例：『修复 Bug』
→ 自动加载 systematic-debugging
→ 按四阶段调试法执行元技能组的两个技能：学会制造工具，学会用工具。
中国特色 Skills：四个原创
Superpowers-zh 新增四个面向中国开发者的 skills：
Skill 15：中文代码审查
用途： 符合国内团队文化的代码审查规范
AI 会做什么：
- 用中文写审查意见
- 适配国内团队沟通风格（委婉、详细）
- 考虑国内团队的协作习惯
Skill 16：中文 Git 工作流
用途： 适配 Gitee/Coding/极狐 GitLab/CNB
AI 会做什么：
- 支持 Gitee、Coding 等国内 Git 平台
- 适配国内 CI/CD（Gitee Go、Coding CI）
- 处理国内常见的 Git 工作流
Skill 17：中文技术文档
用途： 中文排版规范、中英混排、告别机翻味
AI 会做什么：
- 遵循中文排版规范
- 正确处理中英混排（中英文之间加空格）
- 避免机翻感（用自然中文表达）
Skill 18：中文提交规范
用途： 适配国内团队的 commit message 规范
AI 会做什么：
- 用中文写 commit message
- 遵循 Conventional Commits 中文版
- 适配国内团队的提交习惯
安装和使用
一键安装：
cd /your/project
npx superpowers-zh自动检测你项目中使用的工具：
- Claude Code
- Cursor
- Copilot CLI
- Hermes Agent
- Trae
- Kiro
- Gemini CLI
- Codex
- Aider
- OpenCode
- OpenClaw
- Windsurf
- Qwen Code
- Antigravity
- Claw Code
- Qoder
- DeerFlow
- VS Code
18 款工具，一条命令搞定。
支持 18 款 AI 编程工具
上游 superpowers 支持 6 款工具。
Superpowers-zh 扩展到 18 款：
| 类别 | 工具 |
|---|---|
| CLI | Claude Code, Copilot CLI, Hermes Agent, Codex, OpenCode, OpenClaw, Claw Code, Aider, Gemini CLI, Antigravity |
| IDE | Cursor, Windsurf, Kiro, Trae, VS Code, Qwen Code, Qoder |
| Agent | DeerFlow 2.0 |
覆盖主流 AI 编程场景。
Superpowers-zh vs 上游对比
| 维度 | 上游 superpowers | Superpowers-zh |
|---|---|---|
| ⭐ Star 数 | 159k+ | - |
| 📦 Skills 总数 | 14 | 20（14 翻译 + 4 国产原创 + 2 上游历史保留） |
| 🌐 语言 | 英文 | 中文（技术术语保留英文） |
| 🤖 支持工具 | 6 款 | 18 款 |
| ⚡ 安装方式 | 按工具分别装 | npx superpowers-zh 一条命令 |
| 🇨🇳 Git 平台 | GitHub | GitHub + Gitee + Coding + 极狐 + CNB |
| 🇨🇳 CI/CD | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 极狐 CI |
| 🇨🇳 审查风格 | 西方直接风格 | 适配国内团队沟通文化 |
| 🇨🇳 中文文档 | 无 | 中文排版 + 中英混排 + 告别机翻味 |
写在最后：方法论的价值
Superpowers-zh 不是框架。
Superpowers-zh 是方法论。
它回答了一个问题：
如何让 AI 工具「真正会干活」？
答案：
不是给 AI 更强的模型。
不是给 AI 更多的上下文。
是给 AI 「工作方法论」。
规划组：动手前先想清楚开发组：质量的底层保障审查组：两道防线工具组：工程基础设施元技能组：制造超能力的超能力
20 个 skills，覆盖 AI 编程的完整链路。
从需求到代码，从开发到审查，从 Git 到部署。
每个技能都是经过实战验证的工作方法论。
装上 superpowers-zh：
你的 AI 不再只是「能写代码」。
你的 AI 会「专业地干活」。
上游 superpowers = 方法论内核。
中文增强版 = 方法论内核 + 18 款工具适配 + 国内 Git/CI 生态 + 中文化表达习惯。
项目地址： https://github.com/jnMetaCode/superpowers-zh
配套阅读： 《AI 编程实战 · 方法论三卷书》
"