上下文工程

上下文工程不是把提示词写得更长，而是把任务所需的信息以稳定、可审计、可压缩的方式交给模型。

上下文分层

推荐把上下文分成四层：

1. 系统约束：角色、权限、输出格式、禁止事项。
2. 用户意图：目标、成功标准、边界。
3. 工作状态：已完成步骤、工具结果、失败记录。
4. 参考材料：文档片段、代码、日志、外部资料。

好的上下文长什么样

目标：
- 修复文档站 build 失败

已知事实：
- Next.js 版本是 16.x
- 文档内容来自 content/docs

当前阻塞：
- MDX 编译报 frontmatter 错误

下一步：
- 先定位具体文件
- 再修复 frontmatter 或 MDX 语法

常见策略

• 对长资料先做结构化摘要，再注入原文片段。
• 对工具结果保留来源和时间。
• 对用户偏好只注入与当前任务相关的部分。
• 对失败轨迹保留关键节点，而不是完整 token 流。

质量检查

一次上下文构造完成后，检查它是否满足：

• 模型能知道目标是什么。
• 模型能知道不能做什么。
• 模型能引用证据。
• 模型能判断何时停止。