OpenAI Codex 架构师谈新一代 Coding Agent 如何给 AGENTS.md 和 Skill 瘦身

AYi · @AYi_AInotes · X·2026-09-05 21:56·21分钟前
AI 导读

作者转发 OpenAI Codex 架构师 @pvncher 的文章,指出新一代 Coding Agent 时代,为弱模型搭建的长提示词和 Skill 脚手架正在烧 Token 并引发早停。官方给出 5 条规则:Skill 描述只写触发条件、删掉 AGENTS.md 里的每次必读文档、对安全测试环境彻底放权、开工只锁完成标准不写细步骤,并附上可直接复制的仓库自检审计 Prompt 和放权模板。

AYi@AYi_AInotes
72AI 编辑部评分,满分 100

OpenAI Codex 架构师谈新一代 Coding Agent 如何给 AGENTS.md 和 Skill 瘦身

2026-09-05 21:56· 21分钟前
AI 导读

作者转发 OpenAI Codex 架构师 @pvncher 的文章,指出新一代 Coding Agent 时代,为弱模型搭建的长提示词和 Skill 脚手架正在烧 Token 并引发早停。官方给出 5 条规则:Skill 描述只写触发条件、删掉 AGENTS.md 里的每次必读文档、对安全测试环境彻底放权、开工只锁完成标准不写细步骤,并附上可直接复制的仓库自检审计 Prompt 和放权模板。

当所有人还在疯狂给 AI 堆长提示词、狂塞 Skill,OpenAI Codex 架构师这篇文章直接把全网干沉默了:
别再洋洋得意你的 AGENTS.md 写得有多厚了。

新一代 Coding Agent 早就进化了,你过去为了“扶着弱模型走”建的整套脚手架,现在每分每秒都在拖后腿、烧 Token、引发早停。 改个 Typo 也要强读三份架构文档不叫严谨,叫纯纯的浪费。

官方给出的 5 条工程瘦身军规,建议所有玩 Agent 的人立刻自查: 1️⃣ Skill 描述是“触发条件”,不是“能力广告”:
别把 Skill 当收藏夹。装太多不仅会被上下文截断,还会引发工具互相抢戏(Pick-me energy)。描述只写“何时触发”,绝不写成几十行的功能推销,多工作流必须走“根文件路由 + 按需展开”;

2️⃣ 砍掉 AGENTS.md 里的“每次必读圣经”:
删掉“每次编辑前必读全套文档/必跑全量测试”。新模型自己懂分寸,文档必须从“强制通读”改成“按任务场景动态指向”;

3️⃣ 对安全环境彻底放权,消灭半路早停:
新模型更谨慎,你写“每步先问我”,它做出第一版就会停下来等你审。在本地可丢弃的测试环境,直接写死放权:“跑测试、修因改动引发的报错、重测通过再回来”,绝不每步请示;

4️⃣ 开工只锁“完成标准”,不写过细菜谱:
别把执行步骤卡死。告诉它目标、禁忌和明确的验收线(做到什么程度算完),过细的行程表反而会绑死顶级大模型的大脑。

新模型升级,不是让你写更多指令的窗口,而是让你把旧脚手架拆掉的窗口。
 先给仓库瘦身,再让它跑以前不敢放手的高难度任务。
 官方推荐的【仓库自检审计 Prompt + 放权模板】放在评论区一楼,可以直接复制扔给 AI 自查 👇

eric provencherhttps://x.com/i/article/2095989703967125509