marketplace-skill-installer

Marketplace Skill Installer

帮助用户用一句话从 Sztubuddy 推荐市场（BuiltinMarket）安装 Skill。

When to Use

只要用户表达"安装某个技能/skill"的意图就用此 Skill，例如：

• 「帮我安装飞书套件」
• 「安装一个 lark-unified 的 skill」
• 「我想用 X 技能，帮我装下」
• 「install Y skill」

严格的工具调用约束

• 禁止直接构造任何 HTTP 请求，禁止涉及 token/cookie/Authorization。
• 只能通过 Sztubuddy_marketplace_skill 这个内置工具完成全部操作；鉴权和后端调用由宿主处理。
• 禁止伪造或猜测 skillId——必须从 search 结果中拿到。

Workflow

Step 1：识别关键字

从用户输入中抽取一个搜索 keyword：

• 如果用户说了显示名（例："飞书套件"），用显示名；
• 如果用户说了技术名（例："lark-unified"），用技术名；
• 既没说显示名也没说技术名（仅说"装个 skill"）→ 礼貌追问"想安装哪个技能？可以告诉我名字或关键字"。

Step 2：搜索

调用 Sztubuddy_marketplace_skill，action 为 search：

{ "action": "search", "keyword": "飞书套件", "limit": 5 }

limit 一般保持默认 5，必要时可上调到 10–20。

返回字段说明：

• success: false → 把 error 透传给用户，停下；
• results: []（空数组）→ 告诉用户"未在推荐市场找到匹配的 skill"，停下；
• results.length === 1 → 直接进入 Step 3；
• results.length >= 2 → 进入 Step 4 让用户挑。

Step 3：单一命中

逻辑分支（r = results[0]）：

• 未安装（r.installed === false）→ 直接调 install：

  { "action": "install", "skillId": "<r.skillId>" }
  

• 已安装且已是最新（r.installed === true && r.updateAvailable === false）→ 告诉用户"该 Skill 已是最新版本 v<r.version>，无需重复安装"，停下；
• 已安装且有新版（r.installed === true && r.updateAvailable === true）→ 询问用户"已安装 v<r.installedVersion>，最新版本是 v<r.version>，是否更新？"。用户同意后再调 install。

⚠️ 不要自己用字符串相等判断版本新旧；updateAvailable 字段已用 semver 计算好。

Step 4：多命中

把 results 列出来让用户选。展示时只展示 name、version、description 的前 60 字、是否 installed。不要把 skillId 透露给用户——那是机器内部 id。例：

找到了多个相关 Skill，请选择要安装的：
1. 飞书套件 v1.2.0 — 集成飞书文档/会议/审批  ✅ 已安装 v1.1.0
2. 飞书文档助手 v0.9.1 — 智能写作与摘要
3. 飞书会议助手 v0.5.0 — 自动纪要

用户选定后取对应 results[i].skillId，按 Step 3 的分支处理。

Step 5：调用 install 后

Sztubuddy_marketplace_skill 的 install action 返回：

• success: true → 用 message 告诉用户安装到了哪里、版本是什么；可附一句"在【技能管理】面板里能看到它"。不要手动构造路径——直接用 message 字段。
• success: false → 把 error 透传，并按错误类型给提示（见下表）。