superpowers-zh：面向 26 款 AI 编程工具的 20 个中文工作流技能

你的编程 agent 上来就写代码：你提一个功能需求，它立刻开敲，等你发现设计问题时错误已经落地。superpowers 技能集的解法是让 agent 先头脑风暴、先规划、先验证。superpowers-zh 是它的中文社区版——同一套方法论，完整翻译，并扩展到英文上游不覆盖的工具与平台。

为什么这个 Skill 重要

上游 superpowers 项目——superpowers-zh README 称其为最火的 AI 编程 skills 框架，250k+ stars——技能只有英文版，文档也只列出 6 款支持工具。中文版把上游 14 个技能全部逐节翻译，新增 4 个中国原创技能，保留 2 个上游后来移除的技能，并文档化了对 26 款 AI 编程工具的支持。它还适配中文生态：Git 工作流技能覆盖 Gitee、Coding、极狐 GitLab 和 CNB，代码审查、提交规范、文档规范也都有中文版约定。

如果你用中文工作，或者在用 Qwen Code、Trae、Kiro、CodeBuddy 这类上游没有列出的工具，这个中文版是最实际的入口。

安装

一条命令的安装器会自动检测项目里在用的工具，并把技能装到各自正确的位置：

cd /your/project
npx superpowers-zh

想一次安装、所有项目共用，改用全局模式：

npx superpowers-zh --global

在 Claude Code 上还可以走 plugin marketplace 安装，之后升级只需一条命令：

claude plugin marketplace add jnMetaCode/superpowers-zh
claude plugin install superpowers-zh@superpowers-zh

plugin 方式只服务 Claude Code 一款工具；其余 25 款请用 npx superpowers-zh。

实战：写码之前，先规划批量导出功能

装好技能后，同一个需求不再直接产出代码，而是先产出方案。README 自己的对比示例把差别说得很具体：你要求给用户模块加批量导出功能。

给用户模块加个批量导出功能

agent 不会当场写出一个导出函数，而是先问关键问题：导出格式是 CSV 还是 Excel、预计数据量多大、是否需要异步处理、有没有权限要求。等你确认后，它才给出两三个方案并开始实现。技能集自己的描述恰好覆盖这条链路：brainstorming 负责写码前的需求分析与设计，writing-plans 把规格拆成可执行步骤，executing-plans 按计划逐步实施、每步验证，verification-before-completion 要求 agent 在声称完成前先跑验证。

20 个技能的构成

README 的清单把整个集合分成三块，数字可以对上：

• 14 个翻译技能——brainstorming、writing-plans、executing-plans、test-driven-development、systematic-debugging、requesting-code-review、receiving-code-review、verification-before-completion、dispatching-parallel-agents、subagent-driven-development、using-git-worktrees、finishing-a-development-branch、writing-skills、using-superpowers。
• 4 个中国原创技能——chinese-code-review、chinese-git-workflow、chinese-documentation、chinese-commit-conventions。它们设计为手动调用：在对话里输入 /chinese-xxx 才会加载，因此不会干扰工作流技能的自动调度。
• 2 个上游历史保留技能——mcp-builder 和 workflow-runner，上游后来移除了它们，这个 fork 保留下来继续维护。

技巧

• 不要在主目录（~）下跑项目级安装。README 说明 1.2.1 之前的版本会把技能和 bootstrap 文件写进 ~，污染所有项目；现在的版本会直接拒绝，并提示你改用 --global。
• 用 npx superpowers-zh@latest --uninstall 干净卸载——它会删除技能目录，并只摘除安装器自己写入 CLAUDE.md 等文件里带哨兵注释的段落。
• 除非完全没有网络，否则别用手动 cp -r skills。README 明确说只复制 skills 目录会漏掉 SessionStart 钩子和 bootstrap 引导，结果是技能物理存在却永远不会自动触发。
• 自动检测失败时，显式指定工具：npx superpowers-zh --tool <name>。

何时不用这个 Skill

如果你用英文工作，而且只用上游支持的 6 款工具，上游 superpowers 仓库更合适——中文版的增益是翻译、更宽的工具列表和中文生态技能。另外，如果你想要的是教某个具体框架或语言的技能，这个集合不是那个东西：它的贡献指南只收工作流方法论类技能，立场是技能应该教 agent 怎么干活，而不是复述框架教程。

查看 排行榜 了解更多 skill。