用途:为智能体消费的文档提供写作参考,包括技能(skill)、AGENTS.md / CLAUDE.md,以及通过指针触达的文档。包装形式不同,但写作方法一致,目标是让智能体每次运行都走同一流程,而非产出相同结果。若所写文档是技能,需阅读 SKILL-MECHANICS.md 了解 frontmatter、调用方式与路由技能。
主要能力:
- 上下文指针:指针措辞而非目标决定智能体何时触达材料。指针需说明材料是什么,并列出应触发触达的分支;每个分支一个触发词,前置关键词,删去正文已承载的身份信息。
- 两种负载:上下文负载(常驻上下文材料的成本)与认知负载(人类需记住有哪些文档及何时使用)。仅通过指针触达的材料可避开上下文负载,代价是指针本身那一行。
- 信息层级:文档由步骤与参考两类内容构成,按智能体需要的即时程度排列——文件内步骤、文件内参考、披露式参考(移入独立文件、由指针触达)。渐进式披露是把内容下移以保持顶层可读;分支是判断是否披露的最清晰标准。
- 步骤与完成标准:每个步骤以完成标准收尾,需清晰(能判断完成与否)且有要求强度(如“每个修改过的模型都已说明”)。最强标准既可核查又穷尽。
- 拆分时机:按序列拆分,把后续步骤移出视野以促使智能体在当前任务上多下功夫;按调用拆分属技能专属,见 SKILL-MECHANICS.md。
- 引导词:使用模型预训练中已有的紧凑概念(如 lesson、fog of war、tracer bullets),以单个 token 反复出现来锚定行为;自造词需额外定义成本,优先用已有词。避免用否定式表述,应正面陈述目标行为。
- 精简:每个含义保持单一权威来源,避免重复;环境本身也是事实来源,文档不应复述可查内容;逐句检查相关性,删除无操作(no-op)句子。
使用方式:作为写作参考阅读,按上述原则撰写或修改智能体文档。
适用场景:创建或编辑技能、AGENTS.md、CLAUDE.md,或任何由指针触达的智能体文档。
限制:资料未提供具体安装命令、代码示例、收费或平台信息;部分细节(如 SKILL-MECHANICS.md 内容)需另行查阅。