Skill 数据结构 - Qoder

Skill 对象

创建、查询、列表和更新接口都会返回该结构。

字段	类型	说明
`id`	string	Skill ID，前缀为 `skill_`
`type`	string	固定值 `"skill"`
`display_title`	string	由已存储 Skill 名称派生的展示标题
`description`	string	来自 `SKILL.md` 的 Skill 描述
`source`	string	可选值：`custom`、`qoder`
`latest_version`	string	最新版本号，字符串格式
`metadata`	object	与 Skill 一起存储的自定义元数据对象；省略时为 `{}`
`content`	string	仅在查询接口请求包含内容时返回；base64 编码
`content_encoding`	string	与 `content` 一起返回，值为 `base64`
`created_at`	string	创建时间
`updated_at`	string	最后更新时间

Skill version 对象

列出版本接口返回该结构。

字段	类型	说明
`skill_id`	string	Skill ID
`version`	string	版本字符串
`content_size`	integer	内容大小，单位 byte
`content_sha256`	string	SHA-256 摘要
`status`	string	Skill 状态
`created_at`	string	创建时间
`updated_at`	string	最后更新时间

Skill package

创建请求使用 multipart/form-data 上传 .zip 包。

规则	说明
文件扩展名	`.zip`
最大大小	5 MB
必需 manifest	`SKILL.md` 位于压缩包根目录，或根目录下一级目录内
必需 frontmatter	`name` 和 `description`

相关

Agent 技能

为 Agent 附加领域专业知识。

列表 Skill 版本列出 Vaults