用途:为智能体消费的文档提供写作参考,包括技能(skill)、AGENTS.md,以及通过上下文指针触达的文档。不同载体的打包方式不同,但写作原则一致:目标是让每次运行的过程可预测,而非输出完全相同。
主要能力:
- 上下文指针:指针是智能体上下文中指向外部材料的引用,并编码触达条件。技能描述、AGENTS.md 中命名文档的一行都属于指针。指针措辞决定触达时机与可靠性;关键材料若指针措辞太弱,应先强化措辞,失败再内联。指针需说明材料是什么,并列出应触发触达的分支;每个分支一个触发词,合并同义重复,前置关键词。
- 两种负载:上下文负载是常驻材料对窗口的消耗;认知负载是人类需记住有哪些文档、何时使用。仅靠指针触达的材料可避开上下文负载,代价是指针本身那一行。
- 信息层级:文件内步骤(主要层级)、文件内参考(按需查阅)、披露式参考(拆到单独文件,由指针触达)。渐进式披露把条件性参考移出主文件;共置让概念的定义、规则与例外在同一标题下;蔓延指文档过长难以使用,应按分支或序列拆分。
- 步骤与完成标准:每步需有完成标准,检查清晰性(能否判断完成)与要求强度(覆盖范围是否足够)。最强标准既可核查又穷尽。
- 何时拆分:按序列拆分(观察到运行跳过必要工作且完成标准清晰时);按调用拆分见 skill-mechanics.md。
- 引导词:用熟悉的词让智能体在运行中思考,定义一次后重复该词而非定义;优先用已有词。同一想法多处出现时,定义一次并用引导词回指。
- 否定表述:说明期望行为而非仅禁止,硬性护栏需明确禁止并配以允许动作。
- 精简:保持单一事实来源;环境本身也是事实来源,文档复述环境等于缓存,只缓存智能体查不到的内容。逐行检查相关性,删除前核实是否过时。无操作指令指不改变模型行为的指令,编辑审查时需区分疑似无操作与经对比运行证实的无操作。
使用方式:创建或编辑技能及其描述前,先阅读 Anthropic 的技能编写最佳实践以获取当前编写与 frontmatter 指导,并阅读 skill-mechanics.md 了解本集合的调用约定、拆分与路由技能。若无法访问官方页面,应报告该限制,而非声称已核查其当前要求。当用户要求技能评估或对技能指令做行为对比以解决争议性无操作时,调用 Skill 工具并传入 "skill-creator",使用其评估工作流。若缺失,给出安装命令 npx skills@latest add anthropics/skills --skill=skill-creator,并询问是安装还是暂缓对比。普通编辑不需要评估;若推迟评估,应报告该变更为编辑判断,而非已证实的行为改进。
适用场景:编写或修改技能、AGENTS.md,以及任何由指针触达的智能体文档。
限制:资料未提供具体平台、收费、价格或效果信息;官方页面若不可访问需如实报告。