> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

技能（Skill）是用于扩展智能体功能的模块化能力，它包含了说明文件、元数据、代码脚本等，为智能体提供特定领域的专业知识、工作流程和最佳实践。[扣子](https://space.coze.cn/)和[扣子编程](https://code.coze.cn/home)现已全面支持技能的开发与使用，通过扣子编程开发的技能可以在扣子对话任务中使用，让扣子 AI 按需加载不同的技能，从通用的智能体转化为垂直领域的专家。
## 什么是技能 {#cfa11f15}
技能可以将过去分散在提示词、代码片段或零散文档中的隐性知识，显性化、结构化地组织起来，让 AI Agent 按需、稳定地执行专业任务。你可以将技能看做是新员工的入职材料，将积累的工作经验和最佳实践打包为技能包，让扣子 AI 成为你专业领域的专家。
不同于一次性的提示词（Prompt），技能是可保存、复用、优化的任务解决方案，让 AI **从理解你的指令**，**变成掌握你的方法**。如果一个任务的处理流程相对固定、可稳定重复操作，且需要一致、可靠的输出时，可以将其封装为技能，提供给通用智能体使用。
### 技能的工作机制 {#1be918bd}
从本质上讲，每个技能都是一个结构固定的文件夹，它遵循统一的规范，清晰地描述了执行任务所需的标准作业流程（SOP）、方法论和参考模板。为保证对话效率，智能体并不会一次性加载技能的全部内容，而是通过“渐进式披露”机制，在对话中判断哪些技能与当前任务相关，然后仅加载完成任务所需的信息，从而避免上下文窗口过载。
一个标准的技能文件夹通常包含以下几个部分：

* `SKILL.md`：技能的使用说明书和元数据文件，用于向智能体说明技能的名称和用途。智能体在启动时会始终加载元数据，以便决定何时以及如何调用该技能。
* `scripts/`目录：存放可执行的代码文件，用于执行确定性的计算任务。
* `references/` 目录：存放技能相关的参考文档，例如第三方 API 文档、相关的规范和标准等参考资料、设计文档、测试报告等。
* `assets/` 目录：存放技能依赖的静态资源和模板，为智能体提供执行任务所需的额外信息，例如配置模板等模板文件、音视频文件等静态资源。

```Bash
my-skill/
├── SKILL.md          # 【必选】使用说明 + 元数据
├── scripts/          # 【可选】可执行代码
├── references/       # 【可选】参考文档
└── assets/           # 【可选】模板、资源文件
```

### 扣子中的技能 {#0de1d843}
[扣子编程](https://code.coze.cn/home)和[扣子](https://space.coze.cn/)现已全面支持技能的开发与使用，你可以：

1. **在扣子编程开发你的技能**：通过 AI 编程方式使用自然语言开发一个技能。例如：
   * 新人入职培训技能：企业 HR 提供新人入职培训的规则和 SOP，新员工入职时只需和扣子 AI 对话即可完成新人培训。
   * 视频生成技能：自动生成故事大纲、分集剧情、脚本制作和视频生成，短剧创作团队可以在扣子中直接上传素材、一键生成短剧。
   * 前端设计技能：沉淀独特的艺术风格与前端技术规范，UI 设计师可以在扣子编程中快速开发出风格类似的网页应用。
2. **使用技能**：发送你的具体指令，扣子 AI 会自动识别并加载任务相关的技能。一旦技能被触发，扣子 AI 无需通过大模型生成的方式去自主规划，而是通过技能中指定的操作流程和处理方式来完成任务。
   * **在扣子编程中使用技能**：目前，所有扣子编程的集成服务均有配套的官方技能。在项目开发过程中，扣子 AI 会自行判断项目所需的集成服务，并加载对应的技能。同时，你也可以上传用于特定领域或流程的自定义技能。
   * **在扣子中使用技能**：一个复杂的任务往往需要多个技能来协同完成，扣子提供了技能商店（https://www.coze.cn/skills）、虾评社区（https://xiaping.coze.com/），与开发者一起打造丰富完善的技能生态，解决技能的分发、消费、变现问题。企业旗舰版用户还可以构建企业专属的技能商店，实现企业内部的资源与经验共享。

## 技能和其他概念的区别 {#e9507287}

* **技能和提示词**：系统提示词定义了智能体的**全局人设和工作方式**，例如智能体的身份、人设、语气或工作方式。这类设定通常对每一轮对话持续生效，用于约束整体输出风格；技能则提供**特定领域的专业能力与方法支持**，例如“基于指定模型进行财务数据分析”的能力。技能并非全程启用，而是根据用户的具体任务按需触发，仅在相关对话或任务场景中生效。
* **技能和工作流**：技能是特定领域**知识、方法和工具**的集合，相当于一个“可复用的操作说明书”。它不强制规定具体的执行路径，而是为智能体提供判断依据与最佳实践，允许智能体在执行过程中保留一定的自主决策空间；工作流是**预设好的流程编排**，具有明确的步骤顺序与逻辑关系。每个环节的输入与输出都是确定的，执行路径固定，适用于强流程约束的自动化任务。
* **技能和插件**：插件主要负责**调用外部工具或服务的 API**，负责能力的技术接入。  技能在此基础上进一步封装了**使用策略与操作说明**，不仅包含 API 调用脚本，还会明确说明在什么条件下、以何种方式调用这些能力，从而指导智能体合理地使用外部工具完成任务。
* **技能和 MCP**：MCP 提供**能力调用的接口**，使智能体能够访问外部服务、系统或数据源；  技能则是围绕某一任务目标形成的**完整解决方案**，包含经验总结、流程说明与执行策略。在实际应用中，技能可以将 MCP 作为执行流程中的一部分：MCP 负责提供工具与数据能力，技能负责指导智能体如何获取、理解并使用这些能力来完成任务。
* **技能和 RAG 知识库**：RAG 知识库主要用于为智能体提供**已有文档与素材内容**，适合信息检索与内容补充类场景。技能则侧重于针对具体问题总结出的**标准操作流程（SOP）与最佳实践**。在处理明确、聚焦的问题时，技能通常具备更高的针对性与执行效率；而 RAG 知识库在覆盖范围与信息完整性方面更具优势；技能可以将 RAG知识库 作为技能中的一部分。

## 技能的类型 {#78f08f56}
根据技能的提供者和使用范围，技能可分为以下类型：
<!-- @cols-width: 100,187,602 -->
| | | | \
|**服务** |**技能类型** |**说明** |
|---|---|---|
| | | | \
|扣子编程 |官方编程技能 |由扣子官方开发和维护的编程技能，不同编程项目能用的官方技能并不完全一样，系统会根据项目类型**自动添加**匹配的技能。 |
|^^| | | \
| |我的编程技能 |手动上传的编程技能，这些技能仅限你个人使用。 |
| | | | \
|扣子 |官方技能 |由扣子官方开发和维护的技能，通过技能商店面向所有用户开放。在对话中，扣子会按需自动调用官方技能完成任务。 |
|^^| | | \
| |第三方技能 |扣子技能商店中，由其他第三方组织或扣子用户开发和维护的技能，同样面向所有用户开放。 |\
| | |你需要先安装并开启第三方技能，扣子才会在对话中按需调用。 |\
| | |需要注意的是，部分第三方技能是收费的，你可以在技能商店中看到收费技能的对应标识。 |
|^^| | | \
| |自定义技能 |由你个人为特定领域或特定流程创建的技能，只有你本人才能编辑、发布、使用。你可以根据个人经验和工作需求来开发技能，例如某个工作场景的数据分析技能、文档编写和格式处理技能等。 |
|^^| | | \
| |企业技能 |对于企业旗舰版套餐，员工开发的自定义技能可以发布到企业商店中，专供本企业内员工使用。 |\
| | |通过企业商店，企业可以统一定制内部专属的工作流程，确保员工使用标准化的流程和最佳实践。 |

## 如何开发技能 {#598bfa35}
对于某个任务，如果你已经根据经验总结出了最佳操作路径和操作方式，那么可以考虑开发一个技能，将这些操作路径和操作方式固化在技能中，让智能体在遇到类似任务时，能够自动执行技能完成任务。
在扣子编程中开发技能的步骤如下：

1. 在[扣子编程](https://code.coze.cn/)首页，选择**技能**页签，并输入你的需求。
   你可以描述技能的功能、用途、你希望的执行流程等，详细的描述可以帮助扣子 AI 更好地理解你的需求。另外，如果你有一些相关的材料、数据、文档等，可以同时上传，帮助扣子 AI 总结你的经验和工作流程。
   ![Image=429x246](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/18a8b67517ac44b38ab2320b3dd81c71~tplv-goo7wpa0wc-image.image)
2. 扣子 AI 开发技能。
   扣子 AI 会根据你的需求和材料，总结你的经验，并生成一个标准格式的技能文件包。如果你的需求比较复杂，扣子 AI 可能会通过多轮对话来询问你一些细节，例如你预期的流程、输出格式等。
   ![Image=473x280](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c9c3a8f53b5243f6b268637cafa35453~tplv-goo7wpa0wc-image.image)
3. 预览和测试技能。
   你可以在右侧对话区通过对话来测试技能，查看扣子 AI 是否成功触发技能、按照你的预期执行工作流程。
   ![Image=465x232](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/87d51d3c905a4eebb0397378457e5561~tplv-goo7wpa0wc-image.image)
4. 部署技能。
   测试完成后需要部署技能，后续才能在扣子的对话任务中使用技能。
   ![Image=458x238](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5218bcdc22944750a3f8f1c3ba3652f5~tplv-goo7wpa0wc-image.image)

关于通过扣子编程开发技能的详细步骤，可参考[开发技能](/guides/vibe_coding_skill)。
## 如何使用技能 {#6204f3e7}
你可以在扣子编程中使用技能，辅助扣子 AI 开发项目；也可以在扣子中使用技能，协助扣子 AI 处理复杂任务。

* **扣子编程**：在扣子编程首页选择对应的项目后，你可以在对话框中输入任务指令，然后单击**技能**来添加技能。项目开发过程中，扣子 AI 会在已添加的技能中自动搜索并加载合适的技能。关于使用技能的详细说明，可参考[在扣子编程中使用技能](/guides/using_skill#3456ebc7)。
   ![Image=594x244](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/02a21a8cdb534903b5d08a5b4deacdbb~tplv-goo7wpa0wc-image.image)
* **扣子**：部署技能之后，你可以在[扣子](https://space.coze.cn/)中通过对话来触发技能。发送你的具体指令，扣子 AI 会自动识别任务相关的技能，并加载技能来完成任务。
   关于在扣子中使用技能的详细说明，可参考[在扣子对话中使用技能](/cozespace/using_skills#fe840b8d)。
   ![Image=572x288](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4bb355a460054703b6ebe4e7be2559d1~tplv-goo7wpa0wc-image.image)