Context Rot

定义

上下文腐烂/过度探索陷阱：Agent 因被 prompt/AGENTS.md 引发的探索行为吸引，打开过多无关文档把上下文塞满，最终输出反而变差。本质是 上下文污染 的一种特定子类——由文档结构本身触发，而不是子任务残留。

要点

• 两种触发方式：
  • 架构总览写太多 → Agent 想"更好理解架构"，打开几十个文档塞入几十万 token
  • "别做"清单太长（30–50 条无替代方案）→ Agent 逐条检查方案是否违反每条规定，去翻迁移脚本、API 兼容性、认证中间件等不相关代码
• 关键洞察：你写的每一行都在争夺 Agent 有限的注意力
• AGENTS.md 越面面俱到，Agent 越倾向把它当检查清单全部过一遍
• 与 Chroma 研究的"上下文腐烂"、斯坦福"Lost in the Middle" 是同一现象的不同切面

缓解策略

• 入口文件 100–150 行
• 用 禁止+替代配对 替代纯禁止
• 用决策表替代描述性架构总览
• 短代码片段（3–10 行）替代长文字说明
• 引用控制在 10–15 个以内

相关概念

• 上下文污染
• 上下文压缩
• 渐进式披露
• AGENTS

参考资料

• AGENTS.md 写作六规律〔待补〕