SuperAPI AI 工具集

writing-for-agents

智能体与模型

查看项目

更新于 10-16 03:39

技能介绍

用途:为智能体消费的文档提供写作参考,包括 skill、AGENTS.md/CLAUDE.md,以及通过指针到达的文档。不同文档的打包方式不同,但写作手法一致,目标是让智能体每次都采用同一流程,而非产出同一结果。若所写文档是 skill,资料建议阅读 SKILL-MECHANICS.md 了解 frontmatter、调用方式与路由技能。

主要能力:围绕上下文指针、两类负载、信息层级、步骤与完成标准、拆分时机、引导词与修剪等概念给出方法。上下文指针是智能体上下文中指向上下文外材料的引用,并编码到达条件;措辞而非目标决定何时以及多可靠地到达。指针需前置引导词、每个分支一个触发条件、避免同义重复、删除正文已承载的身份信息。两类负载为上下文负载(常驻材料的 token 与注意力成本)与认知负载(人记住有哪些文档及何时使用的成本)。信息层级按智能体需要的即时性排列:文件内步骤、文件内参考、经指针披露的参考。渐进式披露是把材料下移到指针之后,以保持顶层可读,分支是判断披露的最清晰测试。

使用方式:编写时把每个概念的定义、规则与注意事项放在同一标题下,避免散落;每一步给出明确的完成标准,标准要可检查且穷尽;按需拆分文档,按序列拆分可避免后续步骤诱使智能体草率完成当前步骤;用模型预训练中已有的紧凑词作引导词,重复该词而非整句;以正面表述替代禁令,禁令仅作为无法正面表达的硬性护栏并配合正面目标;保持单一事实来源,避免重复,环境本身(如 package.json 脚本、配置文件、目录结构、--help 输出)也是事实来源,只缓存智能体无法通过查看获得的信息;逐句检查相关性并删除无操作句。

适用场景:编写或修改 skill、AGENTS.md、CLAUDE.md 及其他供智能体读取的文档时。

限制:资料未提供具体安装命令、价格、平台支持或效果数据。