SuperAPI AI 工具集

writing-for-agents

智能体与模型

查看项目

更新于 10-16 18:01

技能介绍

用途:为智能体撰写其会消费的文档提供参考,包括技能(skill)、AGENTS.md / CLAUDE.md,以及通过指针到达的文档。核心观点是:打包形式不同,但写作方法一致,因为智能体每次运行走的是同一套过程,而非产出相同结果。若所写文档是技能,需阅读 SKILL-MECHANICS.md 了解 frontmatter、调用方式与路由技能。

主要能力:

  1. 上下文指针:指针的措辞而非目标决定智能体何时、多可靠地到达材料;指针需说明材料是什么,并列出应触发到达的分支,每个分支一个触发词,前置引导词,删去正文已承载的身份信息。
  2. 两种负载:上下文负载(常驻上下文材料的成本)与认知负载(人类需记住有哪些文档、何时使用)。
  3. 信息层级:文件内步骤、文件内参考、披露式参考三级;渐进披露是把材料下移以保护层级,共置是文件内相邻组织,蔓延是文档过长的失败模式。
  4. 步骤与完成标准:标准需清晰(避免过早完成)且有要求(驱动深入工作);最强标准既可检查又穷尽。
  5. 拆分时机:按序列拆分,避免后续步骤诱使智能体草率完成当前步骤;按调用拆分见 SKILL-MECHANICS.md。
  6. 引导词:借用预训练中已有的紧凑概念,作为 token 重复以锚定行为;否定式表述会把被禁行为拉入上下文,应正面表述目标行为。
  7. 精简:单一事实来源、避免重复、环境本身也是事实来源、检查相关性、逐句排查无效指令。

使用方式:作为写作参考阅读,按上述杠杆撰写或修改智能体文档。

适用场景:创建或编辑技能、AGENTS.md、CLAUDE.md 等智能体消费文档时。

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