提示词与上下文工程概览

本章关注如何把任务表达清楚，让 Codex 拿到足够上下文后稳定输出，而不是依赖猜测。

为什么这一章重要？

用 Codex 的过程中，你大概率遇到过这些问题：

这些问题的共同根源：你把 Codex 当搜索引擎用，而不是当协作者用。 搜索引擎只需要关键词，协作者需要完整的任务上下文——目标、背景、范围、约束、验收标准。

本章的核心观点：输出质量的上限不取决于模型能力，而取决于你给它的上下文质量。

本章核心概念

在开始阅读之前，先建立几个关键认知：

1. 提示词 ≠ 一句话

提示词是你对 Codex 的任务描述。它可以是一句话（"修这个 Bug"），也可以是结构化的多段信息（目标 + 背景 + 范围 + 约束 + 验证）。信息密度越高、结构越清晰，Codex 的输出质量越稳定。

2. 上下文 > 提示词

提示词只是上下文的一部分。Codex 看到的全部信息包括：你的提示词、AGENTS.md / rules 等配置文件、@mention 的文件引用、对话历史、代码库内容。只优化提示词而忽略其他上下文，效果有限。

3. 验收标准是任务描述的一部分

"做完了"和"做对了"是两回事。验收标准让 Codex 能自我判断任务是否完成，而不是做完一堆东西等你逐行审查。

4. 多轮协作 ≠ 一条超长提示词

复杂任务不要试图用一条提示词搞定。拆成多轮，每轮有明确目标，轮与轮之间有校准点。

本章文章

推荐阅读路径

根据你的情况选择起点：

• 新手快车道：02 → 03 → 04 — 先理解基本概念，学会写清楚任务，再学会定义"做完了"。适合刚开始用 Codex 的人。
• 进阶路径：02 → 03 → 04 → 05 → 06 — 完整方法论 + 上下文工程思维。适合已经用过 Codex 但想系统提升的人。
• 实战导向：02 → 03 → 07 — 写完模板直接查案例。适合"我知道该怎么写但想看具体例子"的人。
• 问题驱动：直接跳到对应文章——输出偏差看 03，验证不到位看 04，多轮失控看 05，大项目不稳定看 06。

与其他章节的关系

本章不是孤立的——它和多个章节有直接的上下游关系：

• 配置与个性化（第 05 章）：AGENTS.md / rules / skills 是上下文工程的"指令层"。当你发现 Codex 不遵循项目规范时，可能需要同时调整 AGENTS.md（第 05 章）和提示词（本章）。
• 记忆与长期上下文（第 07 章）：跨线程记忆是上下文工程的"记忆层"。本章 06 篇讲记忆层的设计理念，第 07 章讲具体配置。
• 子智能体与并行（第 08 章）：多 Agent 编排是上下文工程的"协调层"。本章 05 篇讲委派的基本思路，第 08 章讲子代理的详细配置。
• 最佳实践（第 12 章）：任务设计、工作流等是本章方法论的工程化沉淀。本章讲"怎么想"，第 12 章讲"怎么做"。
• 模板库（第 15 章）：把本章的提示词模板沉淀为可复用工件。本章 03 篇和 07 篇给出的模板，可以存放到模板库供团队复用。

前置知识

阅读本章前，建议你已经：

• 完成了 Codex 的安装和认证（见 快速上手 和 登录与认证）
• 知道 Codex 有 App / CLI / IDE 三种入口（见 使用方式概览）
• 至少用过一次 Codex 完成简单任务（改个文案、修个小 Bug）

如果你还没有完成这些，建议先去第 01 章和第 03 章把基础补齐，再回来读本章。

本章学习建议

如果你发现 Codex 经常改偏、问太多问题或验证不到位，这一章最值得优先补。建议从 03-quality-task-templates 开始——大多数输出偏差的根源是任务描述不够结构化。