SuperAPI AI 工具集

codex-cli

通用与其它

查看项目

更新于 10-15 22:33

技能介绍

用途:当用户要求本智能体去联系 Codex、咨询 Codex,或把编码、审查、研究任务乃至图像生成委派给 Codex CLI 时使用。核心接口为 codex exec "prompt",自动化场景优先使用非交互式的 codex exec 而非交互式的 codex。

使用前检查:先运行 command -v codex、codex --version、codex exec --help 确认可用。若 codex 缺失,应告知用户该环境不可用并停止,不得模拟 Codex 回复。已安装 CLI 的参数标志应以 codex exec --help 为准,因为 Codex CLI 会随时间变化。

主要能力与用法:常规委派可用 codex exec -C "$PWD" -s read-only "...";可能改文件时用 -s workspace-write;用 -o 写出响应文件,加 --json 输出机器可读事件。长提示词可通过 stdin 传入,如 codex exec -C "$PWD" - < /tmp/prompt.txt。非平凡任务按 Goal/Context/Constraints/Done when 结构组织提示,并保持单任务范围;复杂实现先在只读模式取计划,再单独执行写入任务。会话续接用 codex exec resume <session-id> "...",具体语法以 codex exec resume --help 为准。

图像输入:Codex 无法自行浏览或读取图像,需用 -i/--image 显式附加,支持 PNG/JPEG,可用逗号分隔或重复标志;-i 标志应放在提示文本之前,视觉审查宜配合 -s read-only。非图像文件没有附加标志,可让 Codex 从工作区读取,或通过 stdin 追加为 <stdin> 块。

图像生成:通过 codex exec 请求内置图像生成,例如 codex exec "Generate a black banana image with aspect ratio 16:9"。生成文件通常保存在 $CODEX_HOME/generated_images/<codex-session-id>/,未设置时为 ~/.codex/generated_images/<session-id>/;Codex 可能不打印路径,使用方需主动定位并报告。可用 sips 或 file 校验宽高比。

限制与安全:不要向 Codex 传递密钥,除非用户明确要求并知晓风险;咨询用只读,仅在预期编辑文件时用 workspace-write,避免 danger-full-access。不要仅凭 Codex 最终消息宣称其完成了工作,涉及文件变更时应检查文件系统或 Git diff。遇网络、认证或模型刷新错误应原样报告相关 stderr;若声称生成图像却无文件,应明确说明且不得编造路径。图片不应只留在 $CODEX_HOME/generated_images 下。

其他:具体模型后端通常无法从输出或元数据确认,不得擅自宣称使用了某一具体模型。