Codex CLI 升级到 v0.122 后 agent-skills 安装命令怎么从 marketplace add 换成 plugin marketplace add？

如果你之前用 codex marketplace add 安装过 agent-skills，升级到 Codex CLI v0.122 或更高版本后，这条命令就不适用了：v0.122 起安装方式改为两步插件命令，第一条从 codex marketplace add 换成 codex plugin marketplace add。本文基于仓库中的 docs/codex-setup.md 和 README.md，说明命令怎么换、怎么执行、以及如何确认技能已经生效。

新旧命令的对应关系

版本边界很明确：

• Codex CLI v0.122 或更高：使用 codex plugin marketplace add 注册 marketplace，再用 codex plugin add 安装插件。
• v0.122 之前的旧版本：命令是 codex marketplace add（仓库文档只给出这一条旧命令，未提供旧版对应的完整安装序列）。

所以升级后需要做的是：确认自己的 CLI 版本在 v0.122 及以上，然后改用新的两步命令；如果因为环境限制还在旧版本上，继续用 codex marketplace add 即可，不要混用新旧命令。

v0.122+ 的安装步骤

从仓库安装，按顺序执行两条命令：

codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills

第一条命令把该仓库注册为 agent-skills marketplace，第二条命令从这个 marketplace 安装并启用 agent-skills 插件。两条命令有先后依赖：必须先注册 marketplace，第二条命令才能解析 agent-skills@agent-skills 这个名字。

如果你的 agent-skills 是本地克隆（本地开发或无法访问仓库地址时的可选分支），把 marketplace 地址换成克隆目录的绝对路径，路径由你按实际位置替换：

codex plugin marketplace add /path/to/your/clone
codex plugin add agent-skills@agent-skills

安装后如何验证

文档给出的验证路径是：

1. 安装完成后开启一个新的 Codex 会话——技能是在新会话启动时发现的，旧会话不会自动加载。
2. 在 Codex 聊天中用 @ 调用某个技能，例如 @spec-driven-development；也可以直接描述任务，让 Codex 自行挑选合适的技能。
3. 仓库根目录 skills/ 下的全部 25 个技能都应该可用，且与 Claude Code 共用同一份 skills/<name>/SKILL.md，安装过程不会复制或复制文件。

如果新会话中 @ 后仍然看不到技能，优先检查两点：是否确实在 v0.122+ 的 CLI 中执行了新命令、是否开启了新会话。

为什么这两条命令能工作

Codex 读取的是仓库里的两个清单文件（见 docs/codex-setup.md）：

• .codex-plugin/plugin.json —— Codex 插件清单，其中 skills 字段直接指向 ./skills/；
• .agents/plugins/marketplace.json —— marketplace 条目，把仓库根目录（./）声明为插件来源。

也就是说 marketplace 注册的其实是"仓库里已有的一套技能目录"，插件安装不需要额外拷贝文件。

边界与限制

• 版本要求硬性绑定：codex plugin marketplace add 需要 Codex CLI v0.122 或更高版本，仓库文档将旧版行为指给 codex marketplace add，没有提供在旧版本上使用 plugin 子命令的说明。
• .claude/commands/ 下的斜杠命令（如 /spec）、agents/ 下的人设和 hooks/ 下的生命周期钩子属于 Claude Code 专用。在 Codex 里没有对应的斜杠命令，要直接用 @技能名 调用底层技能，例如用 @spec-driven-development 而不是 /spec。
• 文档没有提供卸载或从旧安装方式迁移的单独命令；如果你的环境已经用旧版装过 agent-skills，文档给出的可核对路径是升级 CLI 后按上文两条新命令重新执行注册与安装，再开新会话验证。