Skills API
Skill 查询、下载、创建与版本上传接口(当前仅草稿流)。
当前阶段:Skill 通过 API 创建后保持 draft;发布状态仅管理员可通过数据库手工修改。
| 方法 | 路径 | 说明 | 认证 |
|---|---|---|---|
| GET | /v1/skills | 列表查询(支持关键词、标签、分类过滤) | 公开 |
| GET | /v1/skills/:skillId | 获取 Skill 详情 | 公开 |
| GET | /v1/skills/:skillId/versions | 获取版本列表 | 公开 |
| GET | /v1/skills/:skillId/versions/:version/download | 下载指定版本 | 公开 |
| GET | /v1/skills/:skillId/stats | 获取下载统计 | 公开 |
| POST | /v1/skills | 创建 Skill 草稿 | 🔒 skill:upload |
| PATCH | /v1/skills/:skillId | 更新 Skill 元信息 | 🔒 skill:upload |
| POST | /v1/skills/:skillId/versions | 上传新版本(multipart) | 🔒 skill:upload |
| POST | /v1/skills/:skillId/publish | 发布 Skill(暂不可用) | ⛔ 禁用 |
| POST | /v1/skills/:skillId/deprecate | 下线 Skill(暂不可用) | ⛔ 禁用 |
请求示例
curl -X POST /v1/skills \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"name":"My Skill","slug":"my-skill"}'