Codex 最新焚决发布了！

Codex 的最新一版“焚决”来了！它就是 OpenAI 官方前两天发布的《Rethinking skills and prompts for GPT-6 Astra》[1]这篇文章。

这篇指南分享的东西还挺有意义的，说实话，核心就是：换到 Astra 以后，过去积累的AGENTS.md、Skills 和任务提示词，哪些地方有必要重新检查一波。

我也拿自己的项目试了一波，让 Codex 按这篇指南检查现有规则，没想到效果还挺不错。它找出了与代码对不上的旧说明，还有项目里根本没配置的检查命令，后文会详细说。

平时用 Codex，遇到一次不满意的输出，很容易再追加一句“必须”或“禁止”。时间久了，每次都通读项目文档、反复跑测试、每一步先询问，这些要求就都留了下来。

模型升级之后，这些要求是否还适用，可以对照指南里的几个例子看。

旧规则也得重新看一遍

官方拿一个处理 Postgres 表结构迁移的 Skill 举例。它的使用条件如果写成“涉及数据库、查询或数据模型时使用”，范围就太宽了。用户只是问一条 SQL，也可能触发整套迁移流程。

官方给出的改法，是把触发条件限定在新增、修改迁移或审查迁移发布时。这样，描述里的任务就和这个 Skill 实际要做的事对应上了。

OpenAI 官方 Skill 示例：把宽泛的数据库关键词改为具体的迁移任务

Skill 的内容还可以分开存放，先用名称和描述判断是否需要，选中后读取SKILL.md，再按需读取参考资料或执行脚本。这就是渐进式披露。

JavaGuide 配图：Skill 先读取元数据，命中后加载正文，再按需读取资料

一个 Skill 同时包含设计、检查和发布流程时，可以把详细资料分开放，主文件写清各部分用于什么任务。如果装了多个功能接近的 Skills，还要检查描述是否重叠。几个 Skill 都写着“涉及开发就必须使用”，模型就更难判断这次究竟该选哪个。

AGENTS.md里也有类似的问题。官方的另一个例子，要求每次修改前都读架构、数据库和部署文档。

改服务职责，当然需要了解架构；调整表结构，需要看数据库约定。可这次只改一个错别字，通读这些资料就与任务就不太匹配了，属于是小题大作。

对于这种情况，需要分别说明各份文档用于什么任务。

OpenAI 官方 AGENTS.md 示例：按任务选择架构、数据库和部署文档

需要注意：图中 Good 示例的中文翻译有一处偏差。英文的意思是：涉及服务边界时读architecture.md，修改表结构时读database.md，准备部署时读deployment.md。

这类调整保留了文档入口，也补上了读取条件。业务约束和必要验收同样需要具体到任务：前端改动要通过构建，业务行为变了还要找到对应测试。至于已经交给格式化工具或 CI 执行的要求，规则里写清入口就够了。

这篇文章后半部分还谈到了确认和任务完成标准。OpenAI 还提醒： Astra 对指令更敏感，可能更愿意追问，小任务上的测试也可能超出实际需要。

比如你让它完成一个功能，希望它接着运行、检查结果、修复问题，旧规则却要求第一版实现后停下等审阅，它就可能在那里等你。保留这个审阅节点，还是允许它继续完成本地验证，需要在指令里说清楚。

测试的停止条件也得明确。相关检查已经通过，又没有新改动或新问题，就可以交付；必需的测试因为环境问题没跑起来，则要说明缺口。反复强调“多测几遍”，很难替代这些具体要求。

让它查了一遍我的项目

我把官方链接和检查要求发给 Codex，让它审查本地的 AI 模拟面试项目interview-guide。

它列出了 5 项建议，都比较实用。

Codex 审查 interview-guide：检查提示词、审查结论与规则生效范围

这里以其中一条限流规则为例说一下。

规则原文写着：每个@RateLimit是独立维度，分别执行 Redis Lua 滑动窗口。

可对照代码，RateLimitAspect已经把同一方法上的全部限流维度交给一次 Lua 调用。脚本先检查所有维度，全部通过后才统一扣减。文档里的“分别执行”，和当前实现对不上了。

拿全局额度和 IP 额度来说，如果先扣了全局额度，再发现这个 IP 已经超限，请求被拒绝了，全局额度却少了一份。

Codex 建议把规则改成：同一方法的全部限流维度在一次 Lua 调用中检查，全部通过后统一扣减；任一维度拒绝，不修改任何维度状态。

我又让 Codex 对照了规则文件、切面、Lua 脚本和测试代码，发现这个差异确实存在。

代码改了，给 Agent 看的说明却还停在旧写法。之后再处理限流，旧说明就可能把它往错误的方向带。

可以直接让 Codex 帮你查

你甚至可以不用读这篇原文，直接让 Astra 按文章内容审查自己的配置。

在项目里把官方链接和下面这段提示词一起发给 Codex，就可以了：

根据这篇官方文章 https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra ，检查当前项目的 AGENTS.md 和相关 Skills。
找出触发条件过宽、指令重复或冲突、无条件读取资料、
不必要等待，以及任务完成标准不明确的地方。


每项建议给出文件位置、原文、适用场景和最小修改 diff。
保留必要的业务约束、权限要求和验收标准。
区分已有执行记录支持的问题和仅根据规则推测的问题。
本轮先给建议，不修改文件；没有依据的问题不用凑数。

拿到结果后，可以先挑一条有代码依据的建议修改，再用熟悉的任务验证。

总结

模型能力越来越强，过去为了让它少犯错而加上的步骤，现在也值得重新检查。

哪些事情它已经能处理，哪些地方还需要项目规则约束，得放到具体任务里判断。Skill 的触发条件、资料读取范围和验收要求，也要跟着项目和模型的变化更新。

参考资料

《Rethinking skills and prompts for GPT-6 Astra》:

https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra