用途:agent-speak 是撰写任何供智能体消费的文档的参考,包括技能(skill)、AGENTS.md / CLAUDE.md,以及通过指针到达的文档。其核心观点是:包装形式不同,但写作方法一致,因为智能体每次运行走的是同一套过程,而非产出相同结果。若所写文档是技能,需阅读 SKILL-MECHANICS.md 了解 frontmatter、调用方式选择与路由技能。
主要能力:讲解上下文指针(context pointer)——保存在智能体上下文中、指向外部材料并编码触发条件的引用;指针的措辞而非目标决定智能体何时、多可靠地到达材料。区分两种负载:上下文负载(常驻材料对窗口的占用)与认知负载(人类需记住哪些文档存在及何时使用)。提出信息层级:文件内步骤、文件内参考、披露式参考,并用渐进式披露与共置(co-location)保护层级。还涵盖步骤的完成标准(清晰度与要求强度)、何时按序列或调用方式拆分文档、引导词(leading words)的用法与否定式失败模式,以及修剪原则(单一事实来源、环境即事实来源、逐句排查无效指令)。
使用方式与限制:资料未提供具体安装命令、代码示例或操作步骤,仅给出写作原则与概念框架。分类依据其面向智能体文档写作的明确用途,归入写作与研究。