3 · 第一个 Skill

Skill 是 VOLO AI 的能力扩展单元——给 AI 装上专业能力（前端设计、代码审查、市场调研等）。

---

3.1 什么是 Skill

Skill = 可挂载到 AI 的专业能力包，由 markdown + JSON 描述。AI 在对话中识别到 /skill-name 触发符时，会按 Skill 定义的协议执行专业流程。

特性	说明
安装/卸载	用户级，按需挂载
触发方式	对话中输入 /skill-name 或自动路由
内置 + 自定义	平台预装 + 用户上传
计费	部分 Skill 按调用收费，控制台标注

---

3.2 浏览 Skill 市场

调用 Skill 列表 API:

curl -X GET "https://api.volo.ai/api/skills?page=0&pageSize=10" \
  -H "Authorization: Bearer $VOLO_API_KEY"

返回（节选）：

{
  "code": 200,
  "data": {
    "items": [
      {
        "id": "uuid-...",
        "name": "h-frontend-design",
        "displayName": "前端设计大师",
        "description": "创建独特的、生产级的前端界面",
        "category": "frontend",
        "installed": false
      },
      {
        "id": "uuid-...",
        "name": "h-critique",
        "displayName": "设计评论家",
        "description": "从 UX 视角评估设计效果",
        "category": "design",
        "installed": false
      }
    ],
    "total": 67,
    "hasMore": true
  }
}

---

3.3 安装 Skill

挑一个你感兴趣的 Skill，比如 h-frontend-design：

curl -X POST "https://api.volo.ai/api/skills/{skillId}/install" \
  -H "Authorization: Bearer $VOLO_API_KEY"

返回 {"code":200,"data":true} 即安装成功。

---

3.4 在对话中触发 Skill

VOLO AI 命令系统支持三个触发符：

符号	用途	示例
/	触发 Skill	/h-frontend-design 帮我设计一个登录页
#	触发系统命令	#clear 清空当前 session
@	引用云盘文件	@根目录/产品需求.md 注入文件作为上下文

发起一次带 Skill 的对话：

curl -N -X POST "https://api.volo.ai/api/agent/chat/volo-ai/$SESSION_ID/intent" \
  -H "Authorization: Bearer $VOLO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "userMessage": "/h-frontend-design 帮我设计一个极简的登录页，黑金风格",
    "executionMode": "MAX"
  }'

SSE 流中将出现：

event: COMMAND_START
data: {"commandKind":"skill","skillName":"h-frontend-design",...}

event: ASSISTANT_DELTA
data: {"content":"好的，让我以原研哉的克制美学..."}

event: RENDER_UI
data: {"uiComponentType":"design-board",...}

event: COMMAND_END
data: {"commandKind":"skill",...}

---

3.5 查看你已安装的 Skill

curl -X GET "https://api.volo.ai/api/skills/my?page=0&pageSize=20" \
  -H "Authorization: Bearer $VOLO_API_KEY"

---

3.6 卸载 Skill

curl -X DELETE "https://api.volo.ai/api/skills/{skillId}/install" \
  -H "Authorization: Bearer $VOLO_API_KEY"

---

推荐 Skill 试驾清单

Skill	适合
h-frontend-design	你是前端 / 设计师
h-critique	你在做 UX review
pm-write-prd	你是产品经理
gen-design-img2img-refine	你想用 AI 精修设计稿
systematic-debugging	你在追一个棘手的 bug

完整 Skill 索引见控制台 Skill Market。

---

完成了 🎉

至此你已经：

• ✓ 注册账号并获得 API Key
• ✓ 完成第一次 SSE 流式对话
• ✓ 安装并触发了第一个 Skill

下一步可以选：

• API Reference — 浏览全部端点
• SDK · TypeScript — 在生产代码中集成 VOLO AI
• Help · FAQ — 看看别人常踩的坑