SuperAPI AI 工具集

writing-for-agents

智能体与模型

查看项目

更新于 10-16 08:10

技能介绍

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

主要能力:一是上下文指针,指针措辞而非目标决定智能体何时、多可靠地到达材料;指针需说明材料是什么并列出触发分支,常驻指针要前置关键词、每个分支一个触发词、删去正文已含的身份信息。二是两类负载:上下文负载(常驻材料消耗 token 与注意力)与认知负载(人作为索引的成本)。三是信息层级:文件内步骤、文件内参考、披露式参考,渐进披露用于保护顶层可读性,按分支判断内联还是外推;同处一地让概念的定义、规则与注意事项相邻;过长文档是失败模式。四是步骤与完成标准:标准要清晰且要求高,模糊边界会诱发提前完成,必要时按序列拆分。五是拆分时机:按序列或按调用拆分。六是引导词:用预训练中已有的紧凑概念锚定行为,避免否定式表述,优先正面陈述目标行为。七是精简:单一事实来源、环境本身也是事实来源、逐句排查无操作句。

使用方式:作为写作时的参考文档阅读,按上述杠杆检查与修改文档。

适用场景:编写或编辑 skill、AGENTS.md、CLAUDE.md 及其他智能体文档。

限制:资料未提供具体安装命令、平台支持、收费或价格信息;部分细节(如 SKILL-MECHANICS.md 内容)需另行查阅。