> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 技能

> 使用技能为您的代理提供特定功能的访问权限。

技能是可复用的能力，为您的代理提供专门的工作流程和领域知识。每个技能都存储在代理的长期记忆中，路径为 `memories/skills/<skill-name>`。代理启动时会加载技能的名称和描述。基于此信息，代理可以决定是否使用该技能。只有在代理确定技能与当前任务相关时，才会加载完整的技能文件。如果任何引用的附加资源变得相关，代理可能会加载它们。

使用技能有助于：

* 仅提供与当前任务相关的上下文，从而节省令牌使用量。
* 防止代理在系统提示中拥有过多上下文，这可能导致幻觉和错误响应。

<Info>
  Fleet 技能基于 [Deep Agents](/oss/python/deepagents/skills) 构建，并遵循 [代理技能规范](https://agentskills.io/specification)。有关技能结构、`SKILL.md` 格式和编写最佳实践的详细信息，请参阅 [Deep Agents 技能文档](/oss/python/deepagents/skills)。
</Info>

## 私有技能与共享技能

技能可以是单个代理的**私有**技能，也可以在工作区中**共享**：

* **私有技能**：仅对其所属的代理私有，并存储在该代理的长期记忆中。
* **共享技能**：与工作区共享，并列在 [**技能**](https://smith.langchain.com/agents/skills) 页面上。
  * 对工作区中的所有代理可见。
  * 只有创建该技能的用户才能编辑或删除它。
  * 可以添加到工作区中的任何代理，并在技能更新时保持同步。
  * 通用聊天会自动访问共享技能。

## 编写有效的技能描述

将描述编写为何时使用技能的说明，而不是其功能的标签。代理仅根据描述来路由任务。只有在决定使用技能后，它才会读取完整的技能文件。

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

过于宽泛的描述意味着即使技能能够正确处理任务，代理也可能不会使用它。与其他技能重叠的描述意味着代理可能会路由到错误的技能或无法做出选择。随着技能库的增长，请检查描述是否存在重叠，并缩小任何模糊的描述。

## 创建技能

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

* **使用 AI**：使用自然语言描述技能，代理将为您创建它。您还可以添加附加资源。任何附加文件必须在 `SKILL.md` 中引用，代理才能感知到它们。
* **手动创建**：使用 `SKILL.md` 文件创建技能。

<Note>
  默认情况下，技能对其所属的代理是**私有**的，并存储在该代理的长期记忆中。您可以[将技能共享到工作区](#share-a-skill)。
</Note>

<Tabs>
  <Tab title="使用 AI">
    在 [Fleet](https://smith.langchain.com/agents) 中，选择一个代理并提示它创建技能：

    <Prompt description="创建一个帮助代理使用网络研究主题的技能。">
      创建一个帮助代理使用网络研究主题的技能。当被要求研究主题、人物、公司、技术、事件或任何需要从网络收集和综合信息的问题时使用。涵盖新闻查询、竞争分析、背景研究和事实查找任务。对于大多数查询，优先使用 `tavily_web_search`。
    </Prompt>

    您也可以随时将之前的对话转换为可复用的技能。完成任务后，要求代理捕获工作流程：

    <Prompt description="将此对话转换为可复用的技能。">
      将我们刚才所做的转换为一个技能，以便您将来可以重复使用。
    </Prompt>
  </Tab>

  <Tab title="从模板创建">
    1. 导航到 [**Fleet > 技能**](https://smith.langchain.com/agents/skills)。
    2. 浏览可用模板并选择一个添加到您的代理。
  </Tab>

  <Tab title="手动创建">
    1. 在 [Fleet](https://smith.langchain.com/agents) 中选择一个代理。
    2. 点击 <Icon icon="pencil" /> **编辑代理**。
    3. 在 **技能** 部分，点击 **创建**。
    4. 输入技能名称、描述和说明。
    5. 点击 **保存更改**。
  </Tab>
</Tabs>

<Tip>
  当您创建新代理时，如果代理能从中受益，Fleet 会自动生成相关技能。这些技能默认是私有的。您可以从代理编辑器中[将它们共享到您的工作区](#share-a-skill)。
</Tip>

## 修复重复性错误

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

当代理错误处理任务时，纠正它，然后要求它捕获修复方法：

<Prompt description="将此修复捕获为技能。">
  将此修正转换为一个技能，以便您始终以这种方式处理它。
</Prompt>

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

## 编辑私有技能

1. 在 [Fleet](https://smith.langchain.com/agents) 中选择一个代理。
2. 点击 <Icon icon="pencil" /> **编辑代理**。
3. 在 **技能** 部分，选择要编辑的技能。
4. 更新技能名称、描述或说明。
5. 点击 **保存更改**。

## 编辑共享技能

<Note>
  只有创建共享技能的用户才能编辑它。
</Note>

1. 导航到 [**Fleet > 技能**](https://smith.langchain.com/agents/skills)。
2. 选择要编辑的技能。
3. 更新技能名称、描述或说明。
4. 点击 **保存更改**。

## 共享技能

1. 在 [Fleet](https://smith.langchain.com/agents) 中选择一个代理。
2. 点击 <Icon icon="pencil" /> **编辑代理**。
3. 在图形视图的 **技能** 部分，选择要共享的技能。
4. 点击 <Icon icon="share" />**共享**。

共享后，该技能将出现在 [**技能**](https://smith.langchain.com/agents/skills) 页面上。您可以从代理编辑器将共享技能添加到工作区中的任何代理，通用聊天会自动获取它们。

<Note>
  只有共享技能的创建者才能编辑或删除它。
</Note>

## 删除私有技能

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

1. 在 [Fleet](https://smith.langchain.com/agents) 中选择代理。
2. 点击 <Icon icon="pencil" /> **编辑代理**。
3. 在 **技能** 部分，点击要删除技能的 <Icon icon="trash" /> 图标。

## 删除共享技能

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

<Warning>
  删除技能会将其从工作区和所有使用它的代理中移除。此操作无法撤销。
</Warning>

1. 导航到 [**Fleet > 技能**](https://smith.langchain.com/agents/skills)。
2. 选择要删除的技能。
3. 点击 <Icon icon="trash" /> **删除技能** 图标。

## 在本地开发中使用 Fleet 技能

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

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

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
langsmith fleet skills pull [skill-name] [flags]
```

| 标志                | 描述                                       |
| ----------------- | ---------------------------------------- |
| `--global=false`  | 安装到项目级目录（`.agents/` 和 `.claude/`）而不是主目录。 |
| `--agent`         | 针对特定代理（`claude`、`cursor`、`codex`）。       |
| `--copy`          | 复制文件而不是符号链接。                             |
| `--format pretty` | 显示已安装技能的文件树。                             |

例如：

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
$ 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
```

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档连接](/use-these-docs)到 Claude、VSCode 等，通过 MCP 获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/fleet/skills.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>