渐进式披露

Progressive disclosure

只加载 Agent 当前需要的上下文,其余部分通过上下文指针指向。这个概念借自 UI 设计,原意是只展示与当前任务相关的控件,其余的藏在一层点击之后。

这项技术存在,是因为上下文会带来双重成本。预先加载的每个 Token 在每一轮都会按输入 Token 计费,而且每个 Token 都会占用注意力预算,无论 Agent 是否需要。一份塞满完整风格指南、部署手册和数据库规范的 Agent.md 会让 Agent 在所有这些方面都更差——对当前任务重要的指令被不需要的指令稀释了。明显的信号是:Agent 忽略了你明知就在上下文里的规则——它们在,但被埋住了。

渐进式披露把这种做法颠倒过来。让常驻加载层保持精简——每个主题一句话,再加上指向详情的上下文指针。Agent 写组件时读风格指南,部署时读部署手册,修测试时两者都不读。Skill 是 Harness 内置的模式:每次 Session 只加载简短描述,完整指令只在触发时才加载。

用法:

“我要不要把整个风格指南都丢进 Agent.md?”

“不要——用渐进式披露。把风格指南作为 Skill,Agent 真正需要写组件时再加载。Agent.md 里的内容每一轮都要付 Token 成本。”