Codex 的表现高度依赖于它所能感知的上下文 (Context)。当 AI 给出错误的建议或找不到目标文件时，通常是因为它缺失了关键的项目信息。

上下文的三个层次

  1. 文件级上下文：当前正在编辑的文件内容。

    2. 2. 项目级上下文：目录结构、配置文件（package.json, config.toml）、全局类型定义。

    3. 规则级上下文：AGENTS.md 中定义的团队规范、禁用路径和操作禁忌。

    什么时候需要手动补充上下文？

    • 处理跨模块依赖：当修改 A 模块需要参考 B 模块的接口定义时。
    • 处理隐含业务逻辑：当代码中存在未显式注明的业务规则（如“用户等级必须大于 5 才能发帖”）。
    • 解决环境差异：当项目在不同操作系统或 Node 版本下有特殊表现时。

    补充上下文的专业技巧

    1. 显式路径指定

    不要模糊地描述“登录逻辑”，而应直接给出文件路径：

    > “请参考 src/auth/login-service.ts 中的加密方法，在 src/api/auth.ts 中实现登录接口。”

    2. 利用只读分析“喂养”上下文

    在执行任务前，先让 Codex 读取相关文件：

    > “请先阅读 docs/api-spec.md 和 src/types/user.d.ts，理解最新的接口规范和用户对象结构。读完后请回复‘已理解’。”

    3. 使用 AGENTS.md 固化上下文

    将长期有效的项目信息写入 AGENTS.md，Codex 在每次启动时都会自动同步这些背景，无需反复说明。

    避免上下文污染

    补充上下文并非“越多越好”。过多的无关信息会稀释 AI 的注意力，导致推理速度变慢甚至产生幻觉。

    • 只补充必要的：只提供与当前任务直接相关的背景。
    • 保持结构化：使用 Markdown 标题或列表清晰地组织补充的信息。

    ---

    下一步：引导 AI 澄清 —— 学习如何与 AI 进行双向沟通。