根据 ID 获取单个 Skill 的详细信息。
GET /api/v1/cloud/skills/{skill_id}
根据 ID 获取单个 Skill 的详细信息。
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
skill_id | string | 是 | Skill 的唯一标识符 |
查询参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
include_content | boolean | 否 | ⚠️ 已废弃：设为 true 时在 content 中返回 base64 编码的 Skill 内容（替代：下载 Skill 版本内容 GET /skills/{skill_id}/versions/{version}/content） |
示例请求
示例响应
HTTP 200 OK
响应字段
响应为 Skill 对象。
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Skill 唯一标识符（skill_ 前缀） |
type | string | 资源类型，固定为 "skill" |
display_title | string | 展示标题 |
source | string | Skill 来源：custom 或 qoder |
latest_version | string | null | 最新版本号；所有版本均被删除时为 null |
metadata | object | 与 Skill 一起存储的自定义元数据对象；省略时为 {} |
description | string | ⚠️ 已废弃：Skill 描述（替代：版本对象上的 description，见 获取 Skill 版本） |
content | string | ⚠️ 已废弃：base64 编码内容，仅 include_content=true 时返回（替代：下载 Skill 版本内容） |
content_encoding | string | ⚠️ 已废弃：与 content 同时返回，值为 "base64"（替代：同上） |
created_at | string | 创建时间 |
updated_at | string | 最后更新时间 |
错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 401 | authentication_error | 缺少或无效的认证令牌 |
| 404 | not_found_error | Skill 不存在或不再可访问 |