南山技能定期跟踪
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_924b0a5e/yrns-skill-version-tracker。
技能介绍
解决什么问题
技能装得多了之后,版本管理会变成一笔糊涂账:某个技能有没有上游仓库、本地跑的是哪个版本、远程是否已发布新版 SKILL.md,这些问题平时没人管,等出问题才逐个翻目录查。更麻烦的是,多数技能的 frontmatter 里根本没有 source_url 字段,只看本地文件无法判断来源和维护者,也就谈不上跟踪更新。
这个技能的思路是:第一次全量造册,后续只查差异——把排查成本从 O(n) 降到 O(1)。首次运行时扫描机器上所有技能并写入登记册 registry.json,之后每次排查只对已登记技能做远程版本比对,不再重复扫描目录。
核心工作流
三种排查模式。 依据登记册是否存在、是否指定技能名,自动进入全量排查、增量排查或定向排查。
动态目录扫描。 扫描脚本不硬编码任何机器路径,运行时动态发现三类安装位置:
- 用户级:
~/.workbuddy/skills/ - 项目级:当前工作目录下的
.workbuddy/skills/ - 内置技能:自动探测 WorkBuddy 安装路径,跨 Win/macOS/Linux 兼容
脚本提取 name、local_version、scope 等字段,输出 JSON 数组供后续处理。
多渠道来源识别。 对 source_url 为空的技能按优先级依次尝试:SKILL.md 正文 URL → 技能内脚本 → Anthropic 官方仓库 → skills.sh / SkillsMP / SkillHub 搜索 → WorkBuddy 市场 → Web 搜索兜底,尽量压低 unknown 数量。
增量差异检查。 按来源类型分发:GitHub / Gitee / GitLab 提取 raw URL 的 version 字段;skills.sh 等平台最终指向 GitHub,回退到 GitHub raw URL;marketplace 走市场搜索接口。状态分为 up-to-date、update-available、check-failed。
不擅自更新。 发现更新后逐一询问用户,更新前检查 user_modified 标记,有本地改动先警告再覆盖;也可设置定时任务每周自动执行增量检查。
适用边界
- 登记册是唯一真相源,所有排查结果必须写入
data/registry.json,不能只停留在对话里。 - 内置技能跳过,随 WorkBuddy 更新,不需要单独跟踪。
- 失败要记录,远程检查失败时把原因写入 notes,不静默跳过。
- 不负责这些事:单个技能功能排障用对应技能的 troubleshooting,创建新技能用 skill creator,安装卸载用市场安装工具。
使用场景
- 例行检查本机已安装技能是否有新版本发布
- 技能 frontmatter 缺失 source_url 时从多平台回查来源
- 把每周增量排查设为定时任务自动发现更新
- 盘点用户级、项目级与内置三类目录下的完整技能清单
适合人员
- 维护多个自制 Agent 技能的开发者,需要确认本地版本未落后于上游
- 管理团队技能资产的技术负责人,定期核对来源与更新状态
- 配置 WorkBuddy 定时任务的工程师,希望自动排查技能版本
- 部署多项目共享技能环境的团队,需要统一盘点各项目安装的技能