Files
superpowers-zh/docs/README.codex.md
jiangnan 80bc100625 superpowers 中文社区版:14 个翻译 + 5 个中国特色原创 skills
基于 obra/superpowers (MIT) 完整汉化,新增中国开发者专属 skills:
- 中文代码审查:适配国内团队沟通文化
- 中文 Git 工作流:支持 Gitee/Coding/极狐 GitLab
- 中文技术文档:中英混排规范、排版标准
- 中文提交规范:Conventional Commits 中文适配 + commitlint 配置
- MCP 服务器构建:生产级 MCP 工具开发方法论

支持工具:CC / Cursor / Codex CLI / Gemini
安装:npx superpowers-zh
2026-03-20 11:32:25 +08:00

2.2 KiB
Raw Blame History

Superpowers 中文版 — Codex CLI 安装指南

在 Codex 中使用 superpowers-zh 的完整指南。

快速安装

告诉 Codex

Fetch and follow instructions from https://raw.githubusercontent.com/jnMetaCode/superpowers-zh/refs/heads/main/.codex/INSTALL.md

手动安装

前置条件

  • OpenAI Codex CLI
  • Git

步骤

  1. 克隆仓库:

    git clone https://github.com/jnMetaCode/superpowers-zh.git ~/.codex/superpowers-zh
    
  2. 创建 skills 符号链接:

    mkdir -p ~/.agents/skills
    ln -s ~/.codex/superpowers-zh/skills ~/.agents/skills/superpowers
    
  3. 重启 Codex。

  4. 子代理 skills可选 dispatching-parallel-agentssubagent-driven-development 需要 Codex 的多代理功能。在 Codex 配置中添加:

    [features]
    multi_agent = true
    

Windows

使用 junction 代替符号链接(无需开发者模式):

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers-zh\skills"

工作原理

Codex 原生支持 skill 发现——启动时扫描 ~/.agents/skills/ 目录,解析 SKILL.md 的 frontmatter按需加载 skills。通过一个符号链接即可注册所有 skills

~/.agents/skills/superpowers/ → ~/.codex/superpowers-zh/skills/

using-superpowers skill 会自动被发现并强制执行 skill 使用纪律——无需额外配置。

使用

Skills 自动发现。Codex 在以下情况激活 skills

  • 你提到 skill 名称(如 "use brainstorming"
  • 任务匹配 skill 的描述
  • using-superpowers skill 指示 Codex 使用某个 skill

更新

cd ~/.codex/superpowers-zh && git pull

Skills 通过符号链接即时更新。

卸载

rm ~/.agents/skills/superpowers

Windows (PowerShell):

Remove-Item "$env:USERPROFILE\.agents\skills\superpowers"

可选:删除克隆的仓库 rm -rf ~/.codex/superpowers-zh

获取帮助