Skip to content
LangSmith 文档版本 跟随上游 源快照 1c7b9fed 更新于 2026-10-18

技能

使用 skills 为你的 agent 提供对特定能力的访问。

Skills 是可复用的能力,它们为你的 agent 提供专门的流程和工作区知识。每个 skill 都存储在 agent 的长期记忆中,位于 memories/skills/<skill-name>。skill 的名称和描述会在 agent 启动时加载。基于这些信息,agent 可以决定是否使用该 skill。只有当 agent 判断它与当前任务相关时,才会加载完整的 skill 文件。所引用的任何额外资源如果变得相关,也可能被 agent 加载。

使用 skills 可以有助于:

  • 通过只提供与当前任务相关的上下文来节省 token 用量。
  • 防止 agent 在系统提示中携带过多上下文,那会导致幻觉和不正确的响应。

INFO

Fleet skills 构建于 Deep Agents 之上,并遵循 Agent Skills 规范。有关 skill 结构、SKILL.md 格式和编写最佳实践的详情,参阅 Deep Agents skills 文档。

私有与共享 skill

Skills 可以对单个 agent 私有,也可以在某个工作区内共享:

  • Private skills:对其所属的 agent 私有,并存储在 agent 的长期记忆中。
  • Shared skills:与工作区共享,并在 Skills 页面上列出。
    • 对工作区中的所有 agent 可见。
    • 只有创建该 skill 的用户可以编辑或删除它。
    • 可以被添加到工作区中的任何 agent,并随 skill 更新而保持同步。
    • 被通用聊天自动访问。

编写有效的 skill 描述

将描述写作为何时使用该 skill 的指令,而不是写作为它做什么的标签。agent 仅根据描述来路由任务。它只有在决定使用之后才读取完整的 skill 文件。

例如,不要写 "Helps with email,",而要写:"Use when drafting, replying to, or summarizing emails. Covers tone adjustments, follow-up scheduling, and inbox triage."。

过于宽泛的描述意味着即使该 skill 能正确处理任务,agent 也可能不使用它。与另一个 skill 重叠的描述意味着 agent 可能路由到错误的那个或无法选择。随着你的 skill 库增长,请审查描述是否有重叠,并收窄任何含糊的描述。

创建一个 skill

你可以以两种方式创建 skill:

  • With AI:使用自然语言描述该 skill,agent 会为你创建它。你也可以添加额外的资源。任何额外的文件都必须在 SKILL.md 中被引用,agent 才能感知到它们。
  • Manually:使用一个 SKILL.md 文件创建 skill。

NOTE

默认情况下,skills 对其所属的 agent 私有,并存储在 agent 的长期记忆中。你可以与工作区共享一个 skill。

在 Fleet中,选择一个 agent 并提示它创建一个 skill:

Create a skill that helps the agent use the web to research a topic. Use when asked to research a topic, person, company, technology, event, or any question that requires gathering and synthesizing information from the web. Covers news lookups, competitive analysis, background research, and fact-finding tasks. Prefer tavily_web_search for most queries.

你也可以随时将之前的对话转化为一个可复用的 skill。在完成一项任务后,请 agent 捕获该流程:

Turn what we just did into a skill so you can repeat it in the future.

TIP

当你创建一个新 agent 时,如果 agent 会从中受益,Fleet 会自动生成相关的 skills。这些 skill 默认是私有的。你可以从 agent 侧边栏将它们共享到你的工作区。

修复反复出现的错误

对 agent 错误的默认反应是当场纠正它。skill 改变了这一点:它为 agent 提供了在每次遇到那类任务时都要遵循的明确规则,因此同样的错误不会再发生。

当 agent 处理某项任务不正确时,纠正它,然后请它捕获这个修复:

将这个纠正转化为一个 skill,以便你始终以这种方式处理它。

agent 会创建一个编码了正确行为的 SKILL.md。在后续的会话中,它在处理该任务之前会先读取该 skill,而不是从头推理。

编辑一个私有 skill

  1. 在 Fleet中选择一个 agent。
  2. 在侧边栏中,展开 Knowledge 抽屉。
  3. 在 Skills 部分,选择要编辑的 skill。
  4. 更新 skill 的名称、描述或指令。

编辑一个共享 skill

NOTE

只有创建共享 skill 的用户才能编辑它。

  1. 导航到 Fleet > Skills。
  2. 选择要编辑的 skill。
  3. 更新 skill 的名称、描述或指令。
  4. 点击 Save Changes。

共享一个 skill

  1. 在 Fleet中选择一个 agent。
  2. 在侧边栏中,展开 Knowledge 抽屉。
  3. 在 Skills 部分,选择要共享的 skill。
  4. 点击

Share。

一旦共享,该 skill 就会出现在 Skills 页面上。你可以从 agent 侧边栏将共享的 skills 添加到工作区中的任何 agent,而通用聊天会自动识别它们。

NOTE

只有共享 skill 的创建者才能编辑或删除它。

删除一个私有 skill

删除一个私有 skill 会将其永久移除,因为它存储在该 agent 的记忆中。

  1. 在 Fleet中选择该 agent。
  2. 在侧边栏中,展开 Knowledge 抽屉。
  3. 在 Skills 部分,点击

图标(对应要删除的 skill)。

删除一个共享 skill

只有创建共享 skill 的用户才能删除它。

WARNING

删除一个 skill 会将其从工作区以及所有使用它的 agent 中移除。此操作无法撤销。

  1. 导航到 Fleet > Skills。
  2. 选择要删除的 skill。
  3. 点击

Delete skill 图标。

在本地开发中使用 Fleet skills

使用 LangSmith CLI 从你的 Fleet 工作区下载 skills,并将它们安装到本地,供 Claude Code、Cursor 或 Codex 等编码 agent 使用。

默认情况下,文件会保存到 ~/.agents/skills/[skill-name]/,并软链接到 ~/.claude/skills/[skill-name]/。

bash
langsmith fleet skills pull [skill-name] [flags]
标志描述
--global=false安装到项目级目录(.agents/ 和 .claude/)而非主目录。
--agent定位一个特定的 agent(claude、cursor、codex)。
--copy复制文件而非软链接。
--format pretty显示所安装 skill 的文件树。

例如:

bash
$ 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

BytesRouter 是社区翻译站点,所有译文仅供参考,一切以官方英文原文为准。