OpenAI 官方指南解读：优化 Codex 的 AGENTS.md 与 Skills

OpenAI 在面向 GPT-6 Astra 的官方最佳实践中，建议重新审视 AGENTS.md、Skills 和任务提示词：收窄技能触发范围、按需读取文档，并明确执行边界与完成条件。本文围绕这份指南，讲解如何为 Codex 做配置优化，并补充可复制的中文审查模板、最小修改示例及验证与回滚步骤。官方建议提供判断依据，具体改法仍需结合你的项目，保留必要的质量检查和权限要求。

先判断问题在哪

2026 年 9 月 11 日，OpenAI 发布了 Eric Provencher 撰写的《Rethinking skills and prompts for GPT-6 Astra》。随后 X 上出现了让 Codex 根据文章审查配置的分享。原文支持重新审视旧指令，但没有给出适用于所有项目的配置，也没有承诺统一的 token 节省比例。

先回看一两次不满意的任务：它究竟多做了什么，或者在哪一步停了下来？“修改一个标题，却先阅读部署文档”和“修复登录逻辑后检查鉴权回归”看起来都多了步骤，必要性却不同。以下症状可以帮助你确定审查入口。

本文依据官方文档整理，并提供原创的中文操作模板；没有在你的项目中执行前后对照测试。它针对 GPT-6 Astra 提出的行为特点设计，但团队使用其他模型时，也应保留各自需要的约束并分别验证。

圈定审查文件

先在 Codex 中打开实际工作的项目目录。不要一开始就要求“扫描电脑上的全部 Skills”：全局偏好、项目规则、插件文件的影响范围不同，混在一起修改，出问题时很难判断原因。

按当前官方 AGENTS.md 文档，Codex 会考虑全局及项目作用域；同一层存在 AGENTS.override.md 时，它会优先于普通 AGENTS.md。项目内更接近工作目录的指令也可能影响最终行为。因此，只改仓库根目录的一份文件，不一定改到了真正控制任务的条款。

1. 列出候选来源。让 Codex 说明当前工作目录、它能确认的全局与项目指令来源，以及目标任务相关的 Skill 路径。没有读取或无法访问的来源单独列出。
2. 限定首轮范围。选择一个真实症状，审查相关 AGENTS 文件及少量可能被误触发的 Skill。已经有明确业务规范时，把其入口一起列入。
3. 确认维护源。自建规则改源文件；插件安装缓存、生成文件或同步副本先查维护方式。直接改缓存可能在更新时丢失。
4. 准备备份。在修改前复制目标文件到不会被技能扫描的独立备份目录，并记录原路径。不要把备份当成第二个同名 Skill 放回发现目录。

如果当前问题是 Skill 完全不出现或不会触发，先用Codex Skills 安装与生效排查教程解决发现和调用问题。本文从“规则已经参与工作，但行为不合适”开始。

先运行只读审查

把下面模板复制到目标项目的 Codex 对话里，替换方括号中的信息。它把截图里的审查思路补充成可核对的输出要求；这是本文整理的模板，不是 OpenAI 官方原样提示词。

请根据这篇官方文章，对本项目做一次只读指令审查：
https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra

我遇到的具体问题：[例如：只修改文章标题，却读取了部署与数据库文档。]
本轮范围：[项目 AGENTS.md，以及与这次任务相关的自建 Skills。]

先确认能访问的指令来源与实际路径。只读取判断该问题需要的文件，
不要运行被审查 Skill 的业务流程，也不要修改文件或安装工具。

检查：过宽的 Skill 触发条件、无条件读取、重复或冲突的指令、
与任务风险不相称的检查、重复确认，以及不清楚的完成条件。

每个问题给出：文件路径、原句短摘录、触发场景、可能造成的行为、
最小替换文本，以及这项修改仍然保留哪些必要约束。
区分已确认的冲突、需要实际任务验证的风险和单纯风格偏好。
找不到具体依据时不要为了精简而删规则。

先列影响最大的少数问题；报告未读取或无法验证的范围。
只提交建议，不把建议当成已执行修改。

预期结果是一份能逐条对照文件的审查清单。若输出只有“文件太长，建议精简”，要求它补充具体触发场景。例如，“每次编辑都读取部署文档”可以与改标题任务对应；“这段规则看起来啰嗦”不能单独证明应该删除。

还要分清冲突和条件不同。发现阶段只交付候选、选题确定后继续生产，并不矛盾；真正值得改的是没有写明适用阶段，导致同一任务同时收到“继续”和“停止”的指令。

把条款改到具体处

收窄 Skill 触发

Skills 的名称和描述帮助 Codex 决定是否使用某项能力，完整 SKILL.md 则在选用后读取。若一个“发布文章”技能写成“涉及写作、网页、搜索或链接时必须使用”，一次普通的网页阅读也可能引入发布流程。

对你自己的文章发布 Skill，可以参考下面这组原创改写。名称、输入输出和业务要求保持不变，只收紧使用条件：

