Skip to content

jnMetaCode/superpowers-zh

Repository files navigation

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

🌐 简体中文 | English (upstream)

让你的 AI 编程助手真正会干活 — 从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。

Chinese community edition of superpowers, including full translations and China-specific development skills.

GitHub stars npm version License: MIT PRs Welcome QQ群

📊 项目规模

📦 翻译 Skills 🇨🇳 中国特色 Skills 🤖 支持工具
14 5 Claude Code / Cursor / Codex / Kiro / Trae / Antigravity / VS Code / Gemini

这是什么?

superpowers 是目前最火的 AI 编程 skills 框架(99k+ stars),为 Claude Code、Cursor 等 AI 编程工具提供系统化的工作方法论

superpowers-zh 在完整翻译的基础上,新增了面向中国开发者的特色 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(5 个)

Skill 用途 上游有吗?
中文代码审查 (chinese-code-review) 符合国内团队文化的代码审查规范
中文 Git 工作流 (chinese-git-workflow) 适配 Gitee/Coding/极狐 GitLab
中文技术文档 (chinese-documentation) 中文排版规范、中英混排、告别机翻味
中文提交规范 (chinese-commit-conventions) 适配国内团队的 commit message 规范
MCP 服务器构建 (mcp-builder) 构建生产级 MCP 工具,扩展 AI 能力边界

快速开始

方式一: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
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/.trae/rules         # Trae
cp -r superpowers-zh/skills /your/project/.antigravity        # Antigravity

方式三:在配置文件中引用

根据你使用的工具,在对应配置文件中引用 skills:

工具 配置文件 说明
Claude Code CLAUDE.md 项目根目录
Kiro .kiro/steering/*.md 支持 always/globs/手动三种模式
Trae .trae/rules/project_rules.md 项目级规则
Antigravity GEMINI.mdAGENTS.md 项目根目录
VS Code .github/copilot-instructions.md Copilot 自定义指令
Cursor .cursor/rules/*.md 项目级规则目录

详细安装指南Kiro · Trae · Antigravity · VS Code · Codex · OpenCode


对比上游

特性 superpowers (英文) superpowers-zh (中文)
Skills 数量 14 19(14 翻译 + 5 原创)
语言 英文 中文(技术术语保留英文)
代码审查规范 西方直接风格 适配国内团队沟通文化
Git 平台 GitHub 为主 GitHub + Gitee + Coding + 极狐
Git 提交规范 Conventional Commits 中文适配
文档规范 英文 中文排版规范 + 中英混排
MCP 构建 MCP 服务器构建方法论
社区 Discord QQ 群

贡献

欢迎参与!翻译改进、新增 skills、Bug 修复都可以。

贡献方向

我们只接收符合 superpowers 定位的 skill——AI 编程工作流方法论。好的 skill 应该:

  • 教 AI 助手怎么干活,而不是某个框架/语言的教程
  • 解决上游英文版不覆盖的中国开发者痛点
  • 有明确的步骤、检查清单、示例,AI 加载后能直接执行

欢迎提 Issue 讨论你的想法!


社区交流

群名 群号 加入方式
AI Agent 中文实践群 833585047 点击加入

致谢


许可证

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


AI 编程超能力:让你的 AI 助手真正会干活

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

About

AI 编程超能力中文版 — superpowers 完整汉化 + 中国特色 skills(Gitee/Coding 工作流、中文排版、MCP 构建)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors