渐进式披露是只加载智能体当前需要的上下文,其余内容通过上下文指针按需获取。这个概念借自 UI 设计,在那里指只向用户展示与当前任务相关的控件,把其余内容隐藏在一次点击之后。
这项技术存在,是因为上下文会产生双重成本。预先加载的每个 Token 都会在每个轮次按输入 Token 计费;无论智能体是否需要,每个 Token 都会消耗注意力预算。如果 AGENTS.md 塞满完整样式指南、部署手册和数据库约定,智能体对这几类内容的执行都会变差——当前任务真正需要的指令,会被不相关指令稀释。明显迹象是:智能体忽略了你明知位于上下文中的规则;它们确实在那里,只是被埋住了。
渐进式披露把做法反过来:让始终加载的层保持精简——每个主题只留一句说明,再加一个指向详细内容的指针。智能体编写组件时读取样式指南,部署时读取部署手册,修复测试时则两者都不加载。技能就是运行框架内置的这种模式:简短描述在每次会话中加载,完整指令只在触发时读取。
用法:
“应该把整份样式指南都放进 AGENTS.md 吗?”
“不要——使用渐进式披露。把样式指南做成技能,只在智能体真正需要编写组件时加载。AGENTS.md 中的内容每个轮次都要支付 Token 成本。”