> ## 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.

扣子编程现已支持通过 AI 编程的方式开发技能。本文档介绍如何在扣子编程中创建你的自定义技能，目前支持通过自然语言开发技能，或者将你上传的技能文件打包为技能。
## 功能概述 {#331e4c94}
技能是用于扩展智能体功能的模块化能力，它包含了说明文件、元数据、代码脚本等，为智能体提供特定领域的专业知识、工作流程和最佳实践。在扣子编程中，你可以直接输入你想要的技能细节，例如技能的目标、执行流程、预期输出等，扣子 AI 会自动为你创建一个格式标准的技能文件包，并编写 `skills.md` 等对应的技能文件、打包需要的资源。
你无需手动编辑文件，扣子 AI 帮助你将专业流程知识封装为可复用的模块化资源，让通用模型快速变身垂直领域专家。
如果你已经准备了开发技能所需的相关资料，可以帮助扣子 AI 理解你的需求、你期望的工作流程、数据处理方式等，也可以在对话中提供给扣子 AI。例如，你可以输入以下要求，并上传术语表，让扣子编程为你开发一个文档翻译的技能：
```Plain Text
请帮我开发一个中英文互译的技能，遵循通用的技术文档规范和风格指南，并使用指定的产品术语表。
```

:::tip 说明
* 开发调试完成的技能需要部署到扣子，才能在扣子对话区中使用。
* 通过扣子编程开发的技能，暂不支持直接在扣子编程中使用。你需要先将技能的 **`.skill`** 文件下载到本地，再通过本地上传功能上传到编程技能列表中。
* 如果你已经通过扣子对话探索出了某个任务的最佳执行方式，可以直接将其制作为技能，详细说明可参考[制作技能](/cozespace/create_skill)。
:::
## 通过自然语言生成技能 {#673cb080}
参考以下流程，通过 AI 编程开发你的技能。
### 步骤一：需求澄清 {#add40e03}

