贴图
GPT-6.2 发布:AGENTS.md 该留什么?
换个任务还用得上吗?我按三类分。
01|长期约束写进 AGENTS.md
• 留下跑得通的构建、测试、lint 命令,写明执行目录。 • 写明哪些操作需先确认,如发布、删除。 • 写清哪些检查通过才算完成。删掉空话,合并重复要求。
02|本次要求写进提示词
• 指定交付物和可改范围。 • 写清验收方法,如复现步骤与预期结果。
03|长说明放文档,重复流程放 Skill
• 架构说明、参数表放参考文档,规则里写明何时查、去哪查。 • 重复流程做成 Skill,列出触发条件、步骤和检查方法。
OpenAI《Best practices》 https://learn.chatgpt.com/guides/best-practices
哪份规则会生效?
个人默认放全局,团队约定放仓库根,局部例外放子目录。
Codex 启动时先查全局(默认 ~/.codex,可由 CODEX_HOME 指定),依次尝试 AGENTS.override.md、AGENTS.md,取首个非空文件。
再从项目根(通常是 Git 根)走到当前工作目录。找不到根时,项目层只查当前目录。沿途每个目录最多取一份非空文件,依次尝试 AGENTS.override.md、AGENTS.md、配置的候补名。各层从根往下合并,冲突时近处优先,其余规则仍适用。
改完后,从目标目录新启动 Codex,让它列出生效文件与顺序,再与磁盘对照。CLI 可用 /debug-config 查看配置层及来源。 https://learn.chatgpt.com/docs/agent-configuration/agents-md
一键体检/升级|从下段复制到第二个网址
只读检查当前目录适用的规则与配置。核对加载顺序和适用范围。从项目脚本核实构建、测试、lint 命令及运行条件。区分已实测和待验证,会写文件的命令暂缓。 逐条建议保留、移出或删除,保留必要限制和已有改动。 只给规则文件的最小统一 diff,逐项说明理由。我明确批准后才写盘。不写死模型或推理强度,不执行迁移或扩展任务。
OpenAI 官方出处
https://learn.chatgpt.com/guides/best-practices#make-guidance-reusable-with-agentsmd
https://learn.chatgpt.com/docs/agent-configuration/agents-md
#Codex #AGENTSmd