教程2026-11-19 · 智涌AI

GPT-6.2 提示词怎么写:Codex 里先给验收标准

GPT-6.2 Codex 提示词教程头图:左侧 GPT-6.2 Codex 提示词大字和 3 档推理强度、AGENTS.md 32 KiB 上限、24 px 图标验收示例三张数据卡,右侧终端展示带三条验收标准的需求、use subagents as needed 和子 Agent 推理档位配置

OpenAI 给 GPT-6.2 写了一份 Codex 专用的提示词指南,适用于 Astra 和 Sol 两个型号。核心就两件事:交代任务时顺手说清你验收时看什么,再按排查的深浅选推理档位。这篇把 Codex 指南、子 Agent 文档和 API 迁移说明里能直接抄的做法整理到一起,最后给一份精简版 AGENTS.md 的写法。

前置条件

第一步:像跟懂项目的同事说话,再补一句你会查什么

官方建议的写法很朴素:把需求描述成你会对一个熟悉项目的同事说的话,然后告诉 Codex 你审查时会看什么。指南里举的例子是图标:如果它要在 24 像素的工具栏里还认得出来,就直接写出来。Codex 会参考已有图标的风格,自己判断这个尺寸下能保留多少细节。

放到写代码的场景,一个可以照抄的模板:

把导出 CSV 的接口改成流式返回。
验收时我会看:
1. 10 万行数据导出时内存不再随行数线性增长;
2. 现有 export 相关测试全部通过;
3. 前端下载按钮的行为不变。
没达到这三条之前不要收尾。

指南的说法是:告诉它什么算完成、哪里需要做到穷尽。团队要的是一个结论时,就得让它把一条有希望的线索追到能和其他解释对比的程度。

第二步:推理档位按排查深度选

档位越高,模型越能在长任务里坚持把最后的检查做完,哪怕最终答案只有几行。代价是更慢、更费 token,子 Agent 文档写得很直白。

任务形态官方建议档位
快速摸底、看一圈现状Medium
沿一个可疑原因跨好几个系统追查High
几个原因可能相互影响,每个都要排查到Extra High
开放式研究,能干净地拆成几个各需深挖的问题Ultra(Codex 自己决定何时开子 Agent)

在 API 里新接入时,迁移说明建议从 medium 起步;原来用 none 或 minimal 的,改用 low。

档位决定它愿意查多深,验收标准决定它查到哪里停。两样只给一样,结果都会打折。

第三步:并行的活交给子 Agent

任务里有几块能各自推进时,在提示词里写一句 use subagents as needed,等于授权 Codex 自己判断什么时候拆、怎么拆。除 Ultra 以外的档位,想让它并行就得明说。

同类任务经常出现,就把这句话写进对应的 Skill 或 AGENTS.md,并注明适用条件,比如「请求里包含几个互相独立的问题时」。

子 Agent 的模型和档位默认继承主 Agent。想省钱或想更深,有三种改法:在提示词里点名模型或档位;在 config.toml 的 [agents] 里设默认值;或在自定义 Agent 文件里直接写 model 和 model_reasoning_effort。文档给的思路是:快速扫描交给 gpt-6-luna,难的子任务把 Sol 的档位调高;审查、安全类子 Agent 用 high。

第四步:视觉类任务给参考图,让它渲染后自己对照

心里有特定样子时,给一张参考图比写一段描述管用:形状怎么组合、哪个颜色突出、视线先落在哪,图里都有。可以从设计软件导出,也可以让 Codex 先用 GPT Image 生成一张。参考图定下来后,再让它做出成品、渲染出来、对照参考图改。

两条容易漏的要求:让它按用户实际看到的尺寸检查,大图里好看的细节缩小后可能就没了;成品能交互的话,让它亲手试一遍该支持的操作。

第五步:从旧模型迁过来,删掉一些老提示词

API 迁移说明里列了 GPT-6.2 Astra 的几处默认行为变化,对应要改的提示词:

参数层面:工具调用要走 Responses API;Chat Completions 里去掉 temperature、top_p、logprobs、top_logprobs。顶层 instructions 现在会被追加到 input 之后,想让固定指令吃到提示缓存,就把它们挪成 input 第一条 developer 消息。中途改写对话前缀会让 Responses API 丢掉推理内容,所以换设置时尽量别动前面的消息。

第六步:AGENTS.md 只写 Codex 推断不出来的东西

指南的建议是精简:只放从代码、测试、文档里看不出来的项目要求和约定,项目依赖某个固定流程时把流程写上,怎么干活的日常决定留给 Codex。Codex 读 AGENTS.md 时,所有层级合并后默认上限是 32 KiB(project_doc_max_bytes),超了后面的就读不到。

多个 Agent 共用一台机器时,指南建议在 AGENTS.md 里加上资源礼让和收尾清理:

## 共享机器
- 同时跑构建或测试前,先想清楚需要几个并行进程,给其他任务留 CPU 和内存。
- 确实需要整机资源的重任务可以占满。
- 收尾时停掉自己启动的后台进程,删掉不再需要的临时文件。

你一边用电脑一边让 Codex 干活时,可以在个人级 ~/.codex/AGENTS.md 里引导它优先用连接器之类不抢前台的工具。Codex Cloud 每个任务独占一台虚拟机,不存在这个问题。

常见坑

完成标准

Claude 那边也有一份同类指南,对照着看:Claude Fable 5.2 提示词怎么写。Codex 配置文件本身的写法见 Codex CLI config.toml 配置教程。

最后

下次给 Codex 派活时,先在需求后面补三行「验收时我会看」,再决定档位。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。