AI Agent / 系统课时
理解上下文来源
理解上下文来源
Codex 的判断并不只来自你最后输入的一句话。工作目录决定可见的项目边界,打开文件和选中代码提供局部焦点,对话记录保留约束,工具输出则提供最新证据。理解这些来源,才能判断它为什么“知道”某件事,也能发现上下文何时已经过期。
学习目标
- 说明工作目录、文件焦点、对话记录和工具输出各自承担什么作用
- 区分长期有效的项目事实与只对当前步骤有效的临时信息
- 用简单检查确认 Codex 当前看到的项目边界,减少因上下文误判造成的错误
上下文不是一个文件
可以把上下文理解为一组同时参与判断的输入,而不是一个固定文档。工作目录限定当前任务主要落在哪个项目;在支持编辑器上下文的客户端或集成中,打开文件与选中代码会把注意力集中到局部;对话记录保存你已经明确的目标和限制;工具输出则告诉 Codex“刚刚实际发生了什么”。

这些来源的可信度和时效性不同。某段旧对话可能已经被新的需求覆盖,打开的文件也不一定就是唯一相关文件;相反,刚运行的测试结果或实际读取到的配置通常更接近当前事实。遇到冲突时,应先让 Codex重新读取或验证,而不是继续基于旧假设推演。
区分稳定上下文与临时上下文
| 上下文来源 | 主要作用 | 常见风险 |
|---|---|---|
| 工作目录 | 确定当前项目和相对路径基准 | 目录选错会让搜索、命令和修改落到错误项目 |
| 打开文件、选中代码 | 指出当前关注的局部实现 | 只看局部可能漏掉调用方、测试或共享类型 |
| 对话记录 | 保存目标、边界和已确认决策 | 旧要求可能与后续纠偏冲突 |
| 工具输出 | 提供文件内容、测试、构建或命令的最新事实 | 输出可能只覆盖一次运行,需要结合命令与环境理解 |
因此,不要把“出现在上下文里”理解成“永远正确”。稳定约束应保持简洁一致,临时证据则应该随着执行持续刷新。
用最小检查确认项目边界
当你怀疑 Codex 读错目录、拿错仓库或依据了过时状态,可以先检查当前工作目录和 Git 根目录。下面的命令不会修改文件,适合作为开始复杂任务前的快速确认。
pwd
git rev-parse --show-toplevel 2>/dev/null || echo "not in a git repository"
git status --short 2>/dev/null || true预期输出
<PATH>
<PATH>
M <PATH>上面的输出假设当前位于一个 Git 仓库,并且至少有一个已修改文件;实际路径和状态行会不同。若第二行显示 not in a git repository,应先确认工作目录,再让 Codex继续搜索或修改代码。
接着可以要求 Codex 在动手前先列出它准备读取或修改的关键文件。这样做不是为了让它复述整个仓库,而是用很小的成本确认“任务目标”和“当前项目边界”是否对齐。
减少上下文污染
高质量上下文强调相关性,不强调数量。只提供与任务有关的文件、约束和验收标准;当方向改变时,明确指出旧要求已被替换;工具已经给出新证据后,不要继续要求它沿用先前猜测。
当结果与预期不一致时,先问“它依据了哪一类上下文”,通常比立即重写提示词更有效。先校准工作目录和事实来源,再补充任务约束,能够显著减少在错误上下文上继续工作的成本。