Skill搜索安装助手

解决的问题

SkillHub 推荐市场里的 skill、专家与 MCP 连接器数量持续增长，工程师很容易踩到三类坑：

• 找不到：不知道当前任务该配哪个 skill，面对全量列表无从下手
• 分不清：免费 skill 与消耗积分的 skill 混在一起，装完才发现扣了积分
• 装重复：已经装过的同类能力再次被推荐，整轮对话等于白费

核心机制

这个助手不做推销，它做的是上下文感知的匹配——把用户当前的任务或职业画像，映射成具体的能力组合。

1. 画像分析

支持三种输入模式：

• 任务驱动：从描述中提取意图（如「做 PPT」「数据分析」），查询 references/task_capability_matrix.md 的任务-能力映射表
• 职业驱动：按自述角色（如律师、财务）匹配常用能力组合
• 混合模式：任务为 primary，职业为 secondary，交叉匹配

2. 已装能力盘点

推荐前先检查三处：

• ~/.workbuddy/skills/ 与项目 .workbuddy/skills/ 目录下的已装 skill
• 当前会话 connector-status 中已连接的 MCP 连接器
• 已加载的专家包

已有能力标记为「已有」，检测到新版本时标注「可更新」，避免重复推荐。

3. 市场搜索与成本过滤

统一通过内置的 workbuddy_marketplace_skill 工具完成：

• 先用 ToolSearch 加载工具 schema，再调用 search action
• 分别用任务关键词、职业关键词、功能描述搜索，合并去重后统一处理
• 结果按 免费 → 未知 → 收费 排序；对每个收费 skill 检查是否存在功能相近的免费替代，没有则标注「无免费替代，预计消耗 X 积分」

4. 三位一体推荐

输出分三个板块：Skill（市场推荐）、Expert（专家中心）、Connector（MCP 连接器）。未连接的 connector 附带简要配置引导，参见 references/cost_optimization_guide.md。

5. 安装导引

需用户明确确认后才调用 install action；成功后只反馈安装位置与版本，不自动启用。

适用边界与注意点

• 只能通过 workbuddy_marketplace_skill 操作市场，禁止自行构造 HTTP 请求访问 SkillHub
• skillId 必须从搜索结果获取，禁止伪造或猜测，也不在推荐内容中向用户暴露
• 推荐不等于安装决定：所有安装操作都要用户确认；装完后 skill 保持未启用状态，由用户自行启用
• 收费 skill 必须标注积分消耗，或提示「费用未知，安装前请确认」