改前：
处理文章与网站内容。涉及写作、网页、搜索或链接时必须使用。

改后：
创建或更新本站文章草稿时使用。仅阅读网页、讨论选题或解释文字时不触发。

如果一个技能确实承担多个流程，保留简短入口，让它根据“查资料、写正文、写入草稿”等具体任务再读取对应参考文件。不能只把正文挪到 references 目录，却仍规定每次读取全部 references，那样只是换了存放位置。

按任务读取规则

给文档写清用途比只列出文件名更有帮助。例如，把“每次修改前阅读所有运营规范”改成：

写文章正文时读取内容架构规范；
修改分类、标签或 SEO 字段时读取字段规范；
上传图片时读取媒体规范；
执行公开发布时读取发布流程。
同一任务涉及多个部分时，读取各自对应的规范。

这里保留了业务标准，只减少了无关任务的预读。如果某份规范中有所有任务都需要遵守的短规则，应将其留在总入口，不能在拆分时把它藏进很少触发的文件。

写清继续与停止

“遇到任何不确定就先问我”容易把普通实现选择也变成等待条件。相反，“永远不要问，做完一切”又没有说明授权范围。可以按已知的工作环境这样表达：

在当前任务已授权的对象和字段范围内，完成可逆修改及必要检查。
普通实现选择可作合理假设并记录；缺少会改变目标或授权范围的关键信息时再询问。
遇到单项阻塞，先继续不依赖它的已授权工作。
公开发布、删除数据和扩大权限按项目原有审批要求执行。

这段话不能覆盖工具自身的权限限制，也不应被用来规避登录、验证或审批提示。如果真正的阻塞来自环境，报告具体错误并按权限流程处理，比反复改提示词有效。

给检查设置终点

检查是否必要，要看它验证的风险。例如，修复登录逻辑需要验证正常与拒绝路径；给说明文档改错别字，通常不必为这几个字新增测试。可将泛化的“反复检查到完全满意”改为：

按本次改动验证可能受影响的行为，并完成项目要求的检查。
检查通过且没有新变更、新失败或未解决风险后即可交付。
发现问题时修复并复验受影响部分；不要仅为增加检查次数重复同一验证。

这些例子都需要结合项目采用，不应覆盖已经准确的条款。第三方 Skill 如果包含脚本、网络调用或额外权限，还应按第三方 Agent Skill 安全审计流程检查整个包；缩短描述不会消除脚本风险。

再执行最小修改

审查通过后，明确选择准备采用的条目。第一次适合只改一份规则或同一个症状相关的几条指令，避免把写作风格、目录结构、工具选择和授权规则一起重构。

采用刚才审查中的第 [编号] 项，其他建议暂不执行。
允许修改的文件：[填写准确路径]。

修改前将这些文件备份到 [独立备份目录]，记录原路径和备份路径。
只应用已选条目的最小替换，保留其他内容和必要的业务、质量、权限边界。
若目标是插件缓存或生成副本，先确认维护源，不直接覆盖缓存。

修改后回读文件，给出逐项差异、保留的约束和验证方法。
本轮完成条件是备份已保存、已选修改已写入并回读一致。
遇到超出已选范围的改动，先说明原因。

完成后应能看到三个明确结果：备份在哪里、哪几句已变更、回读是否一致。只有建议文本或拟定补丁，还不算已经修改成功。

AGENTS.md 与 Skill 的加载方式并不完全相同。为减少旧上下文影响，修改后建议从目标目录启动一次新任务，并让 Codex 确认相关指令来源；官方文档也建议在指令看起来陈旧时重新启动。不要仅凭旧对话里一句“我已记住”判断生效。

验证效果与回滚

用同一模型、相同任务要求和相同起始文件做对照。先检查结果质量，再看额外读取、等待和工具调用是否减少。下面是一张记录框架，不是测试数据。

有可用用量记录时，再比较输入、输出 token 和总耗时；没有就记录工具调用、无关文件读取和等待节点，不要把感觉写成百分比。一次更快可能来自缓存、网络或任务波动；判断是否改善，应优先看相同需求是否完成、必要约束是否仍有效。

出现退化时，不必继续添加更多补丁。把受影响文件恢复为本次备份；如果期间还有其他修改，只撤回本轮差异，避免覆盖后续工作。再开新任务复查同一症状。缩窄描述后漏触发，就补充一个具体适用场景；重复确认仍存在，就根据新的停止位置查规则来源，不要把所有审批条款一起删掉。

如果你的问题涉及更换工具或工作入口，而非现有指令，可以继续阅读AI 编程助手选型指南，区分 IDE、终端 Agent 与云端任务各自的工作方式。

原文与文档

• OpenAI 原文（2026-09-11）：https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra
• AGENTS.md 作用域与验证：https://learn.chatgpt.com/docs/agent-configuration/agents-md
• Skills 结构、描述与加载：https://learn.chatgpt.com/docs/build-skills