SuperAPI AI 工具集

codex-task

编程与开发

查看项目

更新于 10-15 23:32

技能介绍

用途:把一次性的编码任务(调试、实现功能、重构)直接交给 OpenAI Codex CLI 执行,跳过 codex:rescue 约 1000 行 Node 封装带来的约 10 秒开销和会话状态混淆,适合目标明确、无需异步轮询的简单任务。

前置条件:codex CLI 需在 PATH 上,安装命令 npm install -g @openai/codex,并配置好 OpenAI 凭据,可用 codex --version 验证;缺失时提示用户安装后停止。Codex 默认在 Claude 当前工作目录运行,若任务指向其他仓库,可先 cd 或传 -C <绝对路径>。

主要能力与默认值:模型 gpt-5.5、推理强度 xhigh、会话 --ephemeral(不持久化)、沙箱默认 --dangerously-bypass-approvals-and-sandbox,即完整文件系统与网络权限、无审批提示。任务文本经 stdin heredoc 原样传入,不做改写,仅在末尾附加 STATUS: DONE / PARTIAL / BLOCKED 一行。

路由标志:--read-only(只读,无编辑无网络)、--safe(workspace-write,仅 cwd 可写、无网络)、--model <name>、--effort <level>、-C <dir>;标志须出现在任务文本开头,-- 之后均视为任务文本,--read-only 优先于 --safe。

使用流程:解析标志得到 TASK_TEXT,仅在确实含糊时确认一次;执行前检查 cwd、是否在 git 仓库、工作区是否干净并提示风险;用 codex exec 调用,通过单引号 heredoc 传 prompt,输出写入临时文件;随后独立验证——对比 git status 差异、查看 git diff --stat、运行受影响模块的测试,不轻信 Codex 自报状态。结果按 DONE/PARTIAL/BLOCKED 呈现并决定下一步。

限制与安全:默认沙箱权限宽松,Codex 可读写磁盘任意位置、装全局包、调用外部 API,仅在对风险可接受时使用;危险模式下务必用 stdin heredoc 而非 shell 引号参数传入用户文本,以防命令注入。不支持后台模式,也不支持 --file。不要自动提交或自动用 git checkout -- 回滚(文件原本就脏时应生成反向补丁);单次执行,失败不自动重试。正在打标签时,官方文档中未提及独立官方页面之外的信息,暂未提供更多。