上下文包的作用，是让 Codex 少猜关键事实。它可以包含相关文件、最短复现、原始日志和截图。每份材料都要说明来源与用途，数量服从任务需要。把整个目录和一大段无关日志全塞进去，重要线索反而容易被淹没。
本文内容核对到 2026 年 8 月。文件与图片的添加入口可能调整，官方建议仍然适用，提供材料时要指出需要检查的部分和期望结果。
文件提供结构和约束
先给最靠近问题的文件，再补直接调用者、数据结构或现有测试。路径比模糊名称可靠，同名文件很多时写到仓库根目录的相对位置。项目规则、运行说明和测试命令可以引用对应文档，无需复制整份仓库介绍。
本次聊天才需要的文件可以直接添加。多次聊天都会使用的资料，更适合放进项目。桌面端本地项目还能关联电脑文件夹，开始前要确认主目录是否正确，附加目录有没有把无关数据带进来。
日志保留发生顺序
日志至少要包含触发动作、原始错误和发生时间附近的必要上下文。截取时保留第一条有效异常，后续连锁报错可以缩短。删除访问令牌、邮箱、客户标识和内部地址以后，再把材料交给 Codex。
如果日志来自生产环境，要说明你只提供了脱敏片段。Codex 可以据此提出调查方向，无法凭一段片段确认整个线上流程。能够在本地复现时，再补启动命令、输入条件和退出状态。
截图负责可见状态
错误弹窗、页面错位和设计对比都适合用图片。添加图片后，写清它来自哪个步骤，需要看哪个区域。两张图片用于前后对比时，标明基准图与当前图，并补充图片里看不到的交互、屏幕宽度和浏览器信息。
图片只能证明当时可见的状态。它无法替代控制台错误、DOM 结构或文件路径。要求 Codex 修复界面时，最好同时提供相关组件和可重复打开的路由。
用一句连接说明把材料串起来
上下文包完成后，写出材料之间的关系。下面是一种够用的写法。
checkout.webp是 375 像素宽度下的当前页面，按钮底部被遮住。CheckoutPanel.tsx是相关组件，console.txt记录刷新页面后出现的错误。请先定位原因，只修改结账页布局，并保留现有提交行为。
这段说明交代了现象、文件、日志和边界。Codex 可以先核对三份材料是否指向同一问题，再开始修改。
当前事实需要单独标明来源
任务涉及产品版本、价格、接口规则或平台限制时，附上核验日期和第一方链接。让 Codex 使用当前来源，并把无法确认的内容留成问题。旧文档仍可用于理解历史行为，不能直接证明今天仍然有效。
来源之间出现冲突时，保留各自时间和适用范围。先确定当前任务依赖哪一条规则，再决定是否修改代码。
发送前做一次清理
删除与任务无关的文件，确认材料没有密钥和个人数据。检查日志是否完整保留关键错误，截图说明能否让没见过页面的人找到目标区域。最后写明输出形式和验证办法。材料不足时允许 Codex 先提问题，不要让它用猜测补齐缺口。