TL;DR给足上下文是官方最佳实践里最容易被跳过的一条。这篇把它落成开工前的检查清单：目标与验收、指定文件、约束禁区、复述确认，外加会末回写 AGENTS.md。
来源信号 SOURCES
以下内容整理自社区公开讨论，本页只做拆解与核实，不搬运原帖；观点归属原作者。
官方指南 · ChatGPT Learn《Best practices》· AGENTS.md 生态查看原帖 ↗Promptessor · Best AGENTS.md Examples 模板合集 · AGENTS.md 生态查看原帖 ↗
事实性知识 FACTS
这些是讨论中被多方印证、或可对照官方文档核实的事实。
- 官方最佳实践把给足上下文与先计划并列：开工前交代目标、约束与相关文件，是被点名的基础动作。
- 社区模板把「项目上下文」列为 AGENTS.md 的第一块内容，通常还包括架构说明、开发命令与编码规范。
- 官方建议把长期有效的约束沉淀进 AGENTS.md，用来减少每次会话的重复交代。
- AGENTS.md 是纯 Markdown 标准文件，随仓库分发，人和代理读的是同一份。
概念性知识 CONCEPTS
社区讨论里的概念不全是事实——每条都标注了它的性质，读之前先看标签。
上下文给足已验证事实
开工前主动交代目标、验收标准、相关文件与约束。官方最佳实践的组成部分，事实层面没有争议。
复述确认个人观点
让代理用自己的话复述任务与计划再动手，能提前暴露理解偏差。社区常用手法，不是官方要求。
同类实现参照个人观点
指定仓库里一个已有的同类模块让代理对着写，风格与错误处理都有现成答案。高频社区经验。
上下文过载待验证假设
反方向的担忧：一次塞进太多无关材料会稀释重点。多少算「过」目前没有公开测量，先按假设对待。
场景 SOP STEP BY STEP
目标每次让 Codex 动手前，用一张清单把上下文一次给足，把来回拉扯压到一两轮。
前提仓库已有 AGENTS.md 承载长期约定；如果还没有，先花 20 分钟补一份。
- 01一句话目标
开场先写「要什么 + 怎么算完成」：改动目标一句、验收标准一句，不含糊。
- 02指定要读的文件
点名入口文件、要改的模块、一个同类实现，明确说「先读这三个文件再动手」。
- 03交代约束
技术栈与版本、禁用的依赖、运行环境、要照顾的兼容性，一次说完，不挤牙膏。
- 04划出禁区
明确不要动的范围：无关重构、生成目录、锁文件、环境配置。
- 05复述方案再放行
要求它先复述任务并给出改动方案，你确认方向之后再让它写代码。
- 06会末沉淀
本次新学到的仓库事实与踩过的坑，写回 AGENTS.md，下次不用再讲一遍。
结果需求一次说清，Codex 的第一轮产出接近可用，重复解释的轮次明显减少。
看完之后 NEXT
想知道今天的重置判定？回到 首页实时雷达。