第8章 上下文工程(进阶):让 Agent 看见对的信息

第 8 节 / 共 13 节 课程:DeepSeek Harness 实战课

进阶章节:第一次阅读可以跳过,不影响后面的实战。等你要长期接项目、让 Agent 持续记住上下文时,再回来读这一章。

进阶章节。目标不是让 Agent 记住一切,而是让它在正确的时刻看到正确的信息。

不是越多越好

模型有上下文窗口,但“能装下”不等于“能用好”:信息太多会稀释注意力;信息太旧会与当前代码/数据不一致;信息太散要花很多步拼图;信息冲突会选错版本。好的上下文是当前任务所需的最小充分集。

会话卫生

新任务开新会话;长会话定期总结—落盘—重开;不要把失败尝试的完整日志一直留着;重要决策写进文件。

文件就是外部记忆

最可靠的长期记忆是工作区里的文件:PROJECT.md(目标、架构、目录)、NOTES.md(决策、踩坑、待办)、TASKS.md(清单与验收)、CHANGELOG.md(重要改动)。每次新会话,让它先读这几个文件,比反复口述高效。

规则文件

把编码规范、目录约定、禁止事项写成文件放在工作区,例如:

# 项目规则
- 不要修改 database/migrations 下的历史文件
- 所有接口必须有错误处理
- 不要引入新的第三方依赖,除非先说明理由
- 提交前必须跑 npm test

然后在新会话开头说:“先读 PROJECT.md 和 RULES.md,再开始。”

引用要精准

差的引用:“看一下这个项目的代码。”好的引用:

@src/services/order.ts
@src/services/order.test.ts
只分析 createOrder 的失败路径;不要看其他模块。

压缩后的恢复

上下文被压缩后,让它做状态重建:

请根据当前会话和 NOTES.md,复述:
1) 任务目标;
2) 已完成;
3) 未完成;
4) 关键约束;
5) 下一步建议。
不确定的地方标出来。

交接条模板

# 交接:<任务名>
## 目标
 
## 当前状态
- 已完成:
- 进行中:
- 未开始:
 
## 关键文件
- path:line — 作用
 
## 决策与原因
 
## 已知问题/风险
 
## 下一步
 
## 复现命令

本章练习

为项目写 PROJECT.md 和 RULES.md;开新会话,只靠这两个文件 + 一句任务,看它能否上手;故意给一堆无关文件,观察效果;写一份交接条。