Skill Finder, 从 Meyo 社区搜索、推荐、安装最适合用户任务的 skill

📦 安装后首次加载（宿主 Agent 必执行）

无论通过 install 脚本 / skillhub / 手工 zip 解压 / git clone 哪种方式把本 skill 装入 skills 目录，宿主 Agent 在确认安装成功后必须立即执行（这是安装流程的一部分，不是可选项）：

{python} {skill_dir}/scripts/deep_skill_search.py --first-run-check

• 返回 {"should_invite": true} → 渲染规则 8 的完整配置卡（一步到位，不预告）。位置硬约束：配置卡必须是本轮所有工具调用之后输出的唯一用户可见文本，卡后不得再有任何工具调用或文字，否则会被宿主折叠进过程信息，详见规则 8「配置卡输出硬约束」
• 返回 {"should_invite": false} → 静默跳过

守卫标记存于 skill 目录内 .first_run_invited：重装/重新解压会重新邀请，git pull 升级不会重复。若宿主未执行本钩子（安装器不读 SKILL.md、或把安装包当附件数据看待），邀请会在第一次使用本 skill 搜索时随搜索输出自带的 first_run_invite 信号自动补上（见 Step 1.3 规则 0）, , 整条触发链不依赖任何额外命令。

工作流（5 步）

Step 0: 版本检查（每次使用本 skill 前必执行）

1. 读取当前 SKILL.md frontmatter 中的 version 字段，记为 {current_version}
2. 调用版本检查接口获取远程最新版本号：

   {python} {skill_dir}/scripts/deep_skill_search.py --check-version
   

   若脚本不支持 --check-version，改用以下方式直接读取远程 SKILL.md frontmatter：

   curl -s "https://api.github.com/repos/wheelry/deep-skill-finder/contents/SKILL.md" -H "Accept: application/vnd.github.v3+json" | {python} -c "import sys,json,base64,re; d=json.load(sys.stdin); c=base64.b64decode(d['content']).decode(); m=re.search(r'version:\s*\"([^\"]+)\"', c); print(m.group(1) if m else 'unknown')"
   

3. 比较版本：
   • {current_version} < 远程最新版本 → 提示用户：

     发现 deep-skill-finder 有新版本（当前 {current_version}，最新 {latest_version}），建议更新以获得最新功能和修复。要现在更新吗？

     • 用户同意 → 从 GitHub 拉取最新 SKILL.md 和 scripts/ 覆盖本地文件，然后继续执行
     • 用户拒绝 → 继续执行（API 调用仍会携带版本标识 skillVersion={current_version}）
   • {current_version} >= 远程最新版本 → 正常继续
4. 后续所有搜索/下载 API 请求会自动携带 skillVersion={current_version} 参数（脚本已内置），服务端可用于版本统计和兼容性处理

注意：如果网络环境无法访问 GitHub，版本检查会超时或失败，此时直接使用本地版本继续即可，不影响核心功能。

Step 0.5: 首次加载自检（每次使用本 skill 前必执行，紧跟 Step 0 一起完成）

{python} {skill_dir}/scripts/deep_skill_search.py --first-run-check