jnMetaCode/superpowers-zh · 上手攻略

仓库：jnMetaCode/superpowers-zh
链接：https://github.com/jnMetaCode/superpowers-zh
分类：skill
作者：Jay
更新：2026-08-18

这是什么

superpowers-zh 是目前最火的 AI 编程 Skills 框架 superpowers（250k+ ⭐）的中文增强版，在完整汉化 14 个上游 Skills 的基础上，新增 6 个面向中国开发者的原创 Skills，支持 23 款 AI 编程工具（上游仅支持 6 款）。从头脑风暴到代码审查，从 TDD 到调试，每个 Skill 都是经过实战验证的工作方法论。

上游 obra/superpowers 是英文社区最热门的 AI 编程 Skills 集合，250k+ GitHub Stars。superpowers-zh 在此基础上汉化全部内容，并大幅扩展工具支持范围，新增中国开发者常用的 Skills。

解决什么问题

没用 superpowers-zh 时，AI 编程工具是"想到什么做什么"——直接开始写代码，写完发现需求理解有偏差、格式不对、大数据量 OOM。

装了之后，AI 会先问清楚再动手：导出格式、分页需求、权限控制……给 2-3 个方案确认后再实现，减少返工。

核心解决的问题： - 流程规范：从"直接写"变为"先理解、后计划、再实现"，减少返工 - 工具覆盖：上游只支持 6 款工具，zh 版扩展到 23 款（含国内工具） - 中文体验：全中文 Skill 文档，中国开发者无语言障碍 - 中国特色：MCP 服务器构建、工作流执行器、中文 Git 提交规范、中文代码审查风格

快速安装

方式一：一条命令自动识别（推荐）

npx superpowers-zh

自动检测当前项目里的 AI 编程工具并安装对应 Skills。识别不出时自动打印可用的 --tool 命令提示。

方式二：显式指定工具

npx superpowers-zh --tool claude-code   # Claude Code
npx superpowers-zh --tool cursor        # Cursor
npx superpowers-zh --tool windsurf      # Windsurf
npx superpowers-zh --tool kiro          # Kiro
npx superpowers-zh --global --tool hermes  # Hermes（全局安装）

方式三：Claude Code Plugin Marketplace

claude plugin marketplace add superpowers-zh

升级只需一条命令。

14 个翻译 Skills 概览

Skill	用途
`brainstorming`	头脑风暴——在动手前充分探索问题空间
`using-superpowers`	工具路由——根据任务类型选合适的内置能力
`executing-plans`	执行计划——把大任务拆解为可操作步骤
`debugging`	调试——系统性定位 Bug 的方法论
`testing-anti-patterns` / `writing-good-tests`	测试——两条原则 + 变异检查
`requesting-code-review`	代码审查——高效评审他人代码
`receiving-code-review`	接受审查——正确处理评审反馈
`writing-plans`	制定计划——任务分解与时间评估
`test-driven-development`	TDD——测试先行开发流程
`systematic-debugging`	系统调试——分层排查框架
`finishing-a-development-branch`	收尾开发分支——善后与提交规范
`requesting-code-review`	提请审查——正确发出 PR
`subagent-driven-development`	子 Agent 驱动开发——多 Agent 协作
`skill-creator`	创建 Skill——规范化编写新 Skill

6 个中国原创 Skills

Skill	用途
`mcp-builder`	构建 MCP 服务器——生成标准 Model Context Protocol 服务器代码
`workflow-runner`	工作流执行器——多角色 YAML 编排执行
中文 Git 提交规范	Conventional Commits 中文适配版
中文文档规范	中文排版 + 中英混排规则
代码审查风格	适配国内团队沟通文化的代码评审方式
CI/CD 示例	GitHub Actions + Gitee Go + 极狐 CI + CNB（腾讯云原生构建）

23 款支持的 AI 编程工具

上游 6 款：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI

新增 17 款：Hermes Agent / Trae / Kiro / Windsurf / Qwen Code / OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code (Copilot) / Aider / Qoder / CodeBuddy（腾讯）/ CodeArts（华为云码道）/ Cline / Kilo Code / Crush

典型适用场景

新项目启动：用 brainstorming + writing-plans 充分探索后再动手
复杂任务分解：用 executing-plans 把大任务拆成可执行步骤
调试棘手 Bug：用 systematic-debugging 或 debugging 分层排查
TDD 开发：用 test-driven-development 测试先行驱动开发
代码审查：用 requesting-code-review 和 receiving-code-review 规范评审流程
构建 MCP 服务器：用 mcp-builder 生成标准服务器代码
多 Agent 协作：用 subagent-driven-development 编排多个 Agent

v1.7.10 重要修复（升级必读）

Aider 用户重装：CONVENTIONS.md 不会自动加载（需 --read），已修复真实标记检测
Kiro 用户重装：.kiro/steering/ 每轮全量 335KB 进上下文，已改为索引式 4.4KB（省 76×）
Hermes 用户重装：之前装到项目级 .hermes/skills/ 完全不生效，现改为 ~/.hermes/skills/ 全局安装
Qoder 用户：Explore/Plan 的 agent 名映射已修正

重装命令：

# Aider 用户
npx superpowers-zh --tool aider

# Kiro 用户
npx superpowers-zh --tool kiro

# Hermes 用户
npx superpowers-zh --global --tool hermes

坑与注意

不是"装上就变强"：Skill 是方法论，需要用户主动 invoke 才能生效。Skill 本身不会自动注入到 AI 的工作流中，需要在 Claude Code 里显式调用（如 /brainstorming）。
工具检测不保证 100%：少数小众工具或非标准项目结构可能检测失败，此时用 --tool <name> 显式指定即可。
部分 Skill 需要工作流编排：如 workflow-runner 需要编写 YAML 配置文件，有一定学习成本。
上游同步延迟：中文版在同步上游 v6.2.0 基础上叠加国产增量，两者叠加可能出现极少的结构漂移（audit 检查会告警）。
上下文窗口压力：Kiro 等工具的 Skill 文件每轮全量进上下文可能带来 Token 消耗，v1.7.10 已优化为索引式，但仍需关注长会话成本。
Windows 支持：Windows 通过 Git Bash 分发 bootstrap，MinGW/MSYS2 环境需要单独安装。

与同类对比

工具	类型	Stars	Skill 数	工具覆盖	语言
`obra/superpowers`（上游）	AI 编程 Skills 框架	250k+	14	6 款	英文
`jnMetaCode/superpowers-zh`（本文）	中文增强版	7.6k+	20	23 款	中文
各工具内置 Prompt	内置提示词	—	—	单工具	多语言
Cursor/Windsurf Rules	规则配置	—	—	单工具	多语言

superpowers-zh 的核心优势：一套方法论，覆盖 23 款工具，不需要为每个工具单独配置。

一句话推荐结论

用 AI 编程工具效率不如预期？superpowers-zh 是目前最完整的 AI 编程方法论 Skill 包——20 个 Skills、23 款工具、一条命令安装，让 AI 从"直接写代码"变成"先问清楚再动手"，减少返工、提升输出质量，中文开发者尤为推荐。

上游项目：https://github.com/obra/superpowers（250k+ ⭐）。npm 包：https://www.npmjs.com/package/superpowers-zh。License：MIT。