添加技能支持

Mon, 01 Jan 0001 00:00:00 +0000

如何为你的智能体添加技能支持#

为 AI 智能体或开发工具添加 Agent Skills 支持的指南。

本指南将深入探讨如何为 AI 智能体或开发工具添加 Agent Skills（智能体技能）支持。它涵盖了技能的完整生命周期：发现技能、告知模型相关技能、将内容加载到上下文中，以及确保这些内容在长时间会话中持续有效。

无论你的智能体架构如何，核心集成逻辑都是一致的。具体的实现细节会根据以下两个因素而有所不同：

技能存储在哪里？ 本地运行的智能体可以扫描用户文件系统的技能目录。而云端托管或沙箱化的智能体则需要替代的发现机制——例如 API、远程注册中心或捆绑的静态资产。
模型如何访问技能内容？ 如果模型具备文件读取能力，它可以直接读取 SKILL.md 文件。否则，你需要提供专用的工具，或者通过编程方式将技能内容注入提示词。

本指南在这些差异产生影响的地方进行了说明。你不需要支持所有场景——只需遵循适合你智能体需求的路径即可。

前提条件：熟悉 Agent Skills 规范，该规范定义了 SKILL.md 的文件格式、Frontmatter 字段和目录约定。

每一个兼容技能的智能体都遵循相同的“三层加载”策略：

层级	加载内容	何时加载	Token 消耗
1. 目录	技能名称 + 描述	会话开始时	每个技能约 50-100 tokens
2. 指令	`SKILL.md` 的完整正文	技能被激活时	推荐 < 5000 tokens
3. 资源	脚本、引用、资产	当指令中显式引用它们时	视具体资源而定

模型从一开始就能看到目录，因此它知道有哪些可用技能。当模型判断某个技能相关时，它会加载完整的指令。如果这些指令中引用了辅助文件，模型会根据需要单独加载它们。

这种策略能保持基础上下文精简，同时让模型可以按需获取专业知识。即使一个智能体安装了 20 个技能，它也不需要预先承担 20 套完整指令的 Token 成本——只需为给定对话中实际用到的技能付费。

在会话启动时，寻找所有可用技能并加载其元数据。

扫描哪些目录取决于智能体的环境。大多数本地运行的智能体至少会扫描两个范围：