用途:为智能体编写其会消费的任何文档——技能、AGENTS.md / CLAUDE.md、以及通过指针触达的文档。资料指出,封装形式不同,但写作方式相同,同一套杠杆让每份文档可预期,因为智能体每次运行走的是同一过程,而不是产出相同结果。若所写文档是技能,需阅读 SKILL-MECHANICS.md 了解 frontmatter、调用方式选择与路由技能。
主要概念:上下文指针(context pointer)是智能体上下文中指向外部材料的引用,并编码触达条件;技能描述是一条指针,AGENTS.md 中指向某文档的一行同理。指针的措辞而非目标决定何时以及多可靠地触达材料。指针承担两件事:说明材料是什么,并列出应触发触达的分支。始终加载的指针每个词每轮都要付费,因此比正文更需精简:前置首词、每个分支一个触发器、合并同义重命名、删除正文已承载的身份信息。
两种负载:上下文负载是始终加载材料占用窗口的成本;认知负载是人类成本,即有哪些文档、何时取用,人类就是索引。仅通过指针触达的材料以指针自身一行为代价避开上下文负载;无指针材料完全靠认知负载。
信息层级:文档由步骤(按序动作)与参考(按需查阅的定义、规则、事实)构成。层级按智能体多急需排序:文件内步骤为首要层;文件内参考按需查阅;披露式参考推入独立文件、经指针加载。推得太少顶部臃肿,推得太多隐藏所需材料。渐进披露是把材料下移出主文件并置于指针后,以保护层级;分支是最清晰的披露检验:每个分支都需要的内联,只有部分分支需要的推入指针后。共置是文件内配套:定义、规则、注意事项同处一个标题下。蔓延是失败模式:文档过长,即使每行都有效,注意力也会稀释。
步骤与完成标准:每个步骤以完成标准结束,即告知智能体工作完成的条件。清晰度决定能否分辨完成与否;模糊边界会诱发提前完成。需求强度决定工作深度。最强标准既可核查又穷尽。
何时拆分:按序列拆分,把完成后步骤移出视野以驱动当前任务更多苦工;合并序列会暴露后续步骤、诱发提前完成。按调用拆分属技能专有,见 SKILL-MECHANICS.md。
引导词:引导词是模型中预训练已有的紧凑概念,智能体借其思考(如 lesson、fog of war、tracer bullets)。作为词元重复、绝不作为句子重复,它累积分布式定义并以最少词元锚定一片行为区域。它锚定两次:正文中锚定执行,指针中锚定调用。否定是此杠杆旁的失败模式:以禁止来引导会把禁止行为拖入上下文,使其更可得,应正面提示目标行为。
修剪:每个含义保留单一权威来源;环境也是事实来源,复述环境的文档是缓存,仅当查阅昂贵时才值得。逐句检查相关性,逐句猎捕无效指令(模型默认已遵守的指令);该检验是模型相对的,靠运行文档而非辩论解决;句子失效时删整句而非修剪措辞。
限制:资料未提供该技能的安装命令、版本、收费、平台或效果信息。