云器科技-文档

Skill技能包能力介绍

把一套固定的业务知识、操作流程、提示词规则、SQL 模板或分析方法打包起来，让 Agent 在遇到对应问题时按这套规则执行。

Skill 可以做什么

沉淀业务流程：例如数据探查、任务失败诊断、表优化治理。
固定输出格式：例如按“结论、证据、建议”输出诊断报告。
复用专业知识：例如 Olist 电商数据集的表关系、指标口径、建模规则。
管理复杂模板：例如把 SQL 模板放到
```
references/sql_templates.md
```
references/sql_templates.md
中供 Agent 使用。
提高 Agent 稳定性：避免每次都重新解释规则，让同类任务执行更一致。

Skill 通常包含

```
SKILL.md
```
SKILL.md
：核心说明文件，包含技能名称、描述、触发场景、执行步骤。
```
references/
```
references/
：可选目录，用于放长文档、SQL 模板、规则库、指标口径等。
其他辅助文件：如示例、脚本、模板等。

一个简单例子

---name: schema-data-profilingdescription: 对指定 schema 的全部表进行数据探查，输出表清单、字段结构、表关系和事实表维表分类。---# Schema Data Profiling当用户要求分析某个 schema 时，执行以下步骤：1. 列出 schema 下所有表。2. 获取字段结构。3. 分析表间关系。4. 统计时间周期。5. 判断事实表和维表。6. 输出探查报告。

适合使用 Skill 的场景

一类任务会反复出现。
有固定业务流程。
需要稳定输出格式。
有较多行业知识或模板需要复用。
希望 Agent 自动按规范执行。

上传Skill

上传入口

打开 Data Agent 页面。
点击左侧侧边栏的
```
技能
```
技能
。
在 Skill 列表上方点击
```
+
```
+
。
弹出
```
上传技能
```
上传技能
窗口。

文件要求

支持上传
```
.md
```
.md
、
```
.zip
```
.zip
或
```
.skill
```
.skill
文件。
如果上传
```
.md
```
.md
文件：
- 文件内容必须包含 YAML 头。
- YAML 头中必须包含
```
name
```
  name
  和
```
description
```
  description
  。
如果上传
```
.zip
```
.zip
或
```
.skill
```
.skill
文件：
- 压缩包中必须包含且仅包含一个
```
SKILL.md
```
  SKILL.md
  。
- 建议把
```
SKILL.md
```
  SKILL.md
  放在压缩包一级目录下，避免多层目录解析失败。

推荐 SKILL.md 格式

---name: skill-upload-smoke-testdescription: 用于验证 Skill 上传、展示和调用链路的测试技能。---# Skill Upload Smoke Test当用户要求执行上传技能冒烟测试时，回复：SKILL_UPLOAD_SMOKE_TEST_OK。不要执行任何外部操作，不读取敏感信息。

YAML 规则

开头必须是三个短横：
```
---
```
---
结尾也必须是三个短横：
```
---
```
---
```
name
```
name
必须有值。
```
description
```
description
必须有值。
```
description
```
description
建议写成一行。
不建议使用
```
\
```
\
对
```
description
```
description
换行。
不建议写多行 description。
正文从第二个
```
---
```
---
后开始，正文内容可按 Markdown 正常书写。

不推荐写法

--name: bad-skilldescription: 开头只有两个短横---

---name: bad-skilldescription: 第一行描述 \ 第二行描述---

---name: bad-skilldescription---

上传步骤

在
```
上传技能
```
上传技能
弹窗中点击上传区域。
选择准备好的
```
.md
```
.md
/
```
.zip
```
.zip
/
```
.skill
```
.skill
文件。
在
```
提示词
```
提示词
输入框中填写触发提示词，例如：
- ```
执行上传技能冒烟测试
```
  执行上传技能冒烟测试
- ```
使用数据探查技能
```
  使用数据探查技能
- ```
分析 schema 下全部表
```
  分析 schema 下全部表
点击
```
确定
```
确定
。
上传成功后，Skill 会出现在左侧 Skill 列表中。
点击 Skill 可查看名称、类型、更新时间、负责人、描述、提示词和正文内容。

使用 Skill

在 Skill 详情页点击
```
使用
```
使用
。
页面会回到 Agent 对话框，并把 Skill 标签插入输入框。
输入你的任务描述并发送。
Agent 应按照 Skill 内容执行或回复。

常见失败原因

zip 包里没有
```
SKILL.md
```
SKILL.md
。
zip 包里有多个
```
SKILL.md
```
SKILL.md
。
YAML 开头不是
```
---
```
---
。
YAML 缺少结尾
```
---
```
---
。
缺少
```
name
```
name
。
缺少
```
description
```
description
。
```
description
```
description
换行导致解析异常。
上传的是伪 zip 或损坏 zip 文件。

建议

```
description
```
description
尽量压缩成一行。
文件名和
```
name
```
name
使用英文、数字、中横线。
每次上传前先本地检查
```
SKILL.md
```
SKILL.md
。
上传失败但页面没有明确提示时，优先检查是否缺少
```
SKILL.md
```
SKILL.md
或 YAML 格式错误。

使用Skill

显示选择skill后，agent在规划路径时会优先以所选Skill作为规划路径，并对当前行为进行规划和执行。

联系我们