OpenAI 在构建 CodeX 时，关于怎么做 Agent.md 有点意思。
刚开始团队是想把这个 markdown 文件做成一个巨大的操作手册，听起来很有道理对不对？
但是上下文会爆。
- 上下文是稀缺资源，过多的指令会让智能体表现欠佳
- 过度的指引就是没有指引。所有东西都重要，就是所有东西都不重要。
- 它腐烂了，智能体迷茫，人类也懒得维护
- 无法验证
这时候「渐进式披露」是更好的做事方式，把 Agent.md 做成目录索引，而不是百科全书。把百科全书拆到其他文档中，这和目前大火的 skills 在理念上是一致的。
这也很符合常识，智能体不是一上来就被一个大文档淹没，而是根据当下需求，不断找到自己最需要的文档，把重要且关键的信息送给模型。
链接：openai.com/index/harness-engineering