第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;开新会话,只靠这两个文件 + 一句任务,看它能否上手;故意给一堆无关文件,观察效果;写一份交接条。
《DeepSeek Harness 实战课》课程目录
面向应用者的 DeepSeek Harness 实战课:讲清 API、Agent、Harness 三者关系,带你安装 DSH、写出可验收任务、让 Agent 读文件改代码跑测试、接 MCP/插件、做定时任务,并划清安全边界