superpowers-zh

superpowers-zh(AI 编程超能力 · 中文增强版)

🌐 简体中文 | English (upstream)

🦸 superpowers(116k+ ⭐)完整汉化 — 让 Claude Code 和 Codex CLI 真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。

Chinese community edition of superpowers — 14 translated skills for Claude Code and Codex CLI.

你:给用户模块加个批量导出功能
AI:好的,我来实现...(直接开始写代码)
    export async function exportUsers() { ... }
你:等等,格式不对,没分页,大数据量会 OOM...

你:给用户模块加个批量导出功能
AI:在开始实现之前,我需要了解几个关键问题:
    1. 导出格式是 CSV 还是 Excel?
    2. 预计数据量多大?需要异步处理吗?
    3. 有权限要求吗?
    → 给出 2-3 个方案,确认后再动手

📊 项目规模

这是什么?

superpowers 是目前最火的 AI 编程 skills 框架(116k+ stars),为 AI 编程工具提供系统化的工作方法论。

superpowers-zh 提供 superpowers 的完整中文翻译版本,专注 Claude Code 和 Codex CLI 两个平台。

🤖 支持的 AI 编程工具

运行 npx superpowers-zh 会自动检测你项目中使用的工具,将 14 个 skills 安装到正确位置。

Codex 版本会自动做"工具名渲染":源 skill 文件里的 Claude Code 专有工具名(Task / TodoWrite / Skill / Bash / Write)会被转换为 Codex 等价或工具中立的表达(spawn_agent / update_plan / shell 工具等),让 Codex agent 读起来毫无歧义。

翻译的 Skills(14 个)

快速开始

方式一:npm 安装(推荐)

cd /your/project
npx superpowers-zh

自动检测当前项目并安装对应版本。也可以显式指定工具:

npx superpowers-zh --tool claude   # Claude Code → .claude/skills/
npx superpowers-zh --tool codex    # Codex CLI   → .codex/skills/(经过 Codex 渲染)

方式二:手动安装

git clone https://github.com/jnMetaCode/superpowers-zh.git

# Claude Code (原样复制)
cp -r superpowers-zh/skills /your/project/.claude/skills

# Codex CLI (建议走 npx 方式,以便自动做工具名渲染)
cd /your/project && npx superpowers-zh --tool codex

详细的 Codex 安装说明见 docs/README.codex.md。

Codex 渲染说明

superpowers-zh 的 skill 源文件按 Claude Code 的工具名(Task / TodoWrite / Skill / Bash / Write)编写。安装到 Codex CLI 时,bootstrap 脚本会自动把这些工具名替换成 Codex 等价或工具中立的表达:

渲染规则定义在 bin/codex-patches.js,渲染引擎在 bin/render.js。单元测试在 tests/render/render.test.js,运行:

node tests/render/render.test.js

源文件(skills/*/SKILL.md)完全不变,所有 Codex 适配都在安装阶段完成。

对比上游

贡献

欢迎参与!翻译改进、新增 skills、Bug 修复都可以。

贡献方向

我们只接收符合 superpowers 定位的 skill——AI 编程工作流方法论。好的 skill 应该:

• 教 AI 助手怎么干活,而不是某个框架/语言的教程
• 解决上游英文版不覆盖的中国开发者痛点
• 有明确的步骤、检查清单、示例,AI 加载后能直接执行

欢迎提 Issue 讨论你的想法!

交流 · Community

微信公众号 「AI不止语」(微信搜索 AI_BuZhiYu)— 技术问答 · 项目更新 · 实战文章

致谢