> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/advanced-basic/extensions/skills.md).

# 技能与能力库

技能是一套可复用的工作说明和配套资源。它不负责连接外部系统，而是告诉 Agent 应该按什么流程、标准和格式完成任务。

{% hint style="success" %}
需要某种工作方法时，先在【工作】中告诉 Agent 你的目标，并让它帮你查找或安装合适的技能。只有需要检查来源、批量管理或从本地导入时，再打开【设置】→【技能】。
{% endhint %}

<figure><img src="/files/T4gC7P9kLTeeL8HXXILa" alt="根据任务需要选择知识库、技能、内置工具或 MCP 的关系图"><figcaption><p>重复使用的方法适合沉淀为技能；资料、内置操作和外部系统分别使用对应入口。</p></figcaption></figure>

## 安装技能

手动路径：【设置】→【技能】。

页面支持三种来源：

* 在线搜索技能注册表；
* 从本地 ZIP 文件安装；
* 从包含 `SKILL.md` 的文件夹安装。

{% stepper %}
{% step %}

### 1. 先确认用途

用一句话说明你希望技能解决的问题，例如“把会议记录整理成决策、负责人和截止时间”。名称相似不代表流程相同，先看说明再安装。
{% endstep %}

{% step %}

### 2. 检查来源与内容

打开技能详情，确认它会要求 Agent 做什么、是否包含脚本、是否需要额外工具或外部账号。来源不明的技能不要直接用于敏感目录。
{% endstep %}

{% step %}

### 3. 绑定到 Agent

打开【工作】→ Agent 菜单→【编辑】→【技能】，启用所需技能。技能切换会随 Agent 配置自动保存，并从下一条消息生效。
{% endstep %}

{% step %}

### 4. 用真实任务验证

给 Agent 一份小样本，检查步骤、输出格式和边界是否符合预期，再用于批量任务或定时任务。
{% endstep %}
{% endstepper %}

## 技能、提示词和 MCP 怎么选

| 需要             | 应选择         | 原因            |
| -------------- | ----------- | ------------- |
| 一句临时要求         | 当前任务提示词     | 不必增加长期配置      |
| 多次复用同一流程       | 技能          | 能同时保存说明、模板和资源 |
| 设定 Agent 的长期角色 | Agent 系统提示词 | 每个任务都需要遵守     |
| 访问数据库或外部服务     | MCP         | 技能本身不提供连接能力   |

## 用户案例：团队周报技能

团队把周报栏目、语气、数据检查和禁用表述写成技能，绑定到“周报整理”Agent。每周只需要提供本周资料，Agent 按技能输出固定结构；数据来自外部系统时，再组合 MCP，而不是把账号和接口细节写进技能正文。

{% hint style="danger" %}
卸载技能会从全局能力库中移除它，并清理 Agent 工作区中的关联。执行前确认没有正在使用该技能的任务；团队自定义技能应保留可恢复的源文件。
{% endhint %}

<details>

<summary>安装后为什么 Agent 没有使用技能？</summary>

安装只把技能加入全局能力库。还需要在 Agent 编辑窗口的【技能】中启用，或让 Agent 帮你完成绑定。随后新发一条消息测试。

</details>

<details>

<summary>技能可以包含程序吗？</summary>

技能包可以包含说明、资源和脚本。是否能够执行脚本，还取决于 Agent 的工具、工作目录、环境依赖和权限模式。

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/advanced-basic/extensions/skills.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.