SuperAPI AI 工具集

writing-for-agents

智能体与模型

查看项目

更新于 10-15 21:09

技能介绍

用途:为智能体所阅读的文档提供统一写作规则,适用于编写技能、AGENTS.md / CLAUDE.md,以及通过指针触达的文档。包装方式不同,但写作规则一致。若文档本身是技能,需阅读 SKILL-MECHANICS.md 了解前置元数据、调用方式与路由技能。

主要概念:上下文指针是智能体上下文中指向外部资料的引用,并编码触达条件,其措辞决定触达可靠性;指针需说明资料是什么并列出触发分支。两种负载:上下文负载(始终加载资料占用窗口的代价)与认知负载(人类记住有哪些文档及何时使用的代价)。信息层次按智能体即时需要程度排序:文件内步骤、文件内参考资料、披露型参考资料;渐进披露是沿梯子下移以保持顶层清晰,共置是把相关概念放在同一标题下,蔓延是文档过长的失败模式。

步骤与完成标准:每步以完成标准收尾,需具备清晰度(能否区分完成与未完成)与要求度(要求多少工作);最强标准既可检验又穷尽。拆分按顺序或按调用方式进行,仅在切分赚得到时拆。

引导词:使用模型预训练中已有的紧凑概念(如 lesson、fog of war、tracer bullets),以 token 反复使用来锚定行为;避免否定式提示,应正面陈述目标行为。

修剪:每种含义只保留单一权威来源,避免重复;环境本身也是权威来源,文档复述环境等于缓存,只缓存查找不到的内容;逐行检查相关性,逐句删除无操作指令。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息。