SuperAPI AI 工具集

codex-exec

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

一、用途 codex-exec 用于通过 codex CLI 运行自主任务执行,非交互式运行。进度流向 stderr,最终结果在 stdout。适用场景包括分析、代码阅读、生成报告,以及在项目中编辑文件、安装依赖、运行测试等系统操作。

二、主要能力 支持模型选择(-m)、沙箱级别(--sandbox read-only / workspace-write / danger-full-access)、JSON Lines 输出(--json)、把最终消息写入文件(-o)、用 JSON Schema 约束输出(--output-schema)、无持久会话(--ephemeral)、跳过 git 仓库检查(--skip-git-repo-check)。支持通过 spawn_agent / wait_agent 进行并行子代理,但需在提示中显式要求。

三、必要用法 基本命令:codex exec --skip-git-repo-check "task description" < /dev/null。传入大段上下文时用管道:cat context.txt | codex exec --skip-git-repo-check "question about the context"。若提示本身需包含反引号、美元符号或直双引号,可把提示和上下文写入一个文件后传 -:cat prompt.txt | codex exec --skip-git-repo-check -。 每次调用都需 --skip-git-repo-check,恢复轮次同样需要。修改或实现类任务默认用 --sandbox workspace-write;分析或研究用 read-only;安装包、跑测试、系统操作用 danger-full-access,且需显式传该标志。不要同时传其他权限标志。用户指定模型时在该技能所有 codex exec 命令(含 resume 轮次)加 -m <model>。 在非管道调用中始终重定向 stdin:< /dev/null,否则可能一直挂起。同步执行时以 Bash 工具前台调用,设 timeout: 600000;每次运行使用独立绝对 -o 路径并带随机标签,避免并发或连续运行冲突。

四、适用场景与限制 适用于自主执行、代码分析、文件编辑、报告生成与并行子代理任务。提示可用 XML 标签(如 <task>、<structured_output_contract>、<grounding_rules>、<verification_loop>)组织结构。 限制:跑在非 git 仓库时若不带 --skip-git-repo-check 会中止并打印 Not inside a trusted directory,且不写 -o 文件。沙箱网络访问等细节按原文要求处理。超时可能被强制后台化,通过任务 ID 和输出文件恢复;也可用 resume 恢复会话,必要时从 ~/.codex/sessions 取会话 ID。不要用 Monitor 等待。结果需结合项目文档与约定交叉核对,增量测试,提交前查看 diff。其余未在资料中说明的内容暂未提供。