SuperAPI AI 工具集

codex-runner

通用与其它

查看项目

更新于 10-16 01:14

技能介绍

用途:codex-runner 用于把调用方限定的提示通过本地已认证的 codex CLI 以非交互 exec 模式执行,仅在明确请求 Codex CLI 或选定 Astra、Sol、Terra、Luna 路由时使用。确定性检查无需选择模型。

主要能力:先依据 shared/references/model-preview.md 选择分支,实际派发使用一个已批准的固定快照;嵌套调用直接消费该快照,不重新解析、不额外启动 worker。共享角色、信封键与结果处理见 shared/references/runner-common.md。需保持席位真实性:注明实际应答的提供方,如实报告不可用或未验证的席位。选择外部路由前先读 shared/references/host-model-execution.md;若当前宿主能以原生子代理或任务线程派发所选模型并满足所需 effort、隔离与回执策略,则用原生路由。agents/openai.yaml 只是宿主 UI 元数据,不派发原生模型。

使用方式:在同一次 shell 调用中设置 SKILL_DIR 为已加载技能目录,然后运行: SKILL_DIR="<absolute path of this skill directory>"; python3 "$SKILL_DIR/scripts/run_codex.py" "<scoped prompt>"
--model <approved-model-id> --effort <approved-effort> --disable-fallback --json 模型与 effort 需从所选快照原样复制,并补充其角色、工具模式、回执策略与限制。仅对选定的运行时受控路由可省略 effort 标志。嵌套调用复用已保存选项,不再解析默认值。该示例不授予源码共享或工具权限。

限制:使用本地已认证 codex CLI 的 exec 模式,分析角色默认只读沙箱。--tool-profile repo_read_only 还会禁用插件、应用、网页搜索与 MCP 服务器,并记录配置工具回执;codex exec 不报告启动工具,因此该回执只证明配置而非观测。用户 Codex hooks 仍会运行,它们不是模型工具。Codex 无法运行 no_tools。--allow-write、显式沙箱或 --full-auto 只能在调用方权限内改变边界;full auto 无人值守运行需审批。提示与文件上下文可能发送给配置的提供方,--working-dir 应设为任务仓库或包。包装器转发模型与 effort,但当前无头输出不能证明实际服务模型,仅配置标签给出未验证回执。直接调用在 CLI 缺失时可回退一次到 claude-runner;已批准路由禁用回退,原生恢复不能回退到其他 runner。仅在提示需澄清或需设计输出契约时读 references/prompting.md。按需加载:references/command-reference.md(标志、示例、原生映射、返回码)、references/runtime-reference.md(认证、回退条件、配置、扩展信封字段)、references/continuation.md(恢复会话或管理后台任务)。结果需读取 agent_message 与包装器信封,检查成功、服务模型回执、有效 runner/provider 及回退或畸形输出状态;进程完成本身不证明任务或模型被使用。调用方授权编辑时报告被改动文件。