AI工具导航（实时版 v2）
> 你说模糊的场景，我帮你理清 → 实时找 SkillHub 上合适的工具 → 告诉你怎么装、怎么用、有什么坑。
触发词
当用户说以下任意一句时，立即加载此 skill：
- "帮我找个 skill 做 XXX"
- "有什么工具可以 XXX"
- "网上有人黑我店"
- "周报写不出来"
- "差评太多不知道怎么回"
- "数据看不懂"
- "帮我搜个能 XXX 的 skill"
核心定位
不是"SkillHub 的复制品"，而是泛 AI 学习者的小白导购：
- 场景翻译：用户说"网上有人黑我店"（模糊）→ 识别为【差评/舆情处理】场景
- 实时聚合：调用 SkillHub 公开 API，跨分类检索，不存静态数据
- 最后一公里：推荐了工具，还告诉你 WorkBuddy 怎么装、说什么话触发、出错了怎么办
- 风险透明：需不需要 API Key、是否付费、操作真实账号有没有风险，一目了然
与不做的边界
| 我们做 | 我们不做 |
|---|---|
| 场景理解 + 中文扩展 | 重写 SkillHub（它自己有搜索） |
| 最后一公里（安装/调用/坑） | 替用户安装（只给命令） |
| 风险提示（API/费用/安全） | 质量评测（SkillHub TRACE 已做） |
| 泛 AI 学习者语言 | 开发者术语（"CI/CD"、"TDD"） |
为什么做这个
用户找 skill 时经常说不清场景，用标准关键词搜索往往找不到合适工具。本 skill 通过三层转换解决问题：
- 场景翻译：把模糊口语（"网上有人黑我店"）翻成精准关键词（"差评/评价/回复"）
- 最后一公里：推荐了工具，还告诉你怎么装、怎么说触发词、出错了怎么办
- 风险透明：要不要 API Key、是否付费、操作真实账号有没有风险
这样无论用户描述多么口语化，都能找到合适的工具并安全使用。
使用流程
用户输入模糊场景
↓
[场景理解] 提取意图 + 领域标签 + 中英文扩展词（2-4组）
↓
[实时搜索] 多次调用 SkillHub API，合并去重
↓
[意图排序] 契合度优先，同档按 score/downloads 降序
↓
[输出推荐] 表格：工具名 / 匹配理由 / 最后一公里 / 风险提示
↓
[用户确认] 选定后给安装命令 + 调用示例
> 渐进式加载：
> - 当需要搜索 skill 时，加载 scripts/search_realtime.py 执行实时搜索
> - 当需要理解 API 参数时，加载 references/api.md 查看 SkillHub API 文档
> - 当需要参考案例时，加载 references/cases/ 目录下的真实案例
> - scripts/match_scenario.py 为 MVP 离线版 fallback（无网时使用）
如何使用
命令行直接测试
# 基本用法：传入模糊场景描述
python scripts/search_realtime.py "网上有人黑我店"
python scripts/search_realtime.py "周报写不出来"
python scripts/search_realtime.py "差评太多不知道怎么回"
# 指定关键词搜索
python scripts/search_realtime.py --keyword 差评 评价 回复
# 指定分类搜索
python scripts/search_realtime.py --category business-ops --keyword 客服
# 自我审查（检查当前skill质量）
python scripts/search_realtime.py --review
作为 skill 触发
对 AI 说：
- "帮我找个能回复差评的 skill"
- "有什么工具可以写周报"
- "搜一下能 XXX 的 skill"
AI 会自动调用 search_realtime.py 并返回推荐结果。
文件结构
ai-tool-finder/
├── SKILL.md ← 本文件，skill 定义
├── README.md ← 人类可读概述
├── scripts/
│ ├── search_realtime.py ← 实时搜索主脚本（v2.2.1）
│ ├── match_scenario.py ← MVP 离线版 fallback
│ └── review_wrapper.py ← skill-reviewer 调用封装
├── references/
│ ├── api.md ← SkillHub API 文档
│ ├── scenarios.yaml ← 场景→关键词映射表
│ ├── tools-map.yaml ← 工具清单
│ ├── sources.yaml ← 数据源配置
│ ├── reviewers/ ← 评审器（skill-reviewer）
│ └── cases/ ← 真实案例（餐饮/零售/服务/通用）
└── memory/ ← 工作区记忆（本地）
输出格式
| 维度 | 内容 |
|---|---|
| 工具名 | slug（SkillHub 唯一标识） |
| 匹配理由 | 为什么推荐这个（基于 description 契合度） |
| 最后一公里·安装 | WorkBuddy：专家→技能→搜"名字" / 或 skillhub install <slug> |
| 最后一公里·调用 | 对用户说什么话触发（如"帮我回复这条差评：XXX"） |
| 最后一公里·常见坑 | 出错怎么办（如"敏感词会触发人工审核"） |
| 风险提示·API | 是否需要 API Key（来自 labels.requires_api_key） |
| 风险提示·费用 | 免费 / 订阅 / 按量（SkillHub 平台标注） |
| 风险提示·安全 | 低（纯文本）/ 中（控制浏览器）/ 高（操作真实账号） |
| 质量信号 | score / downloads / verified（来自 API） |
数据源
- 主数据源：SkillHub 公开 API
https://api.skillhub.cn/api/skills（国内可用、无需鉴权、实时） - 质量信号：SkillHub TRACE 评测 + score/downloads/verified
- 参考：SkillHub 官方
find-skill-skillhub技能的逻辑（场景理解+语义扩展+排序）
详见 references/api.md。
场景覆盖（意图理解的参考映射）
scenarios.yaml 不再作为静态数据源，而是意图理解的"场景→关键词"参考表，
帮助把模糊描述映射到 SkillHub 的 category + 扩展词。
通用场景（泛 AI 学习者）
- 办公效率：周报/文档/PPT/会议纪要/邮件
- 内容创作：写作/视频脚本/设计/种草
- 数据分析：报表/可视化/预测/用户分析
- 商业运营：客服/电商/评价/营销/私域
- 开发工具：代码/调试/测试/自动化
- 生活效率：日程/记账/学习/健康
餐饮示例（作为案例，非局限）
- 差评回复 / 新菜推广 / 日报分析 / 排班优化
下一步
- ✅ 实时搜索脚本：
scripts/search_realtime.py（已实装） - ✅ 模糊场景测试："网上有人黑我店"→差评/评价/回复，返回3个相关 skill
- ✅ 质量评审：
python scripts/search_realtime.py --review→ 97分 A级 - 📝 用户反馈闭环：收集"推荐不准/不好用"案例，反哺扩展词表
- 📝 开源迭代：GitHub 发布（待确认）
