Codex CLI 升级到 v0.122 后 agent-skills 安装命令怎么从 marketplace add 换成 plugin marketplace add?
【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills
如果你之前用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 CLIv0.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-skillsmarketplace,第二条命令从这个 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安装后如何验证
文档给出的验证路径是:
- 安装完成后开启一个新的 Codex 会话——技能是在新会话启动时发现的,旧会话不会自动加载。
- 在 Codex 聊天中用
@调用某个技能,例如@spec-driven-development;也可以直接描述任务,让 Codex 自行挑选合适的技能。 - 仓库根目录
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 后按上文两条新命令重新执行注册与安装,再开新会话验证。
【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考