1. 输入你的需求。
   1. 在[扣子编程](https://code.coze.cn/)首页，单击**技能**选项卡。
   2. 在文本框输入你的提示词。
      通过自然语言创建技能时，提示词的撰写直接决定技能的逻辑、交互效果和稳定性，核心要求是清晰、结构化、可执行。在提示词中，你可以提供：
      * 技能的用途、可处理的任务类型、输出格式等。例如，“用于将指定图片切割为4×4 的拼图块并生成可交互的游戏”。
      * 技能的使用场景，包括用户的触发方式等。例如，“当用户提及‘帮我做个拼图游戏’时，自动触发此技能”。
      * 技能的输出格式。例如“输出一个可直接在浏览器中体验的 HTML 拼图游戏文件”。
      * 技能相关的脚本、参考文档或资源文件。
      你可以参考以下格式，输出你的需求：
      ```Plain Text
      我想创建一个[功能名称]的 Skill，用于[解决什么问题]，当用户[触发场景]时使用，输出[期望格式和内容]。
      ```

      例如：
      ```SQL
      我想创建一个拼图游戏生成器的 Skill，用于将用户上传的图片自动切割成 4×4 的拼图块并生成可交互的游戏，当用户说"帮我做个拼图游戏"或上传图片要求生成拼图时使用，输出一个可直接在浏览器中玩的 HTML 拼图游戏文件。
      
      我想创建一个客户邮件助手的 Skill，用于快速撰写专业的商务邮件，当用户需要回复询价、跟进客户或处理投诉时使用，输出可直接发送的邮件正文。
      
      我想创建一个合同风险审核的 Skill，用于识别合同中的风险条款并给出修改建议，当用户上传合同文件时使用，输出风险点清单和具体修改建议，合同风险条款可参考附件
      ```

      ![Image=453x190](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f2f9ea7915d149bf8312b5c53e0a39ab~tplv-goo7wpa0wc-image.image)
   3. （可选）进阶配置：通过上传附件、选择协作模式、选择编程模型，让扣子 AI 生成的结果更精准、更符合你的预期。
      ![Image=443x223](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/783c181bd4f845c4832192ad468b5007~tplv-goo7wpa0wc-image.image)
      
      :::: tabs
      @tab ① 上传附件
      酌情上传一些图片或文件，作为附加信息提供给扣子 AI，以便扣子 AI 能更理解你的需求。例如对于技术文档翻译技能，可以上传一个术语表，以便模型使用技能翻译文档时能保证术语一致性和翻译准确性。
      
      @tab ② 选择协作模式
      默认情况下为 **Agent 模式**，如果你对需求不确定，可以先切换到**问答模式**讨论方案，在方案确认后，再切换到**Agent 模式**，由扣子 AI 根据此前的讨论结论执行开发任务。更多信息，请参考[如何选择协作模式？](/guides/vibe_coding_faq#3069a332)。
      
      @tab ③ 选择编程模型
      扣子编程已集成 GLM 4.7、GLM 5、Kimi K2.5 等主流的编程模型，用于开发应用。为了达到较好的开发效果，系统会自动为你选择适合当前场景的模型，你也可以根据模型的官方介绍自行选择。
      
      ::::

   4. 在键盘中敲击回车，开始开发你的项目。
      扣子 AI 会根据你输入的提示词来开始设计技能、开发技能，并自动为项目设置名称。
2. （可选）澄清你的需求。
   扣子 AI 收到你的提示词之后，如果判断提示词不明确、缺失关键信息，则会向你发送提示，请求补充缺失的关键信息。例如开发者要求“开发一个文档格式处理技能”，但未提及技能的使用场景和目标格式等背景信息，此时扣子 AI 会主动追问相关细节。
   澄清需求时，你同样可以上传附件，为扣子 AI 提供相关的脚本、参考文档或资源文件。 

### 步骤二：AI 编程开发技能 {#33da3664}
扣子 AI 收到你的需求之后，将立即启动需求分析，并规划技能的文件结构，包括 `SKILL.md` 的文件内容、是否需要辅助的 references 文档、是否需要创建脚本等。创建文件结构、撰写技能并打包技能、验证结果之后，扣子 AI 会提示你任务已完成，你可以在右侧预览区域通过对话来触发技能、查看技能的执行效果。
![Image=611x362](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c9c3a8f53b5243f6b268637cafa35453~tplv-goo7wpa0wc-image.image)
### 步骤三：预览与测试 {#dcbc0d3b}
初步生成后端代码后，扣子 AI 会自动生成测试用例并完成一轮单元测试。测试通过后扣子 AI 会提供后端代码的预览，同时提醒你验收，你可以在右侧预览页面通过发送消息来触发技能，测试技能的实际效果。 
技能预览界面如下：
![Image=758x402](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5fa3c208d36f42dc988442243589f1d7~tplv-goo7wpa0wc-image.image)
在预览与测试的环节中，你可以通过以下操作预览并测试技能。
<!-- @cols-width: 197,639 -->
| | | \
|**操作** |**说明** |
|---|---|
| | | \
|调用技能 |技能打包完毕后，你可以在右侧预览页面体验技能的实际效果。 |\
| |在预览页面输入你的要求，扣子 AI 会自动触发技能并执行。例如，对于一个查询天气的技能，你可以输入“今天北京天气怎么样”。 |\
| |处理任务时，扣子 AI 会参考对话上下文判断你的意图和场景，你也可以在页面右上角单击图标清空上下文。 |
| | | \
|全面测试 |使用实际场景全面测试你的技能。技能测试通常能发现指令中的疏漏、描述的模糊之处、业务处理的边界问题。通常建议关注以下问题： |\
| | |\
| |* **是否稳定触发**：验证技能的触发条件，是否能在预期的场景中稳定触发。如果扣子 AI 调用了技能，对话区域会展示“完成技能加载”的提示。 |\
| |   如果未触发，你可以让扣子 AI 约束触发条件，或者自行编辑 `SKILL.md` 的 `description` 部分，明确说明技能的触发条件。注意修改 `SKILL.md` 之后，你需要通知扣子 AI 重新打包，以体验这个最新版本的技能。 |\
| |* **是否稳定执行**：检查技能的处理流程，查看是否有跳过或遗漏执行的步骤、最终输出的结果是否符合要求。  |\
| |* **是否能覆盖实际业务场景需求**：丰富的测试案例能帮助你全面测试技能的表现，建议挑选一些常用的业务场景 query 来测试技能的处理效果。也可以增加一些技能能力之外的问题、边界案例来测试技能效果。例如用户指令模糊、文件格式不符合要求、数据缺失等情况下，技能是否能优化处理。 |

## 上传技能包 {#38c32576}
如果你已经拥有了一个技能包，可以通过扣子编程的“上传技能包”功能，将技能包上传到扣子，扣子 AI 会自动解析技能包、执行安全性检测、并重新打包，以便部署到扣子对话中使用。上传技能包功能适用于已完成技能开发的场景，例如已经通过第三方工具生成了技能文件、自己在本地编写了技能文件等等。

1. 在扣子编程首页文本输入框中，选择**技能**页签。
2. 单击“上传技能包”的图标，并上传本地技能包文件。
   :::tip 说明
   你上传的技能包应符合以下格式要求：
   
   * 必须是 `.skill` 或者 `.ZIP` 后缀的文件。
   * 建议技能包应符合技能（Skill）的业界统一规范格式，例如至少包含 `SKILL.md` 文件，帮助扣子了解这个技能是什么、如何使用。如果不符合格式规范，扣子 AI 会自行改造为正确格式，这个过程中也可能会通过对话来向你收集技能的更多细节。
   :::
   ![Image=371x146](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ee42f5b9956a4449a44306e9fe59b655~tplv-goo7wpa0wc-image.image)
3. 扣子 AI 会自动解析和检测技能包，如果存在敏感信息的配置，会主动提示你配置为环境变量。
   ![Image=331x159](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a55181a09e47485391a7235e53a1150c~tplv-goo7wpa0wc-image.image)
4. 完成技能包的适配之后，你可以在右侧预览区域通过对话来触发技能、查看技能的执行效果。
   ![Image=597x229](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/42b5d2f948b3435ebcf108945ab81e86~tplv-goo7wpa0wc-image.image)

## 改造技能 {#9c0a979a}
测试并调优技能之后，这个技能就已经可以发布到扣子，在对话中使用了。但优秀的技能是不断完善和优化的，如果你认为这个技能在功能或者用途上仍有可改进之处，你也可以在扣子编程中通过自然语言或编写文件的方式，和扣子 AI 一起迭代你的技能。
### 编辑并更新技能 {#2349033d}
你可以和扣子 AI 一起持续优化技能，也可以自行编辑技能文件包，直到实现预期的效果。
<!-- @cols-width: 206,384,217 -->
| | | | \
|**编辑方式** |**说明** |**示例** |
|---|---|---|
| | | | \
|扣子 AI 对话 |在对话区中通过自然语言描述你的修改建议，和扣子 AI 一起优化你的技能。例如输入以下提示词： |\
| |```Plain Text |\
| |扩大一下触发条件，如果用户提及“翻译文档”，就调用这个技能处理。 |\
| |``` |\
| | |![Image=116x153](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/66d2b9d887cb4f94af7f4328fd9cc8e7~tplv-goo7wpa0wc-image.image) |
| | | | \
|手动编辑技能包 |在页面右上角单击文件夹图标，打开文件树，找到技能包文件夹（通常以技能名称命名），直接编辑你想修改的文件。例如，修改 `SKILL.md` 文件，自行约束触发规则。 |\
| |:::tip 说明 |\
| |修改文件之后，必须重新打包技能，才能体验修改后的技能，同时扣子 AI 会自动生成一个开发版本供你追溯。修改方式如下： |\
| | |\
| |* 通过**对话方式**，通知扣子 AI 重新打包以供你体验、使用。 |\
| |* 在预览页签右上角单击**更新技**能图标。 |\
| |::: |* 编辑文件： |\
| | | |\
| | |![Image=1809x932](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f0a1e4b4bc3c41f7b1f916bb9bf41a85~tplv-goo7wpa0wc-image.image) |\
| | | |\
| | |* 更新技能： |\
| | | |\
| | |![Image=1152x635](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b02f4b474f574384a7aa6cef6e015259~tplv-goo7wpa0wc-image.image) |

### 调用外部 API {#8b61ddf4}
扣子技能暂时不支持集成能力。如果你的技能需要调用外部 API、使用自定义模型完成特定功能，可以将 API 接口文档（Markdown 格式）提供给扣子 AI，让智能体自行调用 API 实现对应的能力。
其中，API Key 等鉴权信息可以通过环境变量传入，也可以让智能体在调用技能时要求用户输入自己的 API Key。
### 开发“**按次付费”技能** {#72c8a24d}
如果你希望上架的技能支持**按次付费**模式，那么你的技能需要满足如下条件：

1. 技能需调用 API **** 来提供服务。
   在开发提示词中，明确基于 API 开发技能。
2. 通过**环境变量**，提供调用该 API 所需的凭证（如 API Key 或 Token）。
   当用户按次购买此技能时，系统将通过该凭证来识别和计量用户的每一次调用，并根据你指定的价格，收取对应的积分。按次付费说明，请参考[付费设置](/cozespace/publish_skill#c431e55f)。

例如调用火山方舟的生图 API 开发生图技能，你可以输入如下指令，并上传 API 接口文档。

::::cols
@col 50
指令
```Plain Text
这是图片生成的接口文档，请参考这份接口文档帮我创建图片生成skill
```



@col 50
附件
<a href="https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/20913ba9a6f44d7f926e9824c4066402~tplv-goo7wpa0wc-image.image" download="图片生成集成.md" target="_blank">图片生成集成.md</a>


::::

![Image=446x171](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/61970999ceab49bca5f0a3a64bdf06ea~tplv-goo7wpa0wc-image.image)
在开发过程中，扣子 AI 会自动识别出需要的 API Key，并创建一个对应的环境变量。此时，你需要输入对应的 API Key，并单击**设置为开发者变量**。
![Image=268x279](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4fadda3d6fa54d41a81eab815d2bfa88~tplv-goo7wpa0wc-image.image)
### 回滚开发版本 {#aac7a731}
扣子 AI 使用当前的先进模型来完成任务，但由于模型生成代码的随机性，有时可能无法完全满足你的需求，生成了不符合预期的技能，或者出现了反复修复失败的故障，此时你可以使用回滚版本功能，将技能恢复到之前正常的版本状态。
在对话区顶部单击**版本历史**图标，找到要恢复的版本，在其右侧单击**回滚**图标。
![Image=455x256](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/118d401bd36844a5aa66fb162f7c5377~tplv-goo7wpa0wc-image.image)
## 后续操作 {#ff976331}
### 部署技能 {#83021b8f}
完成技能的开发与调试之后，你需要部署技能，才能在扣子对话中使用。在技能的开发页面右上角单击**部署**，根据页面提示确认技能的部署配置之后，单击**开始部署**即可。详细操作步骤可参考[发布技能](/guides/deploy_skill)。
![Image=655x454](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3ad39693993b43099a8d36e7f2c0a5a3~tplv-goo7wpa0wc-image.image)
扣子编程会自动执行技能的打包、构建和部署，部署成功后，你可以根据页面提示单击**立即体验**，在扣子对话中触发技能，体验技能的效果。
![Image=519x286](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e87fb896778348d5a2c41e66dcd7e90a~tplv-goo7wpa0wc-image.image)
### 下载技能包 {#cd55ee7b}
通过扣子编程开发的技能，你可以下载其技能包到本地，再重新上传到编程技能中，辅助扣子 AI 开发项目。即在技能开发的目录树中，找到 `.skill` 文件下载到本地。
![Image=611x366](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b8d1c19c1967440b954047bbfa47736d~tplv-goo7wpa0wc-image.image)
### 使用技能 {#c86c9a91}

* **扣子编程**：在扣子编程中使用技能，辅助扣子 AI 开发项目。具体操作，请参考[在扣子编程中使用技能](/guides/using_skill#3456ebc7)。
   ![Image=589x249](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d577ac5fe643433f831a1271b292a8c6~tplv-goo7wpa0wc-image.image)
* **扣子**：在扣子中使用技能，协助扣子 AI 处理复杂任务。具体操作，请参考[在扣子对话中使用技能](/cozespace/using_skills#fe840b8d)。
   ![Image=590x303](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/dbf9090f5ffc4a5b9643517d4e386471~tplv-goo7wpa0wc-image.image)