Codex CLI教程（四） | Superpowers安装指南（Windows）

Codex CLI教程四 | Superpowers安装指南Windows一、前言二、准备工作三、安装方法按推荐度排序方法一官方 GitHub 安装法步骤 1安装 Codex CLI步骤 2安装 Superpowers方法二通过 Codex 自动安装方法三使用第三方镜像安装四、配置与优化配置文件位置启用高级功能五、验证安装步骤 1检查 junction 创建状态步骤 2在 Codex 中验证安装六、维护与管理更新 Superpowers卸载 Superpowers七、常见问题与解决方案1. 权限错误2. 命令未找到3. 技能不显示八、技术原理1. Superpowers 功能架构2. 技能发现机制3. Windows 链接技术4. 安装方法的官方来源九、Superpowers 技能列表与使用方法核心技能列表技能使用方法1. 自动触发推荐2. 手动触发3. 技能工作流程实际使用示例示例 1开发新功能示例 2修复 bug使用最佳实践十、使用建议推荐使用场景注意事项十一、总结参考资源一、前言Codex CLI 是 OpenAI 推出的 AI 编程助手可在终端中直接与 AI 对话辅助代码编写、调试和解释。Superpowers 则是为 Codex 提供增强功能的技能集合通过添加专业技能模块提升 Codex 的能力范围。本文将详细介绍在 Windows 环境下为 Codex CLI 安装 Superpowers 的完整流程按推荐度排序确保步骤清晰专业。二、准备工作安装 Node.js推荐度★★★★★下载访问 Node.js 官网 下载 LTS 版本推荐 v18 或 v20安装运行安装程序务必勾选 “Add to PATH”选项自动配置环境变量验证node-v# 验证 Node.js 安装npm-v# 验证 npm 包管理器三、安装方法按推荐度排序方法一官方 GitHub 安装法推荐度★★★★★特点官方推荐稳定可靠适合所有用户步骤 1安装 Codex CLInpm install-g openai/codex--registryhttps://registry.npmmirror.com命令解析npm install -g全局安装包确保 codex 命令在任何位置可用openai/codexOpenAI 官方 Codex CLI 包--registry使用国内镜像源加速下载codex--version# 验证安装成功步骤 2安装 Superpowers为什么需要创建技能目录并建立关联这是由 Codex CLI 的技能发现机制决定的Codex 启动时会自动扫描~/.agents/skills/目录Windows 下为%USERPROFILE%\.agents\skills\Superpowers 的技能文件存储在其仓库的skills目录中使用 junction目录链接可以保持技能与原始仓库的关联便于后续更新克隆 Superpowers 仓库git clone https://github.com/obra/superpowers.git$env:USERPROFILE\.codex\superpowers命令解析git clone从 GitHub 克隆仓库到本地https://github.com/obra/superpowers.gitSuperpowers 项目官方地址$env:USERPROFILE\.codex\superpowers克隆目标路径$env:USERPROFILEPowerShell 环境变量指向用户主目录创建技能目录并建立 junctionNew-Item-ItemType Directory-Force-Path$env:USERPROFILE\.agents\skills命令解析New-Item创建新目录-ItemType Directory指定创建类型为目录-Force强制创建若目录已存在则不报错-Path指定目录路径cmd/c mklink/J$env:USERPROFILE\.agents\skills\superpowers$env:USERPROFILE\.codex\superpowers\skills命令解析cmd /c在 PowerShell 中执行 cmd 命令mklink /J创建目录 junctionWindows 目录链接类似符号链接第一个路径链接目标位置Codex 技能扫描目录第二个路径源目录Superpowers 技能目录重启 Codex CLI关闭并重新启动 Codex使其发现新技能方法二通过 Codex 自动安装推荐度★★★★☆特点操作简单适合新手用户启动 Codex CLIcodex输入安装指令Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md功能说明让 Codex 自动获取并执行官方安装脚本方法三使用第三方镜像安装推荐度★★★☆☆特点适合网络环境较差的用户安装 Node.js步骤同前使用 88code 镜像安装 Codexnpm i-g 88code/codex--registryhttps://registry.npmmirror.com命令解析npm i -g全局安装88code/codex88code 定制版 Codex--registry使用国内镜像源按照方法一的步骤安装 Superpowers四、配置与优化配置文件位置Windows%USERPROFILE%\.codex\Linux/macOS~/.codex/启用高级功能在config.toml文件中添加以下配置以启用多代理功能[features] multi_agent true功能说明启用 Codex 的多代理功能支持 Superpowers 中的子代理技能五、验证安装步骤 1检查 junction 创建状态ls$env:USERPROFILE\.agents\skills功能说明列出技能目录内容确认 superpowers 链接已正确创建预期结果应显示superpowers目录链接步骤 2在 Codex 中验证安装重启 Codex关闭并重新启动 Codex CLI使其发现新技能。官方验证方法检查 junction 创建状态ls$env:USERPROFILE\.agents\skills\superpowers功能说明检查 Superpowers 技能链接是否正确创建预期结果应显示 junction 链接指向$env:USERPROFILE\.codex\superpowers\skills在 Codex CLI 中验证启动 Codex 并输入以下任一命令Help me plan this feature或Lets debug this issue功能说明测试 Superpowers 技能是否自动触发预期结果Codex 应启动相应技能开始提问澄清需求或系统性排查直接询问技能do you have brainstorming?功能说明直接询问 Codex 是否具备 Superpowers 技能预期结果Codex 应确认拥有 brainstorming 等 Superpowers 技能测试具体技能use brainstorming to generate ideas for a new project功能说明直接使用 Superpowers 的头脑风暴技能预期结果Codex 应启动头脑风暴技能开始询问项目相关问题六、维护与管理更新 Superpowerscd$env:USERPROFILE\.codex\superpowers git pull命令解析cd切换到 Superpowers 目录git pull从 GitHub 拉取最新代码优势由于使用了 junction 链接更新后技能会自动同步卸载 SuperpowersRemove-Item$env:USERPROFILE\.agents\skills\superpowers# 可选删除克隆的仓库Remove-Item-Recurse-Force$env:USERPROFILE\.codex\superpowers七、常见问题与解决方案1. 权限错误症状安装时提示 “权限不足” 或 “access denied”解决方案以管理员身份运行 PowerShell2. 命令未找到症状运行codex时提示 “不是内部或外部命令”解决方案检查 npm 全局安装路径npm config get prefix确保该路径已添加到系统 PATH 环境变量重新安装 Node.js 并确保勾选 “Add to PATH”3. 技能不显示症状Codex 无法发现 Superpowers 技能解决方案检查 junction 是否正确创建重启 Codex CLI确认~/.agents/skills/superpowers目录存在八、技术原理1. Superpowers 功能架构Superpowers 是一个模块化技能系统为 Codex CLI 提供扩展功能包括头脑风暴brainstorming代码审查code-review测试生成test-generation子代理驱动开发subagent-driven-development2. 技能发现机制Codex 启动时会扫描~/.agents/skills/目录自动发现并加载技能。每个技能通过SKILL.md文件定义包含技能名称和描述触发条件使用方法和示例3. Windows 链接技术在 Windows 环境下使用mklink /J创建目录 junction目录链接实现类似 Linux 符号链接的功能使 Codex 能够通过标准路径访问 Superpowers 技能文件。4. 安装方法的官方来源此安装方法来自 Superpowers 项目的官方文档.codex/INSTALL.md由项目维护者 obra 制定是官方推荐的标准安装方式。九、Superpowers 技能列表与使用方法核心技能列表Superpowers 提供了丰富的技能帮助开发者遵循最佳实践技能名称功能描述触发场景brainstorming交互式设计优化帮助澄清需求开发新功能、设计系统writing-plans创建详细的实施计划拆解任务复杂功能开发、重构test-driven-development测试驱动开发先写测试再实现代码实现、功能开发requesting-code-review代码审查分析质量和潜在问题代码完成后、PR 前systematic-debugging系统性调试排查问题根因修复 bug、性能优化using-git-worktrees利用 Git worktrees 创建隔离开发环境多分支并行开发finishing-a-development-branch完成分支开发运行测试并准备合并功能开发完成后技能使用方法1. 自动触发推荐Superpowers 设计为自动触发模式AI 会根据上下文自动调用合适的技能场景预期触发技能示例输入新功能开发brainstorming“我想给博客添加评论功能”问题排查systematic-debugging“登录接口有时返回 500 错误”代码实现writing-plans test-driven-development“帮我实现用户认证系统”代码审查requesting-code-review“帮我审查这段代码”2. 手动触发你也可以通过use命令手动触发特定技能use brainstorming to generate ideas for a new projectuse test-driven-development to implement a user authentication system3. 技能工作流程Superpowers 技能通常遵循以下工作流程澄清需求技能会询问关键问题确保理解需求生成方案基于需求生成详细的设计或计划执行实施按照方案执行如编写测试、实现代码质量检查进行代码审查、测试验证完成交付总结工作成果提供最终方案实际使用示例示例 1开发新功能我想给电商网站添加购物车功能预期流程brainstorming 技能自动触发询问功能细节生成设计方案后writing-plans 技能生成实施计划test-driven-development 技能按 TDD 方式实现requesting-code-review 技能进行代码审查示例 2修复 bug用户登录后无法访问个人中心总是跳转到首页预期流程systematic-debugging 技能自动触发分析问题根因提出解决方案test-driven-development 技能修复并验证使用最佳实践主动沟通与技能保持互动及时回答问题明确需求尽可能详细描述需求减少误解遵循流程信任技能的工作流程不要跳过步骤定期更新定期更新 Superpowers 以获得最新功能反馈问题遇到问题时通过 GitHub 提交 issue十、使用建议推荐使用场景新手用户通过方法二Codex 自动安装快速上手专业用户使用方法一官方 GitHub 安装获得完整控制网络受限用户使用方法三第三方镜像解决网络问题注意事项技能发现确保 junction 链接正确创建Codex 才能发现技能重启必要安装后需要重启 Codex 才能加载技能自然语言使用自然语言描述需求Superpowers 会自动识别并调用合适技能循序渐进技能会分步骤执行耐心跟随工作流程质量保证Superpowers 会强制遵循最佳实践确保代码质量十一、总结通过本文介绍的方法你可以在 Windows 环境下成功为 Codex CLI 安装 Superpowers获得更强大的 AI 编程助手能力。官方 GitHub 安装法是最推荐的方式提供最稳定可靠的体验。Superpowers 扩展了 Codex 的能力边界使其不仅是代码生成工具更是一个完整的开发助手生态系统。合理使用这些技能将显著提升你的编程效率和代码质量。参考资源Superpowers GitHub 仓库Codex CLI 官方文档Node.js 官网更新时间2026 年 4 月 14 日注意本文基于最新官方文档编写确保方法的有效性和可靠性。若后续版本更新可能需要相应调整安装步骤。