🌐 简体中文 | English (upstream)
🦸 superpowers(159k+ ⭐)完整汉化 + 6 个中国原创 skills — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 17 款 AI 编程工具真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。
Chinese community edition of superpowers — 20 skills across 16 AI coding tools, including full translations and China-specific development skills.
|
没装 superpowers-zh: |
装了 superpowers-zh: |
| 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
|---|---|---|
| 14 | 6 | Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code |
superpowers 是目前最火的 AI 编程 skills 框架(159k+ stars),为 AI 编程工具提供系统化的工作方法论。
superpowers-zh 在完整翻译的基础上,新增了面向中国开发者的特色 skills。
| 维度 | superpowers(英文上游) | superpowers-zh(中文增强版) |
|---|---|---|
| ⭐ Star 数 | 159k+ | — |
| 📦 Skills 总数 | 14 | 20(14 翻译 + 6 国产原创) |
| 🌐 语言 | 英文 | 中文(技术术语保留英文) |
| 🤖 支持工具 | 6 款:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | 17 款:上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code(通义灵码)/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider |
| ⚡ 安装方式 | 按工具分别装(每款一条不同的 plugin marketplace 命令) | npx superpowers-zh 一条命令自动识别项目里的工具并安装;识别不出可 --tool <name> 显式指定 |
| 🇨🇳 Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 GitLab + CNB(腾讯云原生构建) |
| 🇨🇳 CI/CD 示例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 极狐 CI + .cnb.yml |
| 🇨🇳 代码审查风格 | 西方直接风格 | 适配国内团队沟通文化 |
| 🇨🇳 Git 提交规范 | 无 | Conventional Commits 中文适配 |
| 🇨🇳 中文文档规范 | 无 | 中文排版 + 中英混排规则 + 告别机翻味 |
| ➕ MCP 服务器构建 | 无 | 独立 mcp-builder skill |
| ➕ 工作流执行器 | 无 | 独立 workflow-runner skill(多角色 YAML 编排) |
| 🔄 版本跟进 | 独立迭代 | 同步上游 + 国产增量叠加 |
| 🤝 接受新 skill PR | 一般不接受(原文:"we don't generally accept contributions of new skills") | 欢迎 PR(中国开发者痛点优先) |
| 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 |
| 📜 License | MIT | MIT |
一句话总结: 英文上游 = 方法论内核;中文增强版 = 方法论内核 + 17 款工具一键适配 + 国内 Git/CI 生态 + 中文化表达习惯。
| 工具 | 类型 | 一键安装 | 手动安装 |
|---|---|---|---|
| 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/ + .trae/rules/ |
| VS Code (Copilot) | IDE 插件 | npx superpowers-zh |
.github/superpowers/ |
| DeerFlow 2.0 | Agent 框架 | 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/ |
| Claw Code | CLI (Rust) | npx superpowers-zh |
.claw/skills/ |
运行
npx superpowers-zh会自动检测你项目中使用的工具,将 20 个 skills 安装到正确位置。
| Skill | 用途 |
|---|---|
| 头脑风暴 (brainstorming) | 需求分析 → 设计规格,不写代码先想清楚 |
| 编写计划 (writing-plans) | 把规格拆成可执行的实施步骤 |
| 执行计划 (executing-plans) | 按计划逐步实施,每步验证 |
| 测试驱动开发 (test-driven-development) | 严格 TDD:先写测试,再写代码 |
| 系统化调试 (systematic-debugging) | 四阶段调试法:定位→分析→假设→修复 |
| 请求代码审查 (requesting-code-review) | 派遣审查 agent 检查代码质量 |
| 接收代码审查 (receiving-code-review) | 技术严谨地处理审查反馈,拒绝敷衍 |
| 完成前验证 (verification-before-completion) | 证据先行——声称完成前必须跑验证 |
| 派遣并行 Agent (dispatching-parallel-agents) | 多任务并发执行 |
| 子 Agent 驱动开发 (subagent-driven-development) | 每个任务一个 agent,两轮审查 |
| Git Worktree 使用 (using-git-worktrees) | 隔离式特性开发 |
| 完成开发分支 (finishing-a-development-branch) | 合并/PR/保留/丢弃四选一 |
| 编写 Skills (writing-skills) | 创建新 skill 的方法论 |
| 使用 Superpowers (using-superpowers) | 元技能:如何调用和优先使用 skills |
| Skill | 用途 | 上游有吗? |
|---|---|---|
| 中文代码审查 (chinese-code-review) | 符合国内团队文化的代码审查规范 | 无 |
| 中文 Git 工作流 (chinese-git-workflow) | 适配 Gitee/Coding/极狐 GitLab | 无 |
| 中文技术文档 (chinese-documentation) | 中文排版规范、中英混排、告别机翻味 | 无 |
| 中文提交规范 (chinese-commit-conventions) | 适配国内团队的 commit message 规范 | 无 |
| MCP 服务器构建 (mcp-builder) | 构建生产级 MCP 工具,扩展 AI 能力边界 | 无 |
| 工作流执行器 (workflow-runner) | 在 AI 工具内运行多角色 YAML 工作流 | 无 |
cd /your/project
npx superpowers-zh# 克隆仓库
git clone https://github.com/jnMetaCode/superpowers-zh.git
# 复制 skills 到你的项目(选择你使用的工具)
cp -r superpowers-zh/skills /your/project/.claude/skills # Claude Code / Copilot CLI
cp -r superpowers-zh/skills /your/project/.hermes/skills # Hermes Agent
cp -r superpowers-zh/skills /your/project/.cursor/skills # Cursor
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/skills/custom # DeerFlow 2.0
cp -r superpowers-zh/skills /your/project/.trae/rules # Trae
cp -r superpowers-zh/skills /your/project/.antigravity # Antigravity
cp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)
cp -r superpowers-zh/skills /your/project/skills # OpenClaw
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/.aider/skills # Aider
cp -r superpowers-zh/skills /your/project/.opencode/skills # OpenCode
cp -r superpowers-zh/skills /your/project/.qwen/skills # Qwen Code
cp -r superpowers-zh/skills /your/project/.claw/skills # Claw Code(Rust 版)根据你使用的工具,在对应配置文件中引用 skills:
| 工具 | 配置文件 | 说明 |
|---|---|---|
| Claude Code | CLAUDE.md |
项目根目录 |
| Copilot CLI | CLAUDE.md |
与 Claude Code 共用插件格式 |
| Hermes Agent | HERMES.md 或 .hermes.md |
项目根目录,安装时自动生成 |
| Kiro | .kiro/steering/*.md |
支持 always/globs/手动三种模式 |
| DeerFlow 2.0 | skills/custom/*/SKILL.md |
字节跳动开源 SuperAgent,自动发现自定义 skills |
| Trae | .trae/rules/project_rules.md |
项目级规则 |
| Antigravity | GEMINI.md 或 AGENTS.md |
项目根目录 |
| VS Code | .github/copilot-instructions.md |
Copilot 自定义指令 |
| Cursor | .cursor/rules/*.md |
项目级规则目录 |
| OpenClaw | skills/*/SKILL.md |
工作区级 skills 目录,自动发现 |
| Windsurf | .windsurf/skills/*/SKILL.md |
项目级 skills 目录 |
| Gemini CLI | .gemini/skills/*/SKILL.md |
项目级 skills 目录 |
| Aider | .aider/skills/*/SKILL.md |
项目级 skills 目录 |
| OpenCode | .opencode/skills/*/SKILL.md |
项目级 skills 目录 |
| Hermes Agent | .hermes/skills/*/SKILL.md |
项目级 skills 目录 |
| Qwen Code | .qwen/skills/*/SKILL.md |
项目级 skills 目录 |
| Claw Code | .claw/skills/*/SKILL.md |
Rust 版 CLI agent,兼容 Claude Code 的 SKILL.md 格式 |
详细安装指南:Kiro · DeerFlow · Trae · Antigravity · VS Code · Codex · OpenCode · OpenClaw · Windsurf · Gemini CLI · Aider · Qwen Code · Hermes Agent
欢迎参与!翻译改进、新增 skills、Bug 修复都可以。
我们只接收符合 superpowers 定位的 skill——AI 编程工作流方法论。好的 skill 应该:
- 教 AI 助手怎么干活,而不是某个框架/语言的教程
- 解决上游英文版不覆盖的中国开发者痛点
- 有明确的步骤、检查清单、示例,AI 加载后能直接执行
欢迎提 Issue 讨论你的想法!
微信公众号 「AI不止语」(微信搜索 AI_BuZhiYu)— 技术问答 · 项目更新 · 实战文章
| 渠道 | 加入方式 |
|---|---|
| QQ 2群 | 点击加入(群号 1071280067) |
| 微信群 | 关注公众号后回复「群」获取入群方式 |
五个项目组合使用,覆盖 AI 编程从"方法论 → 角色 → 协作 → 教程 → 安全"的完整链路。
| 项目 | 定位 | 一句话 |
|---|---|---|
| superpowers-zh(本项目) |
🧠 工作方法论 | 20 个 skills 教 AI 怎么干活(TDD / 调试 / 代码审查等) |
| agency-agents-zh |
🎭 专家角色库 | 211 个即插即用 AI 专家,含 46 中国原创(小红书 / 抖音 / 飞书 / 钉钉) |
| agency-orchestrator | 🚀 编排引擎 | 一句话 → 211 专家协作,几分钟出方案(9 家 LLM / 6 免费) |
| ai-coding-guide | 📖 实战教程 | 66 个 Claude Code 技巧 + 9 款工具最佳实践 + 配置模板 |
| shellward | 🛡️ 安全中间件 | 8 层防御 + DLP 数据流 + 注入检测,零依赖(含 MCP Server) |
🔥 重点推荐:agency-orchestrator — 一句话调度 211 个 AI 专家协作,几分钟交付完整方案
以前写个方案:你当指挥官,把 AI 轮流扮演 5 个角色,复制粘贴 10 次,1 小时没了。
现在: 丢一句话进去 "做一个电商退款流程",产品 → 架构 → 安全 → 测试 → DBA 自动接力,几分钟完整方案落地。
- 🎭 211+ 专家角色(含 46 个中国市场原创:小红书 / 抖音 / 微信 / 飞书 / 钉钉)
- 🧩 零代码 YAML,一行 prompt 就能跑
- 💰 9 家 LLM 可选(DeepSeek / Claude / OpenAI / Ollama 等,6 家免费)
- 🔗 与 superpowers-zh 互补:本项目管"怎么做"(方法论),orchestrator 管"谁来做"(角色协作)
- 原始英文版:obra/superpowers(MIT 协议)
- 感谢 @obra 创建了这个优秀的项目
MIT License — 自由使用,商业或个人均可。