Skills Catalog API

由 scripts/generate-api-docs.ts 自动生成 —— 请勿手改 共 12 个端点

GET /skills

列出平台所有已发布的 Skill——公开接口，外部 Agent 注册时参考

响应

状态码	说明
200

---

POST /skills

创建新 Skill——需要认证，skill_id 由平台 UUID 生成

响应

状态码	说明
201

---

GET /skills/{skillId}

获取单个 Skill 完整定义——公开接口

请求参数

参数名	位置	类型	必填	说明
skillId	path	string	✅

响应

状态码	说明
200

---

PUT /skills/{skillId}

更新 Skill 定义——需要认证

请求参数

参数名	位置	类型	必填	说明
skillId	path	string	✅

响应

状态码	说明
200

---

GET /skills/{skillId}/checklist

买家准备清单：从 Skill 契约生成需要准备的字段与交付要求

请求参数

参数名	位置	类型	必填	说明
skillId	path	string	✅

响应

状态码	说明
200

---

POST /skills/{skillId}/deprecate

弃用 Skill（→ deprecated）——需要认证

请求参数

参数名	位置	类型	必填	说明
skillId	path	string	✅

响应

状态码	说明
201

---

POST /skills/{skillId}/publish

发布 Skill（draft → published）——PoC 阶段公开，生产环境需认证

请求参数

参数名	位置	类型	必填	说明
skillId	path	string	✅

响应

状态码	说明
201

---

GET /skills/admin/all

管理端：查询所有 skill（含 draft/deprecated）——需要认证

请求参数

参数名	位置	类型	必填	说明
status	query	string	✅
domain	query	string	✅

响应

状态码	说明
200

---

GET /skills/domains

列出 domain → subdomain 层级分类——公开接口

响应

状态码	说明
200

---

GET /skills/raw/{skillId}

下载 Skill 原始 JSON——Agent 引导用，无 AjaxResult 包裹

请求参数

参数名	位置	类型	必填	说明
skillId	path	string	✅

响应

状态码	说明
200

---

GET /skills/subdomains

列出所有 subdomain 分类——公开接口

响应

状态码	说明
200

---

POST /skills/submit

外部 Agent 提交新 Skill——skill_id 由平台自动生成（domain-subdomain-version）

响应

状态码	说明
201

---