在 Codex CLI 注册 Compound Engineering marketplace 并安装插件以激活原生技能-港品优选

在 Codex CLI 注册 Compound Engineering marketplace 并安装插件以激活原生技能

【免费下载链接】compound-engineering-pluginOfficial Compound Engineering plugin for Claude Code, Codex, Cursor, and more项目地址: https://gitcode.com/GitHub_Trending/ev/compound-engineering-plugin

Compound Engineering（compound-engineering-plugin）是一个面向 AI 编码代理的技能插件，包含 35 个技能（skill），支持 Claude Code、Cursor、Codex 等 14 个宿主。在 Codex CLI 中使用它需要经过两步：先在 Codex 中注册（register）Compound Engineering 的 marketplace，再安装compound-engineering插件。只有第二步完成之后，原生 CE 技能才会对当前 Codex profile 生效——README 中明确说明，marketplace 注册只是让插件"可用"（available），安装插件才是激活原生 CE 技能的动作。

仓库自带 Codex 原生安装所需的两个清单文件，不需要额外转换或 Bun 构建步骤：

.agents/plugins/marketplace.json——marketplace 目录，注册后 Codex 在其中找到compound-engineering这个插件，其 source 指向仓库根目录（./）；
.codex-plugin/plugin.json——插件自身清单，声明了skills: "./skills/"，即安装后技能目录直接从仓库的skills/加载。

准备条件

已安装并登录可用状态的 Codex CLI（shell 中可以直接执行codex命令）。
不需要 Bun：FAQ 中说明 Bun 仅用于仓库开发任务和转换器维护，正常安装用不到。
安装是 self-contained 的：专家评审、研究类行为以本地 prompt 资产形式打包在技能内部，不需要单独的 custom-agent 安装步骤。

第一步：注册 marketplace

在 shell 中执行：

codex plugin marketplace add EveryInc/compound-engineering-plugin

这条命令把EveryInc/compound-engineering-plugin仓库注册为 Codex 的 marketplace 来源，Codex 会从中读取.agents/plugins/marketplace.json。此时插件只是"可见"，技能尚未激活。

非默认 profile 的处理（可选分支）

如果你使用非默认 Codex profile（例如work），必须让所有 Codex 相关步骤都指向同一个CODEX_HOME，否则 marketplace 注册和插件安装会落到不同 profile 上。README 给出的示例：

CODEX_HOME="$HOME/.codex/profiles/work" codex plugin marketplace add EveryInc/compound-engineering-plugin CODEX_HOME="$HOME/.codex/profiles/work" codex plugin add compound-engineering@compound-engineering-plugin

CODEX_HOME指向哪个 profile，技能就激活在哪个 profile 上。

第二步：安装插件

codex plugin add compound-engineering@compound-engineering-plugin

命令中compound-engineering是插件名，compound-engineering-plugin是 marketplace 名，中间用@分隔。

执行完成后重启 Codex，让插件技能加载。

替代路径：用`/plugins`界面安装

同样的事也可以在 Codex 里交互式完成：

启动codex，运行/plugins；
找到Compound Engineeringmarketplace，选中其中的compound-engineering插件；
选择Install；
安装完成后重启 Codex。

两条路径等价，CLI 命令适合脚本化，/plugins界面适合手动确认。

验证：确认原生技能已激活

安装并重启后，在任意项目中调用 CE 技能。注意调用前缀因宿主而异：slash-skill 宿主用/skill-name，在 Codex 中用$skill-name调用已安装技能（例如$ce-plan、$lfg）。

一个适合首次安装后立即执行的技能是$ce-setup：它是一个显式触发的诊断技能（disable-model-invocation: true，只有你主动调用才运行），会报告可选工具（agent-browser、gh、jq、ast-grep、ffmpeg）是否在当前 PATH 上、刷新仓库内的.compound-engineering/config.example.yaml，并在你批准后创建仓库级.compound-engineering/config.yaml。它能跑通、能出报告，就说明插件的技能目录已经被 Codex 正常加载。

$ce-setup

更多技能调用方式见 docs/guides 中的技能目录，每个技能的权威运行时定义在skills/<skill>/SKILL.md。

已知限制与后续升级

注册 ≠ 激活：只执行了marketplace add而没执行plugin add，技能不会生效。README 原话：The marketplace step only makes the plugin available; the plugin install is what activates the native CE skills for that profile。
升级顺序有讲究：codex plugin update命令不存在。升级时先刷新缓存的 marketplace 快照，再重新add安装，顺序不能颠倒，单独重跑add可能仍读取旧快照：
```
codex plugin marketplace upgrade compound-engineering-plugin codex plugin add compound-engineering@compound-engineering-plugin
```
非默认 profile 下，这两条命令也要针对同一个CODEX_HOME执行（详见 docs/install/upgrading.md）。
旧版残留：如果你在原生插件支持之前用过 Bun 的convert/install --to codex路径，全局$CODEX_HOME/AGENTS.md（默认~/.codex/AGENTS.md）里可能残留一段管理的工具映射块，该块已废弃，原生插件安装不会写入它；清理步骤同样在 docs/install/upgrading.md 中给出。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析