创建技能

Snail AI 提供两种创建技能的方式：在线创建（通过管理界面直接创建）和 ZIP 上传（上传包含 SKILL.md 的 ZIP 压缩包）。两种方式各有适用场景，可根据实际需求灵活选择。

方式一：在线创建

在线创建方式适用于从零开始编写技能，或者需要快速创建一个技能骨架后逐步完善的场景。

操作步骤

1. 进入「技能管理」页面，点击「在线创建」按钮。
2. 在弹出的抽屉表单中填写以下信息：

字段	是否必填	说明
技能名称	是	技能的显示名称，建议简洁明了
技能描述	否	对技能功能的简要说明

3. 点击「确定」提交。

提交成功后，系统会：

• 在数据库中创建技能记录。
• 自动生成一个包含空 frontmatter 的 SKILL.md 文件。
• 自动跳转到在线文件编辑器，你可以立即开始编写技能内容。

适用场景

• 从零开始创建新技能
• 需要在平台上逐步调试和完善技能内容
• 技能内容较简单，不需要复杂的辅助文件结构

方式二：ZIP 上传

ZIP 上传方式适用于在本地环境中已经制作好完整技能包的场景，或者需要从其他环境迁移技能的情况。

ZIP 包要求

上传的 ZIP 文件必须满足以下条件：

• 文件格式：必须是 .zip 后缀的标准 ZIP 压缩包。
• 必含文件：ZIP 包根目录下必须包含 SKILL.md 文件。
• 编码要求：所有文本文件建议使用 UTF-8 编码。

SKILL.md 格式规范

SKILL.md 是技能的核心文件，采用 Markdown 格式，顶部使用 YAML frontmatter 声明技能元数据。

完整格式示例

---
name: 数据分析报告生成器
description: 根据用户提供的数据集自动生成结构化的数据分析报告，包含统计摘要、可视化建议和洞察结论
---

# 数据分析报告生成器

你是一个专业的数据分析助手，负责根据用户提供的数据生成规范的分析报告。

## 分析流程

1. **数据概览**：统计数据集的基本信息（行数、列数、数据类型、缺失值）
2. **描述性统计**：计算均值、中位数、标准差、分位数等统计指标
3. **数据分布**：分析各字段的分布特征，识别异常值
4. **相关性分析**：计算变量间的相关系数，识别强相关关系
5. **洞察总结**：提炼关键发现，给出可操作的建议

## 报告模板

请严格按照以下模板输出报告：

### 一、数据概览
- 数据集名称：{name}
- 样本数量：{rows}
- 字段数量：{columns}
- 数据质量评分：{quality_score}/10

### 二、关键发现
（按重要性排序列出 3-5 个核心发现）

### 三、改进建议
（给出 2-3 条可操作的数据质量或业务改进建议）

frontmatter 字段详解

字段	类型	必填	说明
name	string	推荐	技能的展示名称。如果未指定，系统将使用上传文件名作为技能名称
description	string	推荐	技能的功能描述。会显示在技能卡片上，帮助管理员快速了解技能用途

注意事项

• frontmatter 必须位于文件最开头，以 --- 开始和结束。
• frontmatter 之前不能有任何字符（包括空行和空格）。
• YAML 语法中，如果值包含特殊字符（如冒号），需要用引号包裹。

操作步骤

1. 在本地准备好符合规范的 ZIP 包。
2. 进入「技能管理」页面，点击「上传 ZIP」按钮。
3. 在文件选择对话框中选择 .zip 文件。
4. 系统自动上传并解析：
   • 从 SKILL.md 的 frontmatter 中提取 name 和 description。
   • 创建技能记录并存储所有文件。
5. 上传成功后，技能卡片出现在列表中。

上传失败的常见原因

错误情况	说明	解决方案
文件格式错误	上传了非 ZIP 格式的文件	确保文件后缀为 .zip
缺少 SKILL.md	ZIP 包中未包含 SKILL.md	在 ZIP 根目录下添加 SKILL.md 文件
frontmatter 语法错误	YAML 格式不正确	检查 frontmatter 的 YAML 语法，确保键值对格式正确
文件过大	ZIP 包超出系统限制	检查是否包含了不必要的大文件

下载/导出技能

已创建的技能可以随时导出为 ZIP 包，用于备份、迁移或分享。

操作步骤

1. 在技能列表页找到目标技能卡片。
2. 点击卡片上的「下载」按钮。
3. 浏览器将自动下载名为 skill-{id}.zip 的文件。

下载的 ZIP 包包含该技能的所有文件（SKILL.md 和全部辅助文件），可以直接在另一个 Snail AI 实例上重新上传使用。

团队协作建议

利用下载/上传功能，可以在团队成员之间轻松共享技能包。建议将常用技能的 ZIP 包纳入团队的版本控制仓库（如 Git），方便追踪变更历史。

编辑技能元信息

创建技能后，如果需要修改技能的名称或描述（不涉及文件内容修改），可以通过以下方式操作：

1. 在技能列表页找到目标技能卡片。
2. 点击「信息」按钮。
3. 在弹出的抽屉中修改名称和描述。
4. 点击「确定」保存。

TIP

修改技能名称和描述只会更新数据库中的元信息记录，不会自动同步到 SKILL.md 的 frontmatter 中。如果需要保持一致，请同时通过在线编辑器更新 SKILL.md 的 frontmatter。

删除技能

删除技能将同时移除数据库中的技能记录和所有关联的文件。此操作不可撤销。

操作步骤

1. 在技能列表页找到目标技能卡片。
2. 点击「删除」按钮。
3. 在确认对话框中确认删除。

注意

• 删除操作不可恢复。如果技能内容可能在将来使用，请先通过下载功能备份 ZIP 包。
• 如果该技能正在被某个智能体绑定使用，删除后智能体将无法再引用此技能。

下一步

• 在线文件编辑器 -- 使用内置编辑器编辑技能文件内容