| name | add_skill |
| description | 为用户安装技能。通过 skill_name 绑定已有技能,或通过 url 传入 .zip / skill.md 链接自动注册技能。 |
| version | 0.0.3 |
| author | qqai |
| user-invocable | false |
| disable-model-invocation | false |
| tags | ["skill","install","add","bind","url","upload","zip"] |
| trigger-phrases | ["安装技能","添加技能","给我开通技能","帮我绑定技能","通过链接安装技能"] |
| timeout | 30s |
add_skill
安装或绑定技能到用户账号。支持两种方式:
- skill_name — 直接绑定已有技能
- url — 传入
.zip 或 skill.md 的下载链接,服务端自动解析并注册
两个参数至少提供一个,url 非空时优先使用 URL 模式(skill_name 可省略)。
无需预先读取或校验 URL 内容,直接传入即可,服务端会自行校验并返回错误信息。
调用方式
必须通过 exec 调用。
按名称安装
exec("add_skill --parameters '{\"skill_name\": \"code_review\"}'")
按 URL 安装
exec("add_skill --parameters '{\"url\": \"http://example.com/xxx/my_skill.zip\"}'")
exec("add_skill --parameters '{\"url\": \"http://example.com/xxx/skill.md\"}'")
parameters
| 字段 | 类型 | 说明 |
|---|
skill_name / skillName / skill | string | 要安装的技能名称,二选一 |
url | string | 技能资源下载链接(.zip 或 .md),二选一 |
成功响应
{ "status": "SUCCESS", "result": { "result": "success" } }
失败处理
失败时返回 Status_FAILED,ErrorCode 为 1,ErrorMessage 包含具体原因(参数缺失、URL 不可访问、zip 格式错误、skill.md 缺少元信息等)。按 error_message 提示用户即可。
协作流程
- 若用户给了技能名 → 直接用
skill_name 调用
- 若用户给了链接 → 直接用
url 调用,不需要先读取链接内容
- 若不确定技能名 → 先调用
find_skills 搜索,再用返回的 skill_id 安装