上下文工程

上下文工程关注一个核心问题：在有限上下文窗口里，Agent 应该看到什么、忽略什么、记住什么，以及如何证明这些选择没有破坏任务质量。

上下文分层

层级	内容	维护方式
目标	用户任务、验收标准、限制条件	OpenSpec 或任务清单
项目知识	架构、约定、运行方式	README、AGENTS、项目记忆
工作状态	当前假设、已完成步骤、失败输出	notepad、trace、任务列表
外部知识	文档、API、搜索结果	MCP resource 或检索系统
操作证据	测试、构建、日志、截图	Harness 和验证报告

设计原则

• 越接近任务目标的信息优先级越高。
• 大块上下文要先摘要再注入。
• 不把密钥、个人数据或无关日志交给模型。
• 每次工具调用后的结论要能回到任务状态。
• 重要假设必须被测试、文档或来源支撑。

练习

为一个“修复文档站 404”的 Agent 任务设计上下文包：

1. 必须包含哪些文件？
2. 哪些日志只需要摘要？
3. 哪些外部信息需要重新确认？
4. 哪些内容不应该进入上下文？

下一步阅读 工作流编排。