Skip to content

jnMetaCode/superpowers-zh

Repository files navigation

superpowers-zh(AI 编程超能力 · 中文增强版)

🌐 简体中文 | 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:

你:给用户模块加个批量导出功能
AI:好的,我来实现...(直接开始写代码)
    export async function exportUsers() { ... }
你:等等,格式不对,没分页,大数据量会 OOM...

装了 superpowers-zh:

你:给用户模块加个批量导出功能
AI:在开始实现之前,我需要了解几个关键问题:
    1. 导出格式是 CSV 还是 Excel?
    2. 预计数据量多大?需要异步处理吗?
    3. 有权限要求吗?
    → 给出 2-3 个方案,确认后再动手

GitHub stars npm version License: MIT PRs Welcome

📊 项目规模

📦 翻译 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 生态 + 中文化表达习惯。

🤖 支持 17 款主流 AI 编程工具

工具 类型 一键安装 手动安装
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 安装到正确位置。

翻译的 Skills(14 个)

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

🇨🇳 中国特色 Skills(6 个)

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 工作流

快速开始

方式一:npm 安装(推荐)

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.mdAGENTS.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 讨论你的想法!


交流 · Community

微信公众号 「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 管"谁来做"(角色协作)

👉 立即体验 agency-orchestrator →


致谢


许可证

MIT License — 自由使用,商业或个人均可。


🦸 AI 编程超能力:让 Claude Code / Hermes Agent / Cursor / Claw Code 等 17 款工具真正会干活

Star 本项目 · 提交 Issue · 贡献代码

About

🦸 AI 编程超能力 · 中文增强版 — superpowers(116k+ ⭐)完整汉化 + 6 个中国原创 skills,让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 16 款 AI 编程工具真正会干活

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

 
 
 

Contributors