Skill 对象、版本对象及 Skill 包约束的完整定义。
由创建、获取、列表和更新接口返回。
由列表版本接口返回。
创建请求通过
Skill 对象
由创建、获取、列表和更新接口返回。
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Skill ID，前缀 skill_ |
type | string | 固定为 "skill" |
name | string | Skill 名称（来自 SKILL.md）；仅小写字母、数字、连字符和下划线；以字母或数字开头；最多 64 个字符 |
description | string | Skill 描述（来自 SKILL.md） |
skill_type | string | 可选值：prebuilt、custom |
content_size | integer | 上传内容大小（字节） |
content_sha256 | string | 上传内容的 SHA-256 摘要 |
version | integer | Skill 版本号 |
status | string | Skill 状态，通常为 active |
metadata | object | Metadata 对象 |
content | string | 仅在包含内容的获取接口中返回；Base64 编码 |
content_encoding | string | 与 content 一同返回；值为 base64 |
created_at | string | 创建时间 |
updated_at | string | 最后更新时间 |
Skill 版本对象
由列表版本接口返回。
| 字段 | 类型 | 说明 |
|---|---|---|
skill_id | string | Skill ID |
version | string | 版本字符串 |
content_size | integer | 内容大小（字节） |
content_sha256 | string | SHA-256 摘要 |
status | string | Skill 状态 |
created_at | string | 创建时间 |
updated_at | string | 最后更新时间 |
Skill 包约束
创建请求通过 multipart/form-data 上传 .zip 包。
| 规则 | 说明 |
|---|---|
| 文件格式 | .zip |
| 最大大小 | 5 MB |
| 必须包含清单 | 归档根目录或根目录下一层目录中的 SKILL.md |
| 必须的 frontmatter | name 和 description |