本文介绍如何从技能广场、工作台或 Data Agent 创建技能。

从技能广场创建技能

1. 在左侧导航栏依次单击智能体 > 技能广场，进入项目技能页面。

2. 在页面右上方单击创建，选择创建方式：

   • 本地上传：上传打包好的 ZIP 技能包；
   • 在线编辑：在线编写 SKILL.md 内容。
3. 按下方对应方式填写配置并提交。创建成功后技能出现在列表中，初始状态为未发布，需单独发布。

本地上传（ZIP 技能包）

在本地上传技能对话框中完成配置后，单击保存（仅创建）或发布（创建并发起发布）。

表1 本地上传配置项说明

ZIP 技能包需满足以下结构与配额要求，否则上传或发布时会校验失败并提示原因：

• 解压后顶层有且仅有一个目录 <name>/，不允许并存其他文件或目录（__MACOSX/、.DS_Store、.git/ 等打包噪声会被忽略）；
• <name>/ 下有且仅有一个 SKILL.md，其 frontmatter 的 name 须与目录名一致，并满足技能名称规则；
• ZIP 原始体积 ≤ 10 MB，文件数 ≤ 100（不含目录），解压后总体积 ≤ 200 MB，单个文件体积 ≤ 10 MB。

在线编辑（SKILL.md）

在在线编辑技能对话框中，于详细内容中编写符合规范的 SKILL.md 内容，技能名称和描述由内容中的 name、description 字段自动解析，无需单独填写。编写完成后单击保存或发布。

从工作台项目或"我的"创建技能

1. 进入工作台，在左侧导航栏单击项目或我的。
2. 如果进入"项目"，先进入目标项目；如果进入"我的"，直接进入"我的"文件列表。
3. 单击页面右上方创建，选择应用 > 智能体 > 技能。
4. 系统跳转到技能广场的创建流程，按本地上传或在线编辑方式完成创建；所属位置默认为当前进入的路径。

从工作台的"项目"或"我的"入口创建技能时，会跳转到技能广场完成创建；从 Data Agent 内创建时不会跳转。

在 Data Agent 中创建技能

Data Agent 支持在技能选择入口内创建技能，不需要跳转到技能广场。

1. 进入智能体 > Data Agent，在下方工具栏单击上下文按钮，选择分析技能。
2. 左侧选择项目或我的，单击右上方新建。
3. 选择适用应用和所属位置，编写技能内容后保存并发布。技能发布后添加到当前 Data Agent 的技能列表中。

SKILL.md 内容规范

技能的 SKILL.md 必须包含 name 和 description 字段，并按 Markdown 格式编写正文：

1---
2name: your-skill-name
3description: 描述这个技能能够完成的任务，以及适用的场景或用户请求。
4
5---
6
7# 技能名称
8
9## 目标
10说明技能需要帮助用户完成的任务和预期结果。
11
12## 工作流程
13按执行顺序说明完成任务所需的步骤、使用的工具和必要的检查。

系统根据 SKILL.md 内容自动解析技能名称和描述，创建时不需要单独填写这两个字段。

内容校验规则

• name 和 description 必须存在，否则无法创建技能。
• name 长度为 1～64 个字符，仅允许小写英文字母 a-z、数字 0-9 和连字符 -。
• name 不能以连字符开头或结尾，不能包含连续的 --，不能以 shengsuan- 开头。
• name 须与 ZIP 技能包根目录名一致。
• description 最多 1024 个字符。
• 技能详细内容不能为空。