SKILL.md 包含一项任务的执行说明,并告诉 Agent 何时使用;还可加入该任务所需的参考资料和脚本。完整格式参见 Agent Skills。
在 Skills 页面创建、导入和管理 Skill 库中的 Skill。
Skill 库最多可保存 500 个 Skill,并在整个工作空间内共享。发布 Skill 更新后,所有使用它的 Agent 都会采用最新版本。
Skill 可用于:
- Agent 应用
- Workflow 应用中的 新 Agent 节点
默认情况下,所有者、管理者和编辑者可创建、编辑和发布 Skill 库中的 Skill,以及恢复历史版本。只有所有者和管理者可删除 Skill。普通成员和受限成员没有 Skill 权限。其他成员可通过自定义角色分别获得 查看 Skill、编辑 Skill、发布 Skill 和 删除 Skill 权限。详见 权限参考。
创建 Skill
在 Skills 页面点击 创建。如需以现有 Skill 为起点,在其 ⋯ 菜单中选择 复制,复制最新保存的内容(包括尚未发布的修改),然后打开副本。在编辑器中,你可自行编写,也可通过 Skill Builder 生成草稿。 在SKILL.md 正文中写明 Agent 要遵循的流程,并在 frontmatter 中设置:
- 显示名称:显示在侧边栏顶部以及 Skill 出现的各处。使用容易辨认的名称。
- 名称:Agent 引用 Skill 时使用的唯一名称,例如
refund-requests。 - 描述:Agent 通过它判断是否使用该 Skill。描述要具体。
- 元数据:用于记录其他参考信息的自定义字段,例如
owner: payments-team或source: https://wiki.example.com/refund-policy。
- 文本和代码(Markdown、脚本、JSON、YAML 等):直接编辑。
- CSV、图片和 PDF:直接预览。
- 其他文件:下载后查看。
使用 Skill Builder 起草
与 Skill Builder 对话,让它为你起草 Skill。描述使用场景或附上已有的流程文档,它会编写SKILL.md 并创建配套文件,供你检查和完善。
支持以下文件类型:
每条消息最多附加 10 个文件:图片不超过 10 MB,其他文件不超过 15 MB。这些文件只为 Skill Builder 提供上下文,不会成为 Skill 的一部分。要将文件加入 Skill,请通过文件树添加。
导入 Skill
要把在其他地方构建的 Skill 加入 Skill 库,点击 导入,选择.zip 或 .skill 包。包内需有 SKILL.md,大小默认不超过 50 MB,可通过 UPLOAD_SKILL_FILE_SIZE_LIMIT 调整。导入后,Skill 会以草稿状态加入 Skill 库,供你检查并发布。
为 Skill 添加标签
在 Skill 卡片或编辑器中添加标签,再按标签筛选 Skill。发布和版本
更改会自动保存为草稿。发布草稿后,才能将 Skill 添加到 Agent。每次发布都会保存为一个版本,之后可重新查看或恢复。要记录版本变化,打开对应版本的 ⋯ 菜单,添加标题和说明。恢复某个版本会用该版本替换当前草稿,不会发布 Skill,也不会创建新版本。发布恢复后的草稿,才能将它设为最新版本。
导出 Skill
要在当前工作空间之外使用 Skill,在其卡片或编辑器侧边栏的 ⋯ 菜单中选择 导出。导出的.zip 文件包含最新已保存的内容,包括尚未发布的修改。