SuperAPI AI 工具集

codex

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:/codex <prompt> 把任意问题或任务交给 OpenAI Codex CLI,在本仓库上下文中运行,并把 Codex 的最终答案回传给用户。也可用「ask codex to …」「have codex look at …」等方式触发。它是独立的第二模型,适合获取第二意见、对抗性审阅,或分担独立调查与编辑;结构化的审查关口是 /codex-review,不是本技能。

主要能力与用法:解析调用后,斜杠命令之后的内容即 PROMPT。标志:--write 允许 Codex 编辑工作树(workspace-write 沙箱),默认为只读;-m <model> 指定 Codex 模型;--dir <path> 指定工作根目录(默认仓库根)。派发一个 general-purpose 子代理,并显式指定其模型:普通问答用 haiku,涉及编辑并需复核用 sonnet。执行方式为:printf %s '<PROMPT>' | bash <SKILL_DIR>/codex.sh [--write] [--stats] [-m MODEL] -。仅当用户要求 Codex 的 token 用量或 API 费用时才加 --stats,其附加的用量与预估费用块需原样回传;正常委托省略以保持输出干净,费用为估算,可用 CODEX_PRICE_INPUT_PER_M / CODEX_PRICE_CACHED_PER_M / CODEX_PRICE_OUTPUT_PER_M 覆盖费率。回传时须注明「Codex says:」;若用了 --write,还要跑 git status --short 与 git --no-pager diff 并概述改动,不能未经查看就把编辑当作已验证。

限制与注意:只读是安全默认;Codex 输出不是事实基准,重要内容(尤其 --write 编辑)须对照实际代码与测试套件核实。若 codex.sh 报限流或认证失败,应告知用户并重试或换 -m 模型;退出码 3(CODEX-INFRA:最终消息为空)属于基础设施失败,不得当作任务完成。--write 派发还必须包含约束设计:禁止把「改变行为」与「所有既有测试保持绿色」组合;须写明遇失败或指令冲突即停止并报告(明确的停止报告算成功,靠 mock、别名、包装导出、改夹具或重生成快照得到的绿色算失败);要求披露台账(测试文件改动数、断言改动前后数、新增 mock/别名须为 0、快照触碰须为 0 或逐项列出);并用 CREATE-ONLY / READ-ONLY 文件清单做范围围栏。写测试时须复述夹具规则(源自真实写入方、仅相对日期、独立枚举断言值)。验证方面:Tier 0 独立重跑所有声称的命令,并用 git diff -U0 -- '.test.' | grep -nE '^+.*(vi.(do)?mock|Legacy)' 做机械扫描,命中即停,记录模型 id 与 token 数;Tier 1 对新测试做同义反复与夹具形状抽查并做定向变异;Tier 2 对实时行为或「保持行为」要求旧新行为对比差异,且验证工具不得由同一执行者独自编写。退休规则:出现一次伪造绿色即在该场景停用 Codex,重新启用仅限全新项目、Tier 2 验证、连续多次无问题且不得独自编写验证工具。