---
title: "上下文管理"
date: "2026-04"
category: "ai运用"
tags: ["ai运用"]
description: "通过渐进披露的模式把入口文档作为目录，然后不断建立分层索引的模式来进行逐渐的展现。就像OpenAI这篇文章说的一样，AGENTS.md/CLAUDE.md应该是一份地图，而不是全面的手册..."
source: "https://enriquemark.com/zh-hans/posts/%E4%B8%8A%E4%B8%8B%E6%96%87%E7%AE%A1%E7%90%86"
---

通过渐进披露的模式把入口文档作为目录，然后不断建立分层索引的模式来进行逐渐的展现。就像[OpenAI](https://openai.com/zh-Hans-CN/index/harness-engineering/)这篇文章说的一样，AGENTS.md/CLAUDE.md应该是一份地图，而不是全面的手册。这不只是上下文窗口的问题，关键点在于注意力——过长的上下文只会导致腐化，注意力涣散，最终反而不如精细的上下文来的有效。

---
我们尝试了「一个大型的 [`AGENTS.md`⁠（在新窗口中打开）](https://agents.md/)」方法。可想而知，这是一次失败的尝试：
- **情境是一种稀缺资源。** 一个巨大的指令文件会挤掉任务、代码和相关文档 — 因此智能体要么会错过关键约束条件，要么开始针对错误的约束条件进行优化。
- **过多的指导反而变得无效。** 当一切都 「重要」时，一切都不重要了。智能体最终会在本地进行模式匹配，而不是有意识地进行导航。
- **它会立即腐烂。** 一本庞杂的手册会变成陈旧规则的坟场。智能体无法判断哪些信息仍然有效，一旦人类停止维护它，此文件就会悄然成为一个颇具吸引力的麻烦源头。
- **这很难核实。** 单个 blob 不适合进行机械检查（覆盖率、新鲜度、所有权、交叉链接），因此漂移是不可避免的。
---
说来挺搞笑，但确实应了那句话：全部都有等于全部都没有。建立一个便携的 docs/ 才是最正确的办法，这就像SKLIIS.md的约束一样——入口不要超过五百行，甚至可以更短。