feat(codex): 支持通过 codex plugin add 安装 superpowers-zh

feat(codex): 支持通过 codex plugin add 安装 superpowers-zh

• 我已搜索现有 issue 中关于此 IDE/平台的内容

哪个 IDE 或平台？

OpenAI Codex CLI：

• 仓库：https://github.com/openai/codex
• 测试版本：codex-cli 0.154.0
• Superpowers 中文版版本：v1.7.13
• 操作系统：macOS
• Shell：zsh

这解决了什么问题？

目前仓库已经包含 .codex-plugin/plugin.json，但缺少 Codex marketplace 入口文件：

.agents/plugins/marketplace.json

Codex 注册 marketplace 后会从该路径读取插件列表。由于文件缺失，Codex 无法在这个仓库中发现 superpowers-zh 插件，因此下面的安装流程不能正常工作：

codex plugin marketplace add https://github.com/jnMetaCode/superpowers-zh.git
codex plugin add superpowers-zh@superpowers-zh

实际执行安装命令时会返回：

Error: plugin `superpowers-zh` was not found in marketplace `superpowers-zh`

目前只能通过 npx superpowers-zh 安装 Skills。该方式可以使用，但无法获得 Codex 原生插件管理带来的统一安装、启用、禁用、升级和卸载体验，同时依赖本机 Node.js/npm 环境。

该工具是否有插件或扩展系统？

有。Codex CLI 已支持以下命令：

codex plugin marketplace add <source>
codex plugin marketplace list
codex plugin marketplace upgrade <marketplace>
codex plugin add <plugin>@<marketplace>
codex plugin list
codex plugin remove <plugin>@<marketplace>

上游 obra/superpowers 已经通过 .agents/plugins/marketplace.json 支持 Codex marketplace：

• 上游实现：https://github.com/obra/superpowers/pull/1885
• Codex marketplace 配置规范：https://github.com/openai/codex/blob/main/codex-rs/skills/src/assets/samples/plugin-creator/references/plugin-json-spec.md

建议的方案

在仓库中新增 .agents/plugins/marketplace.json，将仓库根目录注册为 superpowers-zh 插件来源。例如：

{
  "name": "superpowers-zh",
  "interface": {
    "displayName": "Superpowers 中文版"
  },
  "plugins": [
    {
      "name": "superpowers-zh",
      "source": {
        "source": "url",
        "url": "./"
      },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Developer Tools"
    }
  ]
}

同时建议：

1. 增加 Codex marketplace manifest 的静态校验测试。
2. 使用 Codex 的插件校验工具验证 .codex-plugin/plugin.json。
3. 增加一次基于临时用户目录的端到端安装测试。
4. 在 README 中补充 Codex 原生安装、升级和卸载命令。
5. 确认 Codex 安装包不会自动注册仅适用于 Claude Code 的 SessionStart hook。

期望的安装方式

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
Version: 1.7.13
Status: enabled

你是否尝试过手动安装？

是。通过全局 Skills 方式可以正常使用：

npx superpowers-zh --global --tool codex

但这属于安装器兼容方案，不是 Codex 原生插件安装方式。

验收标准

• codex plugin marketplace add 能正确注册该仓库
• codex plugin marketplace list 能显示 superpowers-zh
• codex plugin add superpowers-zh@superpowers-zh 安装成功
• codex plugin list 能显示正确的名称、版本和启用状态
• 插件包含的全部 Skills 能被 Codex 正常发现
• 不需要预先安装 Node.js 或 npm
• 不会加载仅适用于其他平台的 hook
• README 包含 Codex 的安装、升级和卸载说明

补充说明

仓库目前已经具备 .codex-plugin/plugin.json，因此主要缺口应是 Codex 所要求的 .agents/plugins/marketplace.json 以及对应的验证测试。

上游已经有较完整的参考实现，预计不需要改动现有 Skills 内容。