项目级安装不要在用户主目录（~）下执行，否则会污染所有项目；手动 cp -r skills 只是低保版安装，不会配置 hooks 和 bootstrap 引导；Claude Code 用 marketplace 和 npx 两种方式时，同一项目里不要重复安装，否则 skills 会出现两份
superpowers-zh
jnMetaCodeMIT活跃维护把 superpowers 这套 AI 编程技能包完整汉化，并额外加了 4 个中国原创 skills，让 Claude Code、Cursor 等 26 款 AI 编程工具在中文环境下真正能干活。
🦸 AI 编程超能力 · 中文增强版 — superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills，让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 26 款 AI 编程工具真正会干活
v1.7.14发布于 2026-09-28 23:30 UTC8,507star +16 / 7 天787fork同步于 2026-11-10 05:31 UTC
superpowers 的中文增强版，给 26 款 AI 编程工具装上系统化工作方法论
把 superpowers 这套 AI 编程技能包完整汉化，并额外加了 4 个中国原创 skills，让 Claude Code、Cursor 等 26 款 AI 编程工具在中文环境下真正能干活。
核心能力
- 完整汉化上游 15 个 skills，并新增 4 个中国原创 skills
- 一条 npx 命令自动识别项目里的 AI 工具并安装
- 支持项目级与全局两种安装，全局一次装好所有项目可用
- 提供 SessionStart 钩子，让 skill 在合适时机自动触发
- 覆盖 GitHub、Gitee、Coding、极狐 GitLab、CNB 等国内 Git 平台
容易踩的坑
内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README
- v1.7.14v1.7.14 — 同步上游 v6.4.2 + OpenCode 映射修复最新正式版2026-09-28 · 2026-09-28 23:30 UTC
同步上游 v6.4.2（含 v6.4.1），OpenCode 用户尤其建议更新。 对应 #133、#131。
✨ 新 skill：diagnosing-superpowers（第 21 个）
会话跑偏时——重复劳动、无视计划、太慢、太贵、某个技能没触发——让它读磁盘上的会话记录，按 7 个维度并行分析，出一份每条结论都带
path:line的报告；需要时整理成 issue、打包脱敏材料。它只报告发生了什么，不替你诊断 skill 本身。与上游唯一的有意偏离：issue 目标是本仓
jnMetaCode/superpowers-zh，不是 obra/superpowers——你跑的是译文，问题先在这里分流，确认是上游行为再转报。🔁 executing-plans 重写：内联执行
从「单独会话 + 检查点」改成在当前会话里自己当实现者：
task-start取简报和 BASE，task-done跑测试、只有通过才记账本，最后派一个最强模型做整分支审查。与 SDD 共用工作区和账本，中途可以换执行方式。遇到计划缺陷自己裁决并记账，只有 4 类硬停止。旧版里本 fork 自加的「常见异常处理」（计划有误就停下问）与此直接冲突，已删除。
✂️ writing-plans：更短的计划
- 步骤只写实现者无法自己决定的东西：签名、文件、规格取值、测试断言；函数体由实现者写
- 新增「审查重点」：规格隐含、但没有测试覆盖的 5 个最可能伤人的输入，交给最终审查逐条检查
- 自检新增「比例」：计划比规格长好几倍，就是把程序抄了一遍
- 执行交接改为「子代理驱动 / 原生执行」二选一，并要求先审阅计划
其他上游变更
- brainstorming：「建立共同理解」——先弄清意图并写回给你确认；HARD-GATE 按路径细分（架构级：设计批准只许写规格，规格批准只许写计划）
- code-reviewer：规格是愿景文档，规格没提的行为按正常人的期待来判；列出「不予判断的项」交执行者裁决
- TDD：宣称完成前跑整个项目测试套件，看到的失败必须写进报告
- SDD：
sdd-workspace解决同名计划（docs/a/plan.mdvsdocs/b/plan.md）共用工作区的问题；review-package拒绝空区间和非后代 HEAD - 技能自带脚本一律经解释器调用（
bash scripts/…）——有些插件打包器会去掉可执行位 - 新增 Claude Code、Muse 工具参考；SessionStart hook 支持 Muse
🐛 OpenCode 工具映射过期（#131）
插件还停在 v5.0.7：告诉模型用
@mention派子代理——那是 TUI 里用户的输入方式，模型没有这个工具。现已换成上游 v6.4.2 插件：V1 映射到task+subagent_type，V2（OpenCode 2.0.4+）映射到subagent，并通过setup()原生注册 skill；新增根目录index.js供 V2 目录形式加载。安装文档同步更新。🐛 visual-companion.md 一直是旧版
中文版比 v6.3.0 还旧：教你读
$SCREEN_DIR/.server-info，而实际脚本写的是$STATE_DIR/server-info；缺--open、会话 key、4 小时空闲超时等说明。标题数没变，所以 audit 看不出来。已整篇按上游重译。已知问题（上游未修，原样同步）
task-done在测试命令完全没有输出时会误判失败（上游 #2385）task-done账本记的是日志最后一行，node --test会记成# duration_ms …（上游 #2342）
npx superpowers-zh@latest - v1.7.1v1.7.1 — subagent-driven-development 对齐上游 v6 重写2026-07-17 · 2026-07-17 13:16 UTC
查看更新说明
v1.7.1 — subagent-driven-development 对齐上游 v6 重写
此前
subagent-driven-development仍停留在上游 v5 的双审查者架构，未跟上 v6 重写（issue #89）。本版补齐：变更
- 双审查者合并：规格审查 + 代码质量审查合并为单个
task-reviewer-prompt.md，审查者一次读 diff 出两个结论 - 新增
scripts/：review-package：为每个任务生成独立审查包（按记录的 BASE，不用HEAD~1，避免多提交任务丢提交）sdd-workspace：工作树内的临时文件区task-brief：从计划抽取单任务简报
SKILL.md/implementer-prompt.md补齐 v6 契约：简报文件 + 报告文件交接、model 必填、TDD RED/GREEN 证据、持久化进度账本（ledger）、起飞前计划审查- 删除 v5 遗留的
spec-reviewer-prompt.md/code-quality-reviewer-prompt.md
中文适配
task-brief正则增强，同时识别英文## Task N与中文### 任务 N：…，使本仓库writing-plans产出的中文计划也能正常抽取任务review-package/sdd-workspace与上游逐字节一致
验证
- 三个脚本端到端功能测试通过（中文/英文抽取、任务边界隔离、多提交 diff 完整性、错误码）
scripts/audit.sh全量审计通过、CI 全绿- 9 任务真实多智能体 eval 全流程正常（review-package 各任务独立 BASE、进度账本、brief/report 交接、每任务审查循环）
对应 #89 反馈的缺口，随本版发布。
- 双审查者合并：规格审查 + 代码质量审查合并为单个
- v1.7.0v1.7.0 — 全局安装 + CodeBuddy/CodeArts + 繁体站2026-07-13 · 2026-07-13 21:31 UTC
查看更新说明
npx superpowers-zh现在已是 v1.7.0。一条命令为 20 款 AI 编程工具装上系统化工作方法论。✨ 本版亮点
🌍 全局安装
--global（关 #21）一次安装、所有项目共享，解决多项目用户逐个项目重复装的痛点。
npx superpowers-zh --global # 自动检测已装工具 npx superpowers-zh --global --tool claude # 或指定工具- 项目级（默认）优先、全局兜底，二者可共存；
--global --uninstall对称卸载。 - 支持全局的 7 款工具均逐一核对各工具文档声明的真实加载路径（Claude Code / Codex CLI / Qoder / Windsurf / Qwen Code / OpenClaw / OpenCode）。其中 Codex 全局装到
~/.agents/skills（其实际扫描目录）。 - Gemini / Antigravity 有各自专属全局方式、其余工具规则为项目级 ——
--global明确报错引导，绝不写「装了不生效」的无效路径。
🆕 新增 2 款国产 IDE（工具数 18 → 20）
- CodeBuddy（腾讯 AI IDE，关 #18/#75）：
.codebuddy/skills/+CODEBUDDY.md - 华为云码道 CodeArts（关 #20）：
.codeartsdoer/skills/（skills-only）
🌐 官网 + README 新增繁体中文
- 官网重构为多语言架构，新增 繁体站（zh-Hant，63 页）+ 语言切换/hreflang/sitemap
- README 加语言切换栏 + 完整
README.zh-Hant.md（台港自然术语，手写不靠 OpenCC）
🧹 其他
- 官网下架赞助商展示（仅留联系方式），切自定义域名
sp.aiolaola.com - 上游 star 数刷新 233k → 250k
📦 安装
npx superpowers-zh # 项目级 npx superpowers-zh --global # 全局（所有项目共享）完整变更：见 RELEASE-NOTES.zh.md
- 项目级（默认）优先、全局兜底，二者可共存；
- v1.6.0v1.6.0 — 对齐上游 v6.0.0 + Kimi/Pi harness 支持2026-06-20 · 2026-06-20 02:19 UTC
查看更新说明
本版本对齐上游 v6.0.0 的实质 skill/基础设施变更，并新增两款 harness 支持。
npx superpowers-zh已可获取。🆕 新增 harness 支持
- Kimi Code（#59，关 #37）— 插件清单
.kimi-plugin/plugin.json，/plugins install https://github.com/jnMetaCode/superpowers-zh，详见docs/README.kimi.md - Pi (oh-my-pi)（#60，关 #44）—
package.json的pi字段 +.pi/extensions/superpowers.ts，详见docs/README.pi.md
🔒 brainstorm 安全模型（#58，上游 v6.0.0）
可视化伴侣服务器改为每会话密钥鉴权（
?key=/会话 cookie 门禁所有端点）+ 安全响应头（X-Frame-Options DENY、CSP frame-ancestors none、CORP same-origin），修复旧版无鉴权缺口。Token 用crypto.randomBytes(32)+timingSafeEqual，token 文件0o600。🔧 其它 v6 同步
- using-git-worktrees / finishing-a-development-branch — 移除废弃全局 worktree 目录（#57）
- hooks/session-start — 移除 legacy 迁移警告，输出补
| cat（#58） - executing-plans — "持续自查" 替代 "每3任务暂停审查"
- opencode 测试修复（#72）
SDD v6 重写为性能/成本优化，需专门 eval，本版本未纳入（见 #19）。
完整发布说明： RELEASE-NOTES.zh.md
- Kimi Code（#59，关 #37）— 插件清单
- v1.3.0v1.3.0 — 跟上游 v5.1.0 对齐 + 修 marketplace.json drift2026-05-10 · 2026-05-10 14:57 UTC
查看更新说明
v1.3.0 (2026-05-10)
跟上游对齐 (v5.1.0)
- 同步上游 v5.1.0 的目录变更：上游主动删除了
commands/（3 个 deprecated stub）和agents/code-reviewer.md（已上升进requesting-code-reviewskill）。中文 fork 跟随删除以与上游意图对齐。详见上游 #1188 与 PR #1299。 bin/superpowers-zh.js移除安装时复制agents/到.claude/agents/的逻辑，保留 uninstall 时的清理逻辑（用于已装用户清理残留code-reviewer.md，防止双 source of truth）。.github/workflows/ci.yml删除 "Validate agents" 验证段（agents/已删，验证空目录无意义）。
补齐上游遗漏的根级文件
CLAUDE.md—— 上游 contributor 指南（含 anti-slop-PR 规则）的中文翻译，末尾追加中文 fork 自己的 PR 流程说明。AGENTS.md—— 软链接 →CLAUDE.md（mode 120000，跟上游一致）。Codex CLI 等工具从AGENTS.md自动加载等同读取 CLAUDE.md。- Known limitation：
npm pack默认不跟随 symlink，因此 npm publish 出来的 tarball 不包含 AGENTS.md。这不影响实际使用：AGENTS.md 是 Codex CLI 在用户自己项目目录读的文件，不是从superpowers-zh安装包读的；通过git clone拿到仓库的贡献者会正确解析 symlink。
- Known limitation：
RELEASE-NOTES.md—— 上游 release notes 原样保留（英文版，1180 行）。RELEASE-NOTES.zh.md—— 本文件，中文 fork 自身 release 记录。.codex-plugin/plugin.json—— Codex CLI plugin manifest（中文版本地化：name/description/displayName 改为中文版，URL 指向jnMetaCode/superpowers-zh）。.version-bump.json—— 上游版本管理配置文件。scripts/bump-version.sh—— 上游版本同步脚本（含--check漂移检测、--audit仓库审计）。中文版 npm version 钩子继续用scripts/sync-plugin-version.js，bump-version.sh 作为补充工具引入。assets/app-icon.png+assets/superpowers-small.svg—— Codex marketplace 需要的图标资产。- 4 个新增上游测试：
tests/claude-code/test-requesting-code-review.sh、tests/claude-code/test-worktree-native-preference.sh、tests/opencode/test-bootstrap-caching.{mjs,sh}。
主动修复上游 v5.1.0 的疏忽
.cursor-plugin/plugin.json删除 dangling 的"agents": "./agents/"和"commands": "./commands/"两行。上游 v5.1.0 删了目录但忘了同步清理 manifest（git blame 显示这两行从 2026-02-13 加入后从未更新）。中文 fork 主动修掉（向上游开 issue 是后续动作）。
修中文版自己的老漂移（PR #23）
.claude-plugin/marketplace.json的plugins[0].version卡在1.1.8的老漂移修复（追上其他 4 个 manifest，1.3.0 release 时统一升到 1.3.0）。原因是中文版简化版sync-plugin-version.js之前只 match 顶层"version":字段，跳过嵌套位置；导致 Claude Code marketplace 用户看到的 plugin 版本一直停在 1.1.8，跟 npm 包真实版本不同步。scripts/sync-plugin-version.js增强为支持嵌套字段路径（plugins.0.version）。TARGETS改为对象数组{ path, field }，对齐上游.version-bump.json格式。仍使用 regex 替换而非 JSON re-stringify，保留原文件格式（缩进、行内/多行数组等不被破坏）。
不引入
- 上游
scripts/sync-to-codex-plugin.sh（推 OpenAI Codex marketplace 用，硬编码prime-radiant-inc/openai-codex-plugins，中文版用不上） - 配套测试
tests/codex-plugin-sync/test-sync-to-codex-plugin.sh
不动（中文版叠加层全部保留）
bin/+ npx 流程、docs/中文工具文档、4 个chinese-*skill、mcp-builder、workflow-runner、README.md主推 npx 路径、.codex/INSTALL.md、.opencode/INSTALL.md、.gemini/、scripts/sync-plugin-version.js—— 这些是符合"保持上游主流程不变 + 中文版叠加新增"原则的中文 fork 沉淀，全部保留。 - 同步上游 v5.1.0 的目录变更：上游主动删除了
用户点评
登录用户的真实使用记录，可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
superpowers-zh（AI 编程超能力 · 中文增强版）
🌐 简体中文 | 繁體中文 | English (upstream)
🦸 superpowers（300k+ ⭐）完整汉化 + 4 个中国原创 skills — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 26 款 AI 编程工具真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
Chinese community edition of superpowers — 21 skills across 26 AI coding tools, including full translations and China-specific development skills.
📖 免费配套学习 → 从零学会 AI 编程（182 节）＋ 从零构建 AI 智能体（40 节）：两门免费实操课 + 实战社区，superpowers 装好后配上方法论效率翻倍（站上共 14 门课、700 节，全部 ¥0——另有 大模型原理 / AI 绘画 / 写小说 / 漫剧 / 量化 / DeepSeek / 深度专注 等）
🧠 新：让 Claude Code / Codex / Cursor / Gemini CLI 不再失忆 → engram：一条
npx @jnmetacode/engram install，自动记住每次会话问过什么、改了哪些文件、最后怎么解决的，下次开会话自动带回（带出处）。记忆跨工具共享——Codex 里定的事，Claude Code 也知道。全本地、零依赖、中文友好。
📊 项目规模
| 📦 翻译 Skills | 🇨🇳 中国原创 Skills | 🤖 支持工具 |
|---|---|---|
| 15 | 4另有 2 个上游历史保留 | 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 / Qoder / CodeBuddy（腾讯）/ CodeArts（华为云码道）/ Cline / Kilo Code / Crush |
❤️ 赞助商 🙏 想出现在这里？联系 [email protected] 赞助
感谢 APINEBULA 大屏赞助本项目！APINEBULA 是银河录像局旗下的企业级 AI 聚合平台，背靠大平台资源，面向开发者、团队与企业用户提供稳定、高性价比的大模型 API 接入服务。平台聚合 Claude、GPT、Gemini 等主流满血模型，一个接口接入全球顶尖 AI 大模型，各大模型价格低至 1 折起，支持企业级高并发、正式合同、对公打款与开票服务，适合 AI 编程、Agent 开发、业务系统集成等多种场景！
🎁 通过此链接注册并在充值时填写 agent 优惠码可享 9 折优惠！
88API Token聚合平台 🧠 聚合 GPT、Claude、Gemini、Grok、DeepSeek、Kimi、GLM 等语言与编程模型； 🎨 图片模型：GPT-Image、Gemini、Grok 等； 🎬 视频模型：Seedance、Veo、MiniMax H3、Kling、Grok 等； 🎙️ 语音能力：Whisper、TTS 等。从文案、出图、改图，到视频生成与配音 🎁新用户注册送体验额度，可以检测模型能力。站内有人工客服值守！ 👉香港正规企业运营 稳定供应 全绿满血 不降智 提供发票
感谢 Cubence 对本项目的支持。Cubence 是一家致力为客户提供稳定、高效的 API 中转服务商。从 25 年 9 月运营至今，提供了 Claude Code、Codex、Gemini 等多种模型支持。🎁 Cubence 为本开源项目的用户提供了特别的专属优惠码 AGENCY，通过此链接注册的用户，首次购买即可享受 9 折优惠！
感谢 字节火山引擎 赞助本项目！火山方舟 Agent/Coding Plan 国模套餐首购 9.9，支持 GLM-5.3、Kimi-K3、DeepSeek、MiniMax、Doubao 等，注册免费领 2500w Token，统一 API，适配编码与智能体开发。👉 立即前往
感谢 Infistar.cc 无限星河 赞助并为 superpowers-zh 用户提供模型服务支持！无限星河提供高可用模型通道与多节点冗余，一个 API Key 接入 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek 等模型，价格低至官方渠道 1 折，并适配 Claude Code、Codex、Cursor、Windsurf、Kiro 等 AI 编程工具。🎁 通过此链接注册并完成首次调用，即可领取 5 美元等值测试额度！
这是什么？
superpowers 是目前最火的 AI 编程 skills 框架（300k+ stars），为 AI 编程工具提供系统化的工作方法论。
superpowers-zh 在完整翻译的基础上，新增了面向中国开发者的特色 skills。
没装 superpowers-zh：
你：给用户模块加个批量导出功能
AI：好的，我来实现...（直接开始写代码）
export async function exportUsers() { ... }
你：等等，格式不对，没分页，大数据量会 OOM...
装了 superpowers-zh：
你：给用户模块加个批量导出功能
AI：在开始实现之前，我需要了解几个关键问题：
1. 导出格式是 CSV 还是 Excel？
2. 预计数据量多大？需要异步处理吗？
3. 有权限要求吗？
→ 给出 2-3 个方案，确认后再动手
🆚 与英文上游的区别（老被问，一次说清）
| 维度 | superpowers（英文上游） | superpowers-zh（中文增强版） |
|---|---|---|
| ⭐ Star 数 | 300k+ | — |
| 📦 Skills 总数 | 15 | 21（15 翻译 + 4 国产原创 + 2 上游历史保留） |
| 🌐 语言 | 英文 | 中文（技术术语保留英文） |
| 🤖 支持工具 | 6 款：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | 26 款：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code / OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（腾讯） / CodeArts（华为云码道） / Cline / Kilo Code / Crush / ZCode（智谱）/ DeepSeek Harness / Reasonix |
| ⚡ 安装方式 | 按工具分别装（每款一条不同的 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 内的增量 | — | using-superpowers 保留显式标注的「中国特色技能路由」；brainstorming 补充「你看着办 / 你定吧」不等于跳过流程的中文语境说明，依据与 eval 范围见 v1.8.0 更新日志。executing-plans 原有「常见异常处理」已于 v1.7.14 删除，避免与上游内联执行流程冲突。 |
| 🔄 版本跟进 | 独立迭代 | 同步上游 + 国产增量叠加 |
| 🤝 接受新 skill PR | 一般不接受（原文："we don't generally accept contributions of new skills"） | 欢迎 PR（中国开发者痛点优先） |
| 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 |
| 📜 License | MIT | MIT |
一句话总结： 英文上游 = 方法论内核；中文增强版 = 方法论内核 + 26 款工具一键适配 + 国内 Git/CI 生态 + 中文化表达习惯。
🤖 支持 26 款主流 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 --global --tool hermes | ~/.hermes/skills/ |
| Cursor | IDE | npx superpowers-zh | .cursor/skills/ |
| Windsurf | IDE | npx superpowers-zh | .windsurf/skills/（全局 ~/.codeium/windsurf/skills/） |
| Kiro | IDE | npx superpowers-zh | .kiro/skills/ |
| Gemini CLI | CLI | npx superpowers-zh | .gemini/skills/ |
| Codex CLI | CLI | npx superpowers-zh | .agents/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/ + .github/instructions/ |
| DeerFlow 2.0 | Agent 框架 | npx superpowers-zh | skills/custom/ |
| OpenCode | CLI | npx superpowers-zh | .opencode/skills/ |
| OpenClaw | CLI | npx superpowers-zh | skills/ |
| Qwen Code | CLI | npx superpowers-zh | .qwen/skills/ + QWEN.md |
| Antigravity | IDE | 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/ |
| CodeBuddy (腾讯 AI IDE) | IDE | npx superpowers-zh | .codebuddy/skills/ + CODEBUDDY.md |
| 华为云码道 CodeArts | IDE | npx superpowers-zh | .codeartsdoer/skills/ |
| Cline | IDE 插件 | npx superpowers-zh --tool cline | .cline/skills/ + .clinerules/ |
| Kilo Code | IDE 插件 | npx superpowers-zh --tool kilocode | .kilocode/skills/ + .kilocode/rules/ |
| Crush | CLI | npx superpowers-zh | .crush/skills/ |
| ZCode (智谱 ADE) | IDE | npx superpowers-zh --global --tool zcode | ~/.zcode/skills/（仅全局，项目级路径官方未公开） |
| DeepSeek Harness (dsh) | CLI | npx superpowers-zh | .dsh/skills/ + AGENTS.md |
| Reasonix | CLI | npx superpowers-zh | .reasonix/skills/ + REASONIX.md（全局 Windows 为 %APPDATA%\reasonix\skills） |
运行
npx superpowers-zh会自动检测你项目中使用的工具，将 21 个 skills 安装到正确位置。
翻译的 Skills（15 个）
| Skill | 用途 |
|---|---|
| 头脑风暴 (brainstorming) | 需求分析 → 设计规格，不写代码先想清楚 |
| 编写计划 (writing-plans) | 把规格拆成可执行的实施步骤 |
| 执行计划 (executing-plans) | 按计划逐步实施，每步验证 |
| 测试驱动开发 (test-driven-development) | 严格 TDD：先写测试，再写代码 |
| 系统化调试 (systematic-debugging) | 四阶段调试法：定位→分析→假设→修复 |
| 诊断 Superpowers (diagnosing-superpowers) | 会话跑偏时读 transcript 取证，每条结论带 path:line，可整理成 issue |
| 请求代码审查 (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（4 个）· 上游历史保留（2 个）
⚠️ 下表前 4 个 chinese-* 为「手动调用」skill——不会自动触发，需在对话中显式输入
/chinese-xxx才会加载。 设计为参考资料而非工作流，避免污染上游 skill 的自动调度（如requesting-code-review、brainstorming等）。⚠️ 表格最后两个（mcp-builder / workflow-runner）不是中国原创 —— 它们来自上游，上游后来移除了，本 fork 保留下来继续维护。全仓 21 个 skill = 15 翻译 + 4 中国原创 + 2 上游历史保留。
| 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 工作流 | 自动 | 曾有，上游已移除 |
快速开始
方式一：npm 安装（推荐）
项目级（默认，装到当前项目）：
cd /your/project
npx superpowers-zh
⚠️ 项目级安装不要在主目录（
~）下跑。v1.2.1 起会拒绝并提示，老版本会把 skills 和CLAUDE.md等 bootstrap 文件写到你的 home 目录，污染所有项目。如已误装见下文「卸载 / 误装清理」。想让 skills 对所有项目生效，请用下面的全局安装，而不是在~下跑项目级。
全局安装（v1.7.0+，装到用户目录，所有项目共享，适合同时维护多个项目）：
npx superpowers-zh --global # 自动检测已装工具
npx superpowers-zh --global --tool claude # 或指定工具
全局安装把 skills 装到工具的用户级目录（如 ~/.claude/skills），一次安装所有项目自动可用，更新时也只需重装一次。项目级优先、全局兜底，二者可共存。
支持通用全局安装的工具（均为 docs 已证实的用户级加载路径）：Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush · Hermes Agent · CodeBuddy · CodeArts · ZCode · DeepSeek Harness · Reasonix。其中 Codex CLI 全局装到 ~/.agents/skills（Codex 启动扫描目录）；Crush 在 Windows 上装到 %LOCALAPPDATA%\crush\skills（其 README 明确 Windows 走这里，不是 ~/.config）。其余工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Claw / Cline / Kilo Code）规则是项目级或存于应用内设置，--global 会提示改用项目级；Gemini CLI / Antigravity 有各自专属的全局方式（Gemini 走扩展目录），见对应 docs/README.*.md。
| 项目级（默认） | 全局（--global） | |
|---|---|---|
| 安装位置 | <项目>/.claude/skills 等 | ~/.claude/skills 等用户级目录 |
| 生效范围 | 仅当前项目 | 所有项目 |
| 适合 | 单项目、需项目内版本固定 | 多项目、想一次装好到处可用 |
| 卸载 | npx superpowers-zh --uninstall | npx superpowers-zh --global --uninstall |
方式二：Claude Code Plugin Marketplace
仅限 Claude Code。 走官方 plugin 机制装，好处是升级只要一条 claude plugin update，不用重跑 npx：
claude plugin marketplace add jnMetaCode/superpowers-zh
claude plugin install superpowers-zh@superpowers-zh
装完 claude plugin list 应该看到：
❯ superpowers-zh@superpowers-zh
Version: <当前版本>
Scope: user
Status: ✔ enabled
升级与卸载：
claude plugin marketplace update superpowers-zh # 先刷新 marketplace 缓存
claude plugin update superpowers-zh@superpowers-zh # 再升级 plugin（需重启生效）
claude plugin uninstall superpowers-zh@superpowers-zh # 卸载
和方式一怎么选？ marketplace 装的是完整 plugin（skills + hooks + bootstrap 由 Claude Code 统一托管、随版本更新），但只服务 Claude Code 一款工具。要装给其余 25 款工具，仍然用方式一的
npx superpowers-zh。两者可以共存，但同一个项目里别重复装 Claude Code，否则 skills 会出现两份。
方式三：手动安装（low-fidelity，仅作备选）
⚠️ 手动
cp -r skills是低保版安装，不等同于完整 plugin。superpowers-zh 是一个完整 plugin，包含：
skills/（21 个能力）+hooks/（SessionStart 钩子，让 skill 在合适时机自动触发）+CLAUDE.md/GEMINI.md等 bootstrap 引导文件 + 4 套 plugin manifest（Claude Code / Cursor / Codex / Marketplace）。下面的
cp -r skills命令只复制 skills 目录，不会自动配置 hooks、不会生成 bootstrap 引导。结果：skills 物理上存在，但 AI 不会在合适时机自动调用，需要你每次手动喊 "use brainstorming skill" 之类。强烈推荐用方式一
npx superpowers-zh—— 它会一键处理 skills 复制 + bootstrap 生成 + hooks 配置 + 工具特定适配。仅在 npx 不可用（极端无网络环境）时才退到手动。
# 克隆仓库
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/skills # 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/.agents # 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 版）
cp -r superpowers-zh/skills /your/project/.qoder/skills # Qoder（阿里 AI IDE）
方式四：在配置文件中引用
根据你使用的工具，在对应配置文件中引用 skills：
| 工具 | 配置文件 | 说明 |
|---|---|---|
| Claude Code | CLAUDE.md | 项目根目录 |
| Copilot CLI | CLAUDE.md | 与 Claude Code 共用插件格式 |
| Hermes Agent | HERMES.md 或 .hermes.md | 项目根目录，安装时自动生成 |
| Kiro | .kiro/steering/superpowers-zh.md（索引，inclusion: always）+ .kiro/skills/ | steering 每轮常驻，故只放索引 |
| DeerFlow 2.0 | skills/custom/*/SKILL.md | 字节跳动开源 SuperAgent，自动发现自定义 skills |
| Trae | .trae/rules/project_rules.md | 项目级规则 |
| Antigravity | GEMINI.md 或 AGENTS.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 + QWEN.md | skills 自动发现；QWEN.md 是官方分层记忆的默认上下文文件 |
| Claw Code | .claw/skills/*/SKILL.md | Rust 版 CLI agent，兼容 Claude Code 的 SKILL.md 格式 |
| Qoder | .qoder/skills/*/SKILL.md + .qoder/rules/superpowers-zh.md | 阿里 AI IDE，自动生成 trigger: always_on 的 bootstrap rule |
详细安装指南：Kiro · DeerFlow · Trae · Antigravity · VS Code · Codex · OpenCode · OpenClaw · Windsurf · Gemini CLI · Aider · Qwen Code · Hermes Agent · Claw Code · Qoder · CodeBuddy · 华为云码道 · Kimi Code · Pi · Cline · Kilo Code · Crush
卸载 / 误装清理（v1.2.1+）
cd /your/project # 或 cd ~ 如果误装到了主目录
npx superpowers-zh@latest --uninstall
会做这些：
- 删除所有装过的 skill 目录（
.claude/skills/、.trae/skills/等） - 删除独立 bootstrap 文件（
.trae/rules/superpowers-zh.md、.qoder/rules/superpowers-zh.md、.agents/rules.md） - 清理追加到
CLAUDE.md/HERMES.md/GEMINI.md/CONVENTIONS.md里的 superpowers-zh 段，保留你自己写的内容
数据安全说明：v1.2.1 起，安装会把追加内容包在 <!-- superpowers-zh:begin/end --> 哨兵注释之间，卸载按哨兵精确切除。识别不可靠时跳过 + 警告，绝不会误删用户内容。
其他参数：
| 参数 | 用途 |
|---|---|
--tool <name> | 自动检测不到时显式指定（cursor / trae / hermes / 等） |
--force | 允许在主目录(~)安装（默认拒绝，不建议） |
--uninstall | 卸载当前目录下的 superpowers-zh |
--help / --version | 帮助 / 版本 |
版本号怎么看？ skill 文件里的
version: "1.0.0"目前不会随发版更新；npx superpowers-zh --version显示本次运行的安装器版本，也不代表项目此前安装的技能版本。按安装方式核对与更新，见版本号与安装内容核对。
贡献
欢迎参与！翻译改进、新增 skills、Bug 修复都可以。
贡献方向
我们只接收符合 superpowers 定位的 skill——AI 编程工作流方法论。好的 skill 应该：
- 教 AI 助手怎么干活，而不是某个框架/语言的教程
- 解决上游英文版不覆盖的中国开发者痛点
- 有明确的步骤、检查清单、示例，AI 加载后能直接执行
欢迎提 Issue 讨论你的想法！
交流 · Community
微信公众号 「AI不止语」（微信搜索 AI_BuZhiYu）— 技术问答 · 项目更新 · 实战文章
| 渠道 | 加入方式 |
|---|---|
| QQ 2群 | 点击加入（群号 1071280067） |
| 微信群 | 关注公众号后回复「群」获取入群方式 |
🌟 相关项目生态
九个项目组合使用，覆盖 AI 编程 + AI 视频创作 + 桌面陪伴的完整链路。
| 项目 | 定位 | 一句话 |
|---|---|---|
superpowers-zh（本项目）  | 🧠 工作方法论 | 21 个 skills 教 AI 怎么干活（TDD / 调试 / 代码审查等） |
agency-agents-zh  | 🎭 专家角色库 | 277 个即插即用 AI 专家，含 64 中国原创（小红书 / 抖音 / 飞书 / 钉钉 / Qt 上位机 / 机械设计） |
agency-orchestrator  | 🚀 编排引擎 | 一句话 → 276 专家协作，几分钟出方案（15 种大模型 / 11 种免 key） |
| ai-coding-guide | 📖 实战教程 | 66 个 Claude Code 技巧 + 10 款工具最佳实践 + 配置模板 |
| shellward | 🛡️ 安全中间件 | 8 层防御 + DLP 数据流 + 注入检测，零依赖（含 MCP Server） |
| 🆕 ai-shortfilm-prompts | 🎬 视频提示词 | Mx-Shell《丧尸清道夫》5 段式方法论 + Skill，Seedance / 小云雀 / Sora / 可灵 / 即梦通用 |
| 🆕 local-agent-toolkit | 🛠️ Agent 本地三件套 | 给 agent 配上记忆 / 技能管理 / 运行追踪，零依赖、数据不出本机；本仓库 skills 可用 npx @jnmetacode/skillet add jnMetaCode/superpowers-zh/skills/<名称> 一键安装 |
| 🆕 codepet | 🐾 桌面养成桌宠 | 码宠 CodePet —— 你写代码 / 用 Claude Code，它就涨经验、升级、换状态、跳舞。全本地、隐私优先、开源 |
| 🆕 openshorts | 🎥 短视频生产线 | 开片 —— 文案进，成片出：脚本 / 配音 / 字幕 / 成片 / 发布包一条龙，0 元 0 key 跑通第一条，本地优先 |
🔥 重点推荐：agency-orchestrator — 一句话调度 276 个 AI 专家协作，几分钟交付完整方案
以前写个方案：你当指挥官，把 AI 轮流扮演 5 个角色，复制粘贴 10 次，1 小时没了。
现在： 丢一句话进去 "做一个电商退款流程"，产品 → 架构 → 安全 → 测试 → DBA 自动接力，几分钟完整方案落地。
- 🎭 276+ 专家角色（含 64 个中国市场原创：小红书 / 抖音 / 微信 / 飞书 / 钉钉）
- 🧩 零代码 YAML，一行 prompt 就能跑
- 💰 15 种大模型可选（DeepSeek / Claude / OpenAI / Ollama 等，11 种免 key）
- 🔗 与 superpowers-zh 互补：本项目管"怎么做"（方法论），orchestrator 管"谁来做"（角色协作）
致谢
- 原始英文版：obra/superpowers（MIT 协议）
- 感谢 @obra 创建了这个优秀的项目
许可证
MIT License — 自由使用，商业或个人均可。
📌 最近更新
🆕 v1.7.12 更新亮点 —— 通过 Claude Code 插件市场安装的用户请更新（此前技能之间互相调用会失败）：
- 🐛 插件模式下跨技能调用全部失败（#124）—— 正文照抄了上游的
superpowers:前缀，而本插件叫superpowers-zh，于是Skill("superpowers:systematic-debugging")返回 Unknown skill。32 处已改为裸技能名（两种分发模式都能解析）- 🐛 Crush 在 Windows 上装错目录 —— 官方是
%LOCALAPPDATA%\crush\skills，我们两个平台都装~/.config。文档早写对了，代码没跟上- 🐛 render-graphs.js —— 取上游的安全加固与 Windows 修复，但不跟它改 ESM（那会在 Node 20 的普通项目里直接加载失败）
- 🆕 新增 DeepSeek Harness 支持（#122）—— 项目级
.dsh/skills/+ 全局~/.dsh/skills/，引导写AGENTS.md；四条路径全部有官方出处- 🐛 在管理员 PowerShell 里跑会把 skills 装进
C:\Windows\System32（#125）—— 管理员终端的默认工作目录就是那里。补系统目录护栏，且不提供--force绕过- 🆕 新增 Reasonix 支持（#42）—— 项目级
.reasonix/skills/+REASONIX.md；Windows 全局是%APPDATA%\reasonix\skills，与 Unix 不同构- 🆕 新增 ZCode（智谱）支持（工具数 23 → 26）—— 只做全局安装：官方文档只公开了
~/.zcode/skills/，项目级是应用内 UI 导入、不暴露磁盘路径，所以项目级会被明确拒绝而不是猜路径装进去- 🛡️ 6 条新门禁（前缀回归、Windows 路径、卸载不误删用户文件、全局-only 工具项目级必拒、上游漂移计量…），
verify-release115 → 144📋 官网侧改动（版本提示条、22 份工具文档入口、结构化数据、分享大图、可访问性、sitemap…）见 完整 Release Notes →
🦸 AI 编程超能力：让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具真正会干活
📈 Star 趋势
claude-code
anthropics·TypeScript
终端里的智能编码助手，能理解你的代码库，用自然语言帮你执行日常任务、解释复杂代码、处理 git 工作流，让写代码更快。
编码助手+4编码 Agent
155119+29225kv2.1.3212026-11-10 02:29 UTC
cc-switch
farion1231·Rust
跨平台桌面客户端，把 Claude Code、Codex、OpenCode、DeepSeek Harness 等多个 AI 编程助手集中到一个界面里统一管理和切换，省去来回折腾配置。
AI 编程助手+4编码 Agent
153142+68610kv4.0.282026-11-10 02:19 UTC
caveman
JuliusBrussee·Go
给编码 Agent 用的代理和技能，让模型用「原始人式」极简表达回答，砍掉约 65% 的 token 消耗。
token 压缩+4编码 Agent
118706+6556.9kv4.1.02026-11-09 01:48 UTC
OpenHands
OpenHands·TypeScript
一个能自主写代码、改 bug、跑命令的 AI 开发代理，把大模型接入真实开发环境，让编码任务从对话直接落到执行。
编码代理+4编码 Agent
93072+21912kv1.37.02026-11-10 04:59 UTC