本文面向空间管理员，介绍如何在 DeliveryAI 用户端查看系统内置 Skill、上传新增自定义 Skill，并对自定义 Skill 进行版本更新、下载、编辑和删除等管理操作。Skill 用于为 Agent 挂载可复用的能力配置，帮助 Agent 在流程节点中复用既定的指引、约束或能力组件。完成配置后，空间管理员可在 Agent 模板或流程节点中选择对应 Skill，使节点 Agent 具备所需的执行能力与配置。

说明

用户上传的自定义 Skill 会同步上传到 AgentKit 控制台技能模块。每个 DeliveryAI 产品空间，对应技能模块中的一个技能空间。

## 前提条件 * 您已登录 DeliveryAI 用户端，并已进入目标空间。 * 您拥有当前空间的管理权限。 ## 查看系统内置 Skill 1. 在 DeliveryAI 用户端左侧导航树中，选择“产品设置 \> Agent 配置”。 2. 在页面顶部，单击“Skill 管理”标签页。 3. 通过顶部筛选按钮“全部”、“系统内置”、“自定义”筛选范围，或是在搜索框中输入名称关键字，快速检索目标 Skill。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9aa04c7ddccf78d05b5497c33a747f6c.png) 4. 单击目标 Skill 操作列的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1c4b7080051ef60564ccd4a0ce28b867.png) 图标，查看 Skill 配置详情。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_425af92cac7bdbfe7026168f1baf4ca6.png) |**参数** |**说明** | |---|---| |**Skill 摘要** || |Skill 名称 |Skill 的展示名称，用于在列表、Agent 模板和流程节点配置中识别该能力。 | |类型 |Skill 的来源或分类，用于区分系统内置、空间配置或自定义创建的 Skill。 | |版本 |Skill 的版本。 | |上传时间 |展示 Skill 上传的时间。 | |关联状态 |Skill 当前的关联状态。显示为 **active** 时，表示该 Skill 当前处于可用状态。 | |文件列表 |Skill 的文件列表。 | |Skill.md |Skill 的具体配置文本或规则内容，通常用于描述 Agent 在执行任务时需要遵循的方法、步骤、输入输出要求或注意事项。 | ## 新增自定义 Skill 当企业内置或已有 Skill 无法覆盖某类团队工作方法、交付规范或节点执行要求时，空间管理员可新增自定义 Skill，将可复用的能力配置沉淀为标准化 Skill，供后续 Agent 模板或流程节点按需选择使用。 ### SKill 格式要求 * Skill zip 包目录结构要求： * 建议 zip 顶层为 Skill 名目录，并在目录内包含 SKILL.md（用于描述该 Skill）。 * 如 Skill 包缺少关键文件或目录结构不符合要求，上传后可能无法正确解析或创建失败。 * .zip包结构示例： ```Plain Text .zip └── / ├── SKILL.md └── references/（可选） └── ... ``` * SKILL.md 元数据（frontmatter）要求：平台会从 SKILL.md 的 frontmatter 中解析 Skill 的名称、描述和版本信息。建议至少包含以下字段： ```Markdown --- name: Code Review Guard description: 用于对代码变更进行规则检查与输出建议。 version: 1.0.0 --- # Skill 说明（正文内容...） ``` ### 操作步骤 1. 在 DeliveryAI 用户端左侧导航树中，选择“产品设置 \> Agent 配置”。 2. 在页面顶部，单击“Skill 管理”标签页。 3. 在“Skill 管理”页面右上角，单击“新增 Skill”，打开创建面板。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ce11bfefe6b3d1ff84da924013682547.png) 4. 在“Skill zip 包”区域中，单击上传区域选择文件，或将 Skill .zip 包拖拽到上传区域。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2f216b22f3e1c34bfa67afb7a71b9206.png) 5. 确认已上传 .zip 文件后，等待系统自动解析 Skill 的名称、描述和版本信息。 6. 单击“上传 Skill”按钮，完成自定义 Skill 新增操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f3234d38aecd5171e6f2db54d14d4653.png) ## 其他操作 * **更新自定义 Skill**： * **操作场景**：当自定义 Skill 需要修复问题、补充能力或升级版本时，可通过上传新版本更新 Skill 内容。 * **操作入口**：单击目标自定义 Skill 操作列的“上传新版本”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ffa56b017d0bf23b7444ed76ceb47c82.png) * **下载最新版本 Skill**： * **操作场景**：当需要备份当前 Skill、进行离线审阅，或将 Skill 包分发给其他管理员进行复用时，可下载最新版本 Skill。 * **操作入口**：单击目标 Skill 操作列的“下载新版本”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b8ed043bebde5cd11d5559a5f69bb5dc.png) * **编辑自定义 Skill**： * **操作场景**：当需要调整自定义 Skill 的展示信息（例如名称或描述），或更新其他 Skill 配置内容时，可进行编辑操作。 * **操作入口**：单击目标自定义 Skill 操作列的“编辑”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_932c8b416587ebec88c5cf62b27164b6.png) * **删除自定义 Skill**： * **操作场景**：当自定义 Skill 不再使用、或需要下线清理时，可删除该 Skill。 * **操作入口**：单击目标自定义 Skill 操作列的“删除”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a1a17181cf84aa13c4e669de2b926115.png)