Codex 上下文工程实战：如何构建最小而有效的 Context Pack

上下文不是材料数量，而是决策证据

每一份上下文都应该帮助回答一个问题：目标是什么、当前实现在哪里、什么行为必须保持、怎样验证变化。与任务无关的历史讨论、完整日志和重复文档会挤占注意力，也会让旧结论被误当成当前事实。

最小 Context Pack 的五部分

从仓库规则和任务目标开始，再提供最接近问题的代码入口、复现证据与接口契约，最后给出验证命令。对于未知调用链，可以先让 Codex 搜索符号和测试，再根据结果增加文件，而不是提前猜测并提供整个目录。

• 仓库规则：AGENTS.md、README 和开发命令
• 任务目标：可观察结果与验收条件
• 代码入口：路由、组件、服务或调用方
• 问题证据：错误日志、失败测试和请求样例
• 验证方式：最小测试、类型检查和构建

用渐进式调查替代一次性倾倒

第一轮只定位调用链和真实数据流，第二轮读取直接依赖与测试，第三轮才处理框架行为或外部文档。每轮都记录新证据和仍未确认的假设。这样既减少上下文噪声，也便于审查 Codex 为什么选择某个实现。

保持上下文可更新、可追踪

稳定规则放入 AGENTS.md，接口契约保存在版本控制，临时日志只保留关键片段并标注时间。任务结束后，把被证明有用的命令和边界更新到项目文档，把已经失效的假设删除。上下文工程不是一次提示技巧，而是持续维护工程事实。