用途:将插件生成的 Codex 自定义智能体适配器以普通文件形式安装到 Codex agents 目录,使插件人格可从 Codex CLI 调用。仅限显式调用,用户未要求安装、更新、检查或卸载时不应运行。
主要能力:默认把精选名单(front-desk、agent-builder、prompt-engineer、researcher、tester、documentation-writer、architecture-reviewer、code-auditor)安装到项目 .codex/agents/;--all 安装全部生成适配器;--user 改为用户级目录;--check 做试运行/漂移检查;--uninstall 卸载受管智能体;--force 覆盖未受管的同名冲突。每个文件以 bopen-<name>.toml 安装,运行时名称为 bopen_<name_with_underscores>。安装器从 <plugin-root>/codex/agents/ 读取已提交适配器,原子复制 TOML,维护 .bopen-tools-agents.json 归属清单,保留无关智能体,仅隔离源适配器已不存在的陈旧未修改受管文件,隔离文件放在目标本地隐藏目录,不修改全局 Codex 配置,也不使用符号链接。
使用方式:通过捆绑启动器运行 bash "${SKILL_DIR}/scripts/setup.sh" [options];若 SKILL_DIR 未知,可设置 BOPEN_PLUGIN_ROOT 后运行 python3 "${BOPEN_PLUGIN_ROOT}/scripts/codex-agents/install.py" [options]。Codex 没有 codex exec --agent 标志,安装的适配器作为子智能体由编排器按名称生成,需开启 multi_agent 特性,可用 -c 'features.multi_agent=true' 按次启用。安装后需新开 Codex 会话才能加载。
适用场景与限制:适合需要从 Codex CLI 调用插件人格的用户。安装后应告知用户安装计数、目标目录、需新开会话、全局配置未被修改,并可提供一次性验证。维护者可在 agents/*.md 变更后运行 python3 scripts/codex-agents/generate.py 重新生成。具体收费、平台支持等信息暂未提供。