jnMetaCode/superpowers-zh

⭐ 2,419  ·  Shell  ·  GitHub 仓库

🦸 AI 编程超能力 · 中文增强版 — superpowers（116k+ ⭐）完整汉化 + 6 个中国原创技能，让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 16 款 AI 编程工具真正具备实用能力。

agent-skills agentic-coding ai-coding chinese claude-code code-review cursor gemini-cli

一句话总结

为中文开发者本地化拥有 116k 星标的 superpowers 框架，新增 6 项原创技能，并支持在 17 款 AI 编码工具中一键安装。

🔥 核心能力与独特卖点

• 20 项技能的完整中文本地化： 将上游全部 14 项技能（头脑风暴、TDD、调试、代码审查等）翻译为中文，同时保留英文技术术语。这消除了中文团队采用结构化 AI 工作流时的语言障碍。
• 6 项中国原创技能： 包括 chinese-code-review、chinese-git-workflow、chinese-documentation、chinese-commit-conventions、mcp-builder 和 workflow-runner。这些技能专为中国开发生态（Gitee、Coding）和团队沟通规范量身打造——这是任何西方分支都无法提供的。
• 一键通用安装： npx superpowers-zh 命令能自动检测你的项目使用哪款 AI 编码工具（Claude Code、Cursor、Windsurf 等），并将全部 20 项技能安装到正确目录。这彻底消除了同类框架中普遍存在的繁琐、易错的手动配置过程。
• 支持 17 款工具： 支持 Claude Code、Copilot CLI、Cursor、Windsurf、Gemini CLI、Trae、Qwen Code、Kiro 及其他 9 款工具——工具覆盖范围是上游项目的近 3 倍。无论你的团队最终选择哪款 AI 助手，这项能力都能保证方案的未来适用性。
• 系统化工作流强制： 强制 AI 代理遵循经过实战检验的结构化方法论（头脑风暴 → 规划 → TDD → 实现 → 审查）。这直接解决了困扰随意式提示工程的“AI 过早编码并产生幻觉”问题。

技术架构

组件	描述
包	npm 包（superpowers-zh），充当安装器 + 技能管理器
技能文件	Markdown (.md) 文件，包含每个工作流的结构化多步提示
检测引擎	通过扫描配置文件，自动检测项目的 AI 工具（Claude Code、Cursor 等）
安装机制	将技能 .md 文件复制到工具特定目录（例如 .claude/skills/）
引导文件	创建/更新 CLAUDE.md（或等效文件），该文件引用所有已安装的技能
卸载	--uninstall 标志可干净地撤销所有文件操作
上游同步	与 jnMetaCode/superpowers 保持分支关系，以便定期更新

该架构是基于文件且与工具无关的：它利用每个 AI 编码工具原生的技能加载机制，而不是构建专有运行时。这使得它轻量、可移植，并兼容任何能从项目目录读取 Markdown 指令的工具。

快速入门指南

# 步骤 1：进入你的项目目录
cd /your/project

# 步骤 2：一键安装（自动检测你的 AI 工具）
npx superpowers-zh

# 步骤 3：（可选）显式指定工具
npx superpowers-zh --tool copilot

# 卸载 / 清理
cd /your/project
npx superpowers-zh@latest --uninstall

就这么简单。安装器会检测你使用的是 Claude Code、Cursor、Windsurf、Copilot CLI 还是其他 17 款受支持的工具，然后将所有 20 个技能文件复制到正确的位置，并创建引导文件。

优点、缺点与用例

优点

• 通过强制结构化工作流（头脑风暴 → 规划 → TDD → 实现 → 审查），大幅减少 AI 幻觉和过早编码
• 在 17 款工具上实现一键安装——零手动配置
• 积极维护，具备上游同步和微信群社区支持
• 6 项中国原创技能，填补了 Gitee/Coding 工作流和中文团队沟通方面的实际空白

缺点

• 4 项 chinese-* 技能需要手动调用（/chinese-xxx），而非自动触发——用户必须记住激活它们
• 分支依赖：如果维护者同步滞后，可能落后于上游 superpowers 的更新
• 对简单任务过于刻板：对于只需快速提示即可完成的琐碎代码变更，结构化技能会增加额外开销

谁不应该使用？

• 纯英文团队，不需要中文本地化或 Gitee/Coding 工作流
• 偏好随意式提示，认为结构化工作流有束缚感的开发者
• 使用不受支持的 AI 编码工具的团队（例如，未使用 CLI 的 VS Code 版 GitHub Copilot，或自研内部代理）

理想用例

• 采用 Claude Code、Cursor 或 Copilot CLI 的中文软件团队，需要以母语使用结构化工作流
• 使用 Gitee 或 Coding 平台的团队，需要中文提交规范和代码审查标准
• 正在标准化 AI 编码工具的组织，希望在整个工程团队中推行一致、经过实战检验的工作流
• 对 AI 幻觉感到沮丧的开发者，希望强制代理在编写生产代码前进行规划和测试

社区与活跃度

该项目拥有 2,419 颗星标，并处于积极维护中（最后更新于 2026 年 5 月），势头强劲。它是拥有 116k+ 星标的 superpowers 项目的一个专业分支，但通过解决一个真实的痛点——让 AI 编码工具为中文开发者服务——开辟了自己的社区。维护者积极同步上游并运营基于微信的社区支持，这是长期可行性的强烈信号。支持 17 款工具（而上游仅支持 6 款）表明该项目正在其分支起源之外进行创新。