SuperAPI AI 工具集

writing-for-agents

智能体与模型

查看项目

更新于 10-16 00:21

技能介绍

用途:为智能体编写其会消费的文档,包括 skill、AGENTS.md / CLAUDE.md,以及通过指针触达的文档。打包形式不同,但写作方法一致:让每次运行过程可预测,而非产出相同结果。若写的是 skill,需阅读 SKILL-MECHANICS.md 了解 frontmatter、调用方式与路由技能。

主要能力:

  1. 上下文指针:指针措辞而非目标决定智能体何时、多可靠地触达材料。指针需说明材料是什么,并列出应触发触达的分支;每个分支一个触发词,前置关键词,删去正文已承载的身份信息。
  2. 两种负载:上下文负载是常驻上下文材料的成本;认知负载是人的成本,人是索引。仅靠指针触达的材料可避开上下文负载,代价是指针自身那一行。
  3. 信息层级:文件内步骤、文件内参考、披露式参考(经指针推入独立文件)。渐进式披露是把材料下移以保护顶层可读性;分支是最清晰的披露判据。同处一地把概念的定义、规则与注意事项放在同一标题下。
  4. 步骤与完成标准:每步以完成标准收尾,需清晰(能否区分完成与未完成)且有要求强度(如“每个修改过的模型都已交代”)。最强标准既可核查又穷尽。
  5. 拆分时机:按序列拆分,避免后续步骤诱使智能体赶工当前步骤;按调用拆分见 SKILL-MECHANICS.md。
  6. 引导词:用预训练中已有的紧凑概念作为词元反复出现,锚定行为;优先用已有词,自造词需额外定义成本。避免用否定式引导,应正面陈述目标行为。
  7. 剪枝:每个含义单一事实来源;环境本身也是事实来源,文档复述环境即缓存,仅在查找昂贵时才值得。逐句排查无效指令,无效则整句删除。

使用方式:作为写作参考,在创建或编辑上述文档时对照使用。

适用场景:编写 skill、AGENTS.md、CLAUDE.md 及被指针引用的文档。

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