项目地址: https://github.com/jnMetaCode/superpowers-zh
英文上游: https://github.com/obra/superpowers
最新版本: npm 包 1.8.0(截至 2026-10,
npx superpowers-zh拉的就是它);仓库 git tag 与 npm 版本号不同步,以 npm 为准许可证: MIT | npm 包: 参见 npm| 运行要求: Node.js ≥ 20
概述
superpowers-zh 不是代码库或语言框架,而是一套面向 AI 编程工具的「工作方式插件」:把工程实践固化为可被 AI 助手加载的 Skills,让 AI 在执行任务时先遵循流程、再生成代码。核心目标三句话:
- 让 AI 先想清楚再动手:不从模糊需求直接跳到编码,先澄清目的、约束、成功标准与可选方案。
- 让 AI 用工程纪律工作:用 TDD、系统化调试、完成前验证、代码审查约束「看起来能跑」的草率实现。
- 让中文团队直接落地:在完整汉化基础上补充中文代码审查、中文 Git 工作流、中文技术文档与提交规范等本土化能力。
包内含 skills/、agents/、commands/、hooks/ 与一键安装脚本 bin/superpowers-zh.js。它在 obra/superpowers(英文上游)基础上完整汉化并新增 4 个中国原创 skills,全仓共 21 个 skills,覆盖 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / OpenCode / OpenClaw / DeepSeek Harness / Qoder / Trae 等 26 款工具(1.8.0 官方口径)。
安装
要求 Node.js ≥ 20(npm 包 superpowers-zh 的 engines 为 >=20.0.0)。
方式一:npx 直接跑(推荐)
# 交互式选择目标 AI 工具并写入对应配置
npx superpowers-zh
# 显式指定工具,不依赖自动识别
npx superpowers-zh --tool copilot
# 装到用户级目录(如 Hermes)
npx superpowers-zh --global --tool hermes
方式二:全局安装后用 superpowers-zh 命令
npm install -g superpowers-zh
superpowers-zh
验证
superpowers-zh --help # 打印可用参数(--tool / --global 等)
ls .claude/skills # 按所选工具检查落盘位置
安装器会按所选工具把 skills/、agents/、commands/、hooks/ 写入对应位置——1.8.0 的落盘目录按工具不同:Claude Code / Copilot CLI 用 .claude/skills/,Cursor 用 .cursor/skills/,Codex 用 .agents/skills/,Gemini CLI 用 .gemini/skills/,Hermes 用 ~/.hermes/skills/,Windsurf 用 .windsurf/skills/(全局 ~/.codeium/windsurf/skills/),Kiro 用 .kiro/skills/。
核心概念:Skill 机制与方法论闭环
每个 Skill 都有名称 + 触发描述 + 详细流程。当 AI 工具支持 Skill 发现或自定义指令时,会在对应场景加载这些流程,用流程约束行动。核心方法论按软件交付链路组织:
| 阶段 | Skill 作用 |
|---|---|
| 需求澄清 | 先问清目的、约束、成功标准,避免基于模糊需求乱改 |
| 方案设计 / 计划编写 | 列出可选方案与权衡,产出可执行计划再动手 |
| TDD | 先写测试再实现,约束「看起来能跑」的实现 |
| 系统化调试 | 复现 → 定位根因 → 修复 → 回归测试,而非凭直觉乱试补丁 |
| 完成前验证 | 收尾前必须运行测试 / 构建 / lint,不说「应该好了」 |
| 代码审查与反馈处理 | 验证审查建议是否适用本代码库,而非盲目附和 |
| 分支收尾 | 规范提交、合并与分支清理 |
| 并行子智能体 / Git Worktree | 用子代理与 worktree 并行推进多任务 |
| 中国特色 Skills | 4 个中国原创(chinese-code-review / chinese-git-workflow / chinese-documentation / chinese-commit-conventions,需 /chinese-* 手动调用)+ 2 个上游历史保留(MCP 构建器 / 工作流执行器) |
using-superpowers 是入口型 Skill:引导 AI 在合适时机发现并加载其余技能。
典型工作流
1. npx superpowers-zh # 为你的 AI 工具安装中文方法论 Skills
2. 在 AI 工具中提出任务 → AI 先加载「需求澄清」Skill,问清目标与约束
3. 进入「方案设计 / 计划」Skill,产出方案与计划
4. 用「TDD」Skill 先写测试,再实现
5. 出 Bug 时走「系统化调试」Skill:复现→根因→修复→回归
6. 收尾用「完成前验证」运行测试/构建/lint,再用「代码审查」「分支收尾」收口
常见问题(FAQ)
| 问题 | 解决 |
|---|---|
| 它是模型或插件吗 | 都不是,是一套被 AI 加载的「方法论 Skills」,约束 AI 的工作流程 |
| 支持哪些工具 | Claude Code、Copilot CLI、Cursor、OpenCode、OpenClaw、DeepSeek Harness、Hermes Agent、Windsurf、Kiro、Gemini CLI、Codex、Aider、Qoder、Trae 等 26 款 |
| 和英文 superpowers 区别 | 完整汉化 + 4 个中国原创 skills(中文代码审查 / Git 工作流 / 技术文档 / 提交规范),共 21 个 skills;上游英文版只有 6 款工具适配,中文版扩到 26 款 |
| 安装要求 | Node.js ≥ 20,npx superpowers-zh 一键安装 |
| 只装到某个工具 | npx superpowers-zh --tool <name> 显式指定;装到全局用户目录加 --global(如 --global --tool hermes 写 ~/.hermes/skills/) |
| 技能装到哪了 | 按工具不同:Claude Code .claude/skills/、Cursor .cursor/skills/、Codex .agents/skills/、Gemini .gemini/skills/、Hermes ~/.hermes/skills/ 等 |
| AI 不触发 Skill | 确认工具支持 Skill 发现/自定义指令,并已写入对应配置;从 using-superpowers 入口引导 |
| 能和编码 Agent 一起用吗 | 可以,常与 OpenCode / Hermes Agent / Claude Code 搭配,作为「工作方式约束层」 |
AI 使用建议
- 用户提到「让 AI 先澄清需求再写代码」「中文 TDD / 代码审查方法论」「superpowers 中文版」「AI 编程工作流规范」时加载本技能。
- 它是方法论约束层,与具体编码工具(OpenCode、Claude Code、Hermes 等)正交,可叠加使用。
- 安装用
npx superpowers-zh(Node ≥ 20);强调「澄清→设计→计划→TDD→调试→验证→审查→收尾」闭环。 - 鼓励 AI 在动手前主动加载「需求澄清/计划」Skill,在收尾前加载「完成前验证」Skill。
相关技能
- opencode — 常被叠加使用的编码客户端之一:../opencode/SKILL.md
- hermes-agent — 终端 Agent,技能机制与记忆闭环可与之配合:../hermes-agent/SKILL.md
- pi — 另一款终端编码 Agent:../pi/SKILL.md
参考资源
- 仓库:https://github.com/jnMetaCode/superpowers-zh
- 英文上游 obra/superpowers:https://github.com/obra/superpowers
- 上游中文教程:https://znlgis.github.io/(ai/superpowers-zh 系列)