AI Agent / 系统课时

理解上下文来源

理解上下文来源

Codex 的判断并不只来自你最后输入的一句话。工作目录决定可见的项目边界,打开文件和选中代码提供局部焦点,对话记录保留约束,工具输出则提供最新证据。理解这些来源,才能判断它为什么“知道”某件事,也能发现上下文何时已经过期。

学习目标

  • 说明工作目录、文件焦点、对话记录和工具输出各自承担什么作用
  • 区分长期有效的项目事实与只对当前步骤有效的临时信息
  • 用简单检查确认 Codex 当前看到的项目边界,减少因上下文误判造成的错误

上下文不是一个文件

可以把上下文理解为一组同时参与判断的输入,而不是一个固定文档。工作目录限定当前任务主要落在哪个项目;在支持编辑器上下文的客户端或集成中,打开文件与选中代码会把注意力集中到局部;对话记录保存你已经明确的目标和限制;工具输出则告诉 Codex“刚刚实际发生了什么”。

Codex 任务中的主要上下文来源

这些来源的可信度和时效性不同。某段旧对话可能已经被新的需求覆盖,打开的文件也不一定就是唯一相关文件;相反,刚运行的测试结果或实际读取到的配置通常更接近当前事实。遇到冲突时,应先让 Codex重新读取或验证,而不是继续基于旧假设推演。

区分稳定上下文与临时上下文

上下文来源 主要作用 常见风险
工作目录 确定当前项目和相对路径基准 目录选错会让搜索、命令和修改落到错误项目
打开文件、选中代码 指出当前关注的局部实现 只看局部可能漏掉调用方、测试或共享类型
对话记录 保存目标、边界和已确认决策 旧要求可能与后续纠偏冲突
工具输出 提供文件内容、测试、构建或命令的最新事实 输出可能只覆盖一次运行,需要结合命令与环境理解

因此,不要把“出现在上下文里”理解成“永远正确”。稳定约束应保持简洁一致,临时证据则应该随着执行持续刷新。

用最小检查确认项目边界

当你怀疑 Codex 读错目录、拿错仓库或依据了过时状态,可以先检查当前工作目录和 Git 根目录。下面的命令不会修改文件,适合作为开始复杂任务前的快速确认。

bash
pwd
git rev-parse --show-toplevel 2>/dev/null || echo "not in a git repository"
git status --short 2>/dev/null || true

预期输出

text
<PATH>
<PATH>
 M <PATH>

上面的输出假设当前位于一个 Git 仓库,并且至少有一个已修改文件;实际路径和状态行会不同。若第二行显示 not in a git repository,应先确认工作目录,再让 Codex继续搜索或修改代码。

接着可以要求 Codex 在动手前先列出它准备读取或修改的关键文件。这样做不是为了让它复述整个仓库,而是用很小的成本确认“任务目标”和“当前项目边界”是否对齐。

减少上下文污染

高质量上下文强调相关性,不强调数量。只提供与任务有关的文件、约束和验收标准;当方向改变时,明确指出旧要求已被替换;工具已经给出新证据后,不要继续要求它沿用先前猜测。

当结果与预期不一致时,先问“它依据了哪一类上下文”,通常比立即重写提示词更有效。先校准工作目录和事实来源,再补充任务约束,能够显著减少在错误上下文上继续工作的成本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解上下文来源

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通