以编程方式使用文档

技能是可重用的能力,为您的智能体提供专业化的工作流程和领域知识。每个技能都存储在智能体的长期记忆中 memories/skills/<skill-name>。技能名称和描述在智能体启动时加载。基于这些信息,智能体可以决定是否使用该技能。只有当智能体确定其与当前任务相关时,才会加载完整的技能文件。智能体可以在相关时加载任何被引用的附加资源。

使用技能可以带来以下帮助:

  • - 通过仅提供与当前任务相关的上下文来节省令牌使用。
  • - 防止智能体在系统提示词中包含过多上下文,这可能导致幻觉和错误响应。

私有技能与共享技能

技能可以是 **私有** 的(仅属于单个智能体)或 **共享** 的(跨工作区):

  • 私有技能:属于其所属智能体私有,存储在智能体的长期记忆中。
  • 共享技能:在工作区中共享,并列在 **技能** page.
  • - 页面上。工作区中的所有智能体均可见。
  • - 只有创建该技能的用户可以编辑或删除它。
  • - 可以添加到工作区中的任何智能体,并在技能更新时保持同步。
  • - 通用聊天会自动访问。

编写有效的技能描述

将描述写为关于何时使用该技能的说明,而不是对其功能的标签。智能体仅根据描述来路由任务。只有在决定使用该技能后,才会读取完整的技能文件。

例如,不要写"帮助处理电子邮件",而是写:"在起草、回复或总结电子邮件时使用。涵盖语气调整、后续安排和收件箱分类。"

描述过于宽泛意味着智能体可能不会使用该技能,即使它能正确处理任务。描述与另一个技能重叠意味着智能体可能会路由到错误的技能或无法做出选择。随着技能库的扩大,请检查描述是否有重叠,并缩小任何模糊的描述。

创建技能

您可以通过两种方式创建技能:

  • 使用 AI:使用自然语言描述技能,智能体将为您创建。您也可以添加附加资源。任何附加文件必须在 SKILL.md 中引用,智能体才能感知它们。
  • 手动创建:使用 SKILL.md file.

With AI

In Fleet,选择一个代理并提示它创建技能:

创建一个帮助代理使用网络研究主题的技能。在被要求研究主题、人物、公司、技术、事件或任何需要从网络收集和综合信息的任务时使用。涵盖新闻查询、竞品分析、背景研究和事实查证任务。优先使用 tavily_web_search 用于大多数查询。

您也可以随时将之前的对话转换为可重用的技能。完成任务后,请让代理捕获工作流程:

将我们刚才做的转换为一个技能,以便您将来可以重复执行。

From a template

  1. 导航到 **Fleet > 技能**.
  2. 浏览可用模板并选择一个添加到您的代理。

Manually

  1. Fleet.
  2. 中选择一个代理 **编辑代理**.
  3. 在 **技能** 部分,点击 **创建**.
  4. 输入技能名称、描述和说明。
  5. 点击 **保存更改**.

修复反复出现的错误

对代理错误的默认响应是当场纠正。技能改变了这一点:它为代理提供了明确的规则,使其在每次遇到该类任务时都遵循,从而避免同样的错误再次发生。

当代理错误处理任务时,请当场纠正,然后让它捕获修复方法:

将这个修正转换为一个技能,以便您始终以这种方式处理。

代理会创建一个 SKILL.md 来编码正确的行为。在未来的会话中,它会在处理该任务前读取技能,而不是从头推理。

编辑私有技能

  1. Fleet.
  2. 中选择一个代理 **编辑代理**.
  3. 在 **技能** 部分,选择要编辑的技能。
  4. 更新技能名称、描述或说明。
  5. 点击 **保存更改**.

编辑共享技能

  1. 导航到 **Fleet > 技能**.
  2. 选择要编辑的技能。
  3. 更新技能名称、描述或说明。
  4. 点击 **保存更改**.

共享技能

  1. 在以下位置选择一个代理 Fleet.
  2. 点击 **编辑代理**.
  3. 在 **技能** 图形视图的部分中,选择要共享的技能。
  4. 点击 **共享**.

共享后,该技能将显示在 **技能** 页面上。您可以从代理编辑器将共享技能添加到工作区中的任何代理,通用聊天会自动获取它们。

删除私有技能

删除私有技能会将其永久移除,因为它存储在该代理的内存中。

  1. 在以下位置选择代理 Fleet.
  2. 点击 **编辑代理**.
  3. 在 **技能** 部分中,点击 图标以删除技能。

删除共享技能

只有共享技能的创建者才能删除它。

  1. 导航至 **Fleet > 技能**.
  2. 选择要删除的技能。
  3. 点击 **删除技能** icon.

在本地开发中使用 Fleet 技能

使用 LangSmith CLI 从您的 Fleet 工作区下载技能,并将其本地安装以用于 Claude Code、Cursor 或 Codex 等编码代理。

默认情况下,文件保存至 ~/.agents/skills/[skill-name]/ 并符号链接至 ~/.claude/skills/[skill-name]/.

langsmith fleet skills pull [skill-name] [flags]
标志描述
--global=false安装到项目级目录(.agents/.claude/)而不是主目录。
--agent定位特定代理(claude, cursor, codex).
--copy复制文件而不是符号链接。
--format pretty显示已安装技能的文件树。

例如:

$ langsmith fleet skills pull web-research --format pretty
Installed skill "web-research" to ~/.agents/skills/web-research
  Linked: ~/.claude/skills/web-research

web-research/
├── SKILL.md
└── references/
    └── search-tips.md