Skip to content

README.codex.md

Latest commit

 

History

History
140 lines (95 loc) · 3.94 KB

README.codex.md

File metadata and controls

140 lines (95 loc) · 3.94 KB
Raw

Superpowers 中文版 — Codex CLI 安装指南

⚠️ v1.7.10 及更早的项目级安装装错了地方

官方文档（developers.openai.com/codex/skills，现 308 跳 learn.chatgpt.com/docs/build-skills）给出的扫描目录完整清单是：

$CWD/.agents/skills
$CWD/../.agents/skills
$REPO_ROOT/.agents/skills
$HOME/.agents/skills
/etc/codex/skills

没有 .codex/skills。 而 v1.7.10 及更早的 npx superpowers-zh --tool codex 正是装到 .codex/skills —— Codex 不扫那里，等于装了完全不生效。全局（~/.agents/skills）一直是对的，只有项目级错。

v1.7.11 起项目级改装 .agents/skills，重装时会自动清掉旧位置里我们装的那些（你自己放在 .codex/skills 下的东西不动）：

cd /your/project
npx superpowers-zh --tool codex

顺带说明：.agents/skills 与 Antigravity 共用，这是 Agent Skills 开放约定，不是冲突。装过其中一个，另一个也能读到。

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

快速安装

告诉 Codex：

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

Codex 原生插件安装

Codex CLI 自带插件管理，可以直接把本仓库注册为 marketplace 安装，不需要 Node.js / npm（已在 codex-cli 0.147.0、0.154.0 上实测）：

codex plugin marketplace add https://github.com/jnMetaCode/superpowers-zh.git
codex plugin add superpowers-zh@superpowers-zh
codex plugin list   # 应显示 superpowers-zh@superpowers-zh  installed, enabled

安装后 21 个 skills 全部可被发现；插件清单声明了空 hooks，不会注册仅适用于 Claude Code 的 SessionStart hook。

更新：

codex plugin marketplace upgrade superpowers-zh
codex plugin add superpowers-zh@superpowers-zh

卸载：

codex plugin remove superpowers-zh@superpowers-zh
codex plugin marketplace remove superpowers-zh   # 可选：连同 marketplace 一起移除

手动安装

前置条件

  • 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-agents 和 subagent-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

获取帮助