crane-in-clear-sky/workwit-ai-agent/marketplace-skill-installer

⚠️ 环境适配：本技能面向 WorkBuddy 技能推荐市场（BuiltinMarket），当前系统的技能广场即对应能力——技能创建用元工具 create_skill，技能浏览用 list_skills。

Marketplace Skill Installer

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

When to Use

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

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

严格的工具调用约束

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

Workflow

Step 1：识别关键字

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

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

Step 2：搜索

调用 workbuddy_marketplace_skill，action 为 search：

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：
• 已安装且已是最新（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。例：

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

Step 5：调用 install 后

workbuddy_marketplace_skill 的 install action 返回：

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

常见错误透传

重要规则

• 鉴权全部由宿主处理，不要让用户提供 token / cookie / 任何 header。
• 不要主动列举所有可用的 skill——只在用户明确想看时才用 search 拉。
• 安装成功后不要自我开启该 Skill，也不要尝试直接调用它的工具——让用户自己启用。
• 除了上述工具，本 Skill 不应触发 Bash、文件写入或网络请求。