本地技能与旧名称检索

只在用户寻找或安装技能时使用。先从用户问题提取平台、任务和只读/写入要求，再检索本地目录；不绑定任何远程技能市场。

使用方式

运行随包脚本，路径相对本 Skill：

python3 scripts/find_skills.py 'Amazon 广告报表' --limit 5

默认扫描当前 Skill 的同级目录，并读取各包内的能力索引；不依赖父目录 catalog.json。需要检索其他安装位置时显式指定 --root /path/to/skills；不会扫描用户主目录或发起网络请求。

1. 阅读匹配项的 SKILL.md 和所需工具路由，核对它是否确实处理目标平台、实体和动作。
2. 向用户展示名称、用途、路径和限制。词面匹配分数只表示搜索相关性，不表示技能质量或在线能力已验证。
3. 已有具体业务任务时直接加载最合适的技能继续工作，避免把普通运营请求改成安装任务。
4. 用户授权安装某项时，明确目标 Agent 的技能目录并复制完整 Skill 文件夹，保留 agents/、references/ 与 scripts/。目标已有同名目录时先比较差异、保留备份，不默默覆盖。
5. 安装后核对目录名、frontmatter 名称和相对引用一致；宿主需要重新加载时说明具体加载边界。

没有结果时先调整同义词或搜索明确的另一处本地目录。用户需要在线寻找新技能时，才使用已授权的通用技能发现工具或公开来源；下载文件先检查适用范围、许可证和执行依赖。

交付

匹配技能、适用理由、实际路径、依赖与限制。安装动作另列复制位置、检查结果和宿主是否已加载。

参见 执行手册 和 工具路由。

合并后的搜索结果

结果以业务入口去重；matched_capabilities 列出匹配的细分模式、原名称和可直接读取的 guide_path。先读该模式，再按需读取其执行手册与工具路由，不预读整个入口的全部参考文件。

旧名称也可直接搜索，例如：

python3 scripts/find_skills.py '$sealeap-athena-temu-eu-product' --limit 1

这个查询会定位到 Temu 商品与价格管理入口，并返回欧洲区商品管理的具体参考文件。旧名称不再对应独立目录；它是本地搜索兼容别名，宿主不会因此自动识别已删除的旧 Skill 路径。