技能系统

技能（Skill）是用户可以创建和分享的可复用指令模板，AI 角色可以在对话中调用。

端点列表

方法	路径	说明
GET	/api/v1/skills	技能列表（支持 scope=own/public/all）
POST	/api/v1/skills	创建技能
GET	/api/v1/skills/{id}	技能详情
PATCH	/api/v1/skills/{id}	更新技能
DELETE	/api/v1/skills/{id}	删除技能

技能响应示例

{
  "id": "b2c3d4e5-...",
  "created_at": "2026-03-10T10:00:00Z",
  "title": "邮件写作助手",
  "description": "根据要点自动生成专业邮件",
  "content": "请根据以下要点撰写一封专业邮件：...",
  "visibility": "private",
  "created_by_id": "550e8400-..."
}

测试要点

测试建议

1. 公开/私有：私有技能仅创建者可见；公开后其他用户可通过 scope=public 查询
2. 创建配额：技能数量有配额限制
3. 内容长度：验证 content 字段的最大长度限制
4. AI 调用：当 AI 角色配置了 SkillReaderFunction 工具时，可在对话中读取用户的技能内容