AI摘要
Superpowers是一套工作流技能,可通过Codex提示词调用。它包含14个翻译技能和6个中国特色技能,支持18款主流AI编程工具。与英文上游相比,中文增强版增加了工具适配、国内Git/CI生态和中文化表达习惯。安装方式为`npx superpowers-zh`,可自动识别项目中的工具并安装。
中文版Superpowers使用方法
Superpowers 不是一个“单独 agent”,而是一组工作流 skills。你可以直接在 Codex 提示词里用 $skill-name 调用。
常用方式:
$brainstorming 帮我把这个需求先梳理清楚,不要急着写代码。$writing-plans 根据 系统构架设计.md 输出可执行开发计划。$executing-plans 按 docs/implementation-plan.md 执行开发,每完成一步就验证。$systematic-debugging 帮我定位这个 bug 的根因,先不要直接改代码。$test-driven-development 给用户导出功能做 TDD,实现前先写失败测试。$requesting-code-review 审查当前改动,重点看 bug、安全风险和测试缺口。中文版增强 skill 可以这样用:
$chinese-code-review 用中文团队风格审查当前代码改动。$chinese-documentation 帮我整理中文技术文档,注意中英文混排和工程表达。$chinese-commit-conventions 根据当前改动生成中文 commit message。$chinese-git-workflow 按国内团队 Git 工作流帮我规划分支、提交和发布步骤。如果你不想记名字,也可以自然语言说:
使用 superpowers 的调试方法帮我排查这个问题。或:
用中文版 superpowers 帮我先做需求澄清和实现计划。你刚装完后,需要新开 Codex 会话或重启 Codex,才能稳定加载这 20 个 skills。加载后,在 CLI/IDE 里通常也可以输入 $ 或 /skills 查看可用 skill。
中文版开源地址
https://github.com/jnMetaCode/superpowers-zh
🆚 与英文上游的区别(老被问,一次说清)
| 维度 | superpowers(英文上游) | superpowers-zh(中文增强版) |
|---|---|---|
| ⭐ Star 数 | 233k+ | — |
| 📦 Skills 总数 | 14 | 20(14 翻译 + 4 国产原创 + 2 上游历史保留) |
| 🌐 语言 | 英文 | 中文(技术术语保留英文) |
| 🤖 支持工具 | 6 款:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | 18 款:上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code(通义灵码)/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder |
| ⚡ 安装方式 | 按工具分别装(每款一条不同的 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 |
一句话总结: 英文上游 = 方法论内核;中文增强版 = 方法论内核 + 18 款工具一键适配 + 国内 Git/CI 生态 + 中文化表达习惯。
🤖 支持 18 款主流 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 | .agents/skills/ |
| Claw Code | CLI (Rust) | npx superpowers-zh | .claw/skills/ |
| Qoder (阿里 AI IDE) | IDE | npx superpowers-zh | .qoder/skills/ + .qoder/rules/ |
运行 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 个)
⚠️ 下表前 4 个 chinese-* 为「手动调用」skill——不会自动触发,需在对话中显式输入/chinese-xxx才会加载。
设计为参考资料而非工作流,避免污染上游 skill 的自动调度(如requesting-code-review、brainstorming等)。
| Skill | 用途 | 调用方式 | 上游有吗? |
|---|---|---|---|
| 中文代码审查 (chinese-code-review) | 符合国内团队文化的代码审查规范 | /chinese-code-review(手动) | 无 |
| 中文 Git 工作流 (chinese-git-workflow) | 适配 Gitee/Coding/极狐 GitLab/CNB | /chinese-git-workflow(手动) | 无 |
| 中文技术文档 (chinese-documentation) | 中文排版规范、中英混排、告别机翻味 | /chinese-documentation(手动) | 无 |
| 中文提交规范 (chinese-commit-conventions) | 适配国内团队的 commit message 规范 | /chinese-commit-conventions(手动) | 无 |
| MCP 服务器构建 (mcp-builder) | 构建生产级 MCP 工具,扩展 AI 能力边界 | 自动 | 无 |
| 工作流执行器 (workflow-runner) | 在 AI 工具内运行多角色 YAML 工作流 | 自动 | 无 |