Codex 安装指南

前置要求

• OpenAI Codex CLI 已安装
• Git 已安装

安装步骤

方式一：让 Codex 自动安装（推荐）

在 Codex 中输入：

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

方式二：手动安装

macOS / Linux:

1. 克隆仓库：

   git clone https://github.com/obra/superpowers.git ~/.codex/superpowers

2. 创建技能符号链接：

   mkdir -p ~/.agents/skills
   ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers

3. 重启 Codex。

Windows (PowerShell):

1. 克隆仓库：

   git clone https://github.com/obra/superpowers.git "$env:USERPROFILE\.codex\superpowers"

2. 创建技能符号链接：

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

3. 重启 Codex。

子代理功能（可选）

如需使用 dispatching-parallel-agents 和 subagent-driven-development 等子代理技能，需在 Codex 配置中启用：

[features]
collab = true

工作原理

Codex 具有原生技能发现功能，启动时扫描 ~/.agents/skills/ 目录，解析 SKILL.md 文件并按需加载技能。Superpowers 技能通过一个符号链接被识别：

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

验证安装

ls -la ~/.agents/skills/superpowers

应看到一个指向 superpowers 技能目录的符号链接。

配置文件位置

• 技能目录：~/.codex/superpowers/skills/
• 个人技能：~/.agents/skills/

更新

cd ~/.codex/superpowers && git pull

技能通过符号链接即时更新，无需重启。

卸载

macOS / Linux:

rm ~/.agents/skills/superpowers
rm -rf ~/.codex/superpowers  # 可选：删除克隆的仓库

Windows (PowerShell):

Remove-Item "$env:USERPROFILE\.agents\skills\superpowers"
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\superpowers"  # 可选

常见问题

技能未加载

1. 验证符号链接：ls -la ~/.agents/skills/superpowers
2. 检查技能是否存在：ls ~/.codex/superpowers/skills
3. 重启 Codex — 技能在启动时发现

Windows 符号链接问题

Windows 上的 Junction（目录连接）通常无需特殊权限。如果创建失败，尝试以管理员身份运行 PowerShell。

从旧版本迁移

如果你在原生技能发现功能之前安装了 Superpowers：

1. 更新仓库：cd ~/.codex/superpowers && git pull
2. 创建技能符号链接（见安装步骤）
3. 从 ~/.codex/AGENTS.md 中删除旧的 bootstrap 代码块
4. 重启 Codex