用途:Check Version 用于比较本地已安装插件版本与 GitHub 上的远端版本,确认当前 skills 和 agents 是否为最新,适合在会话开始时、技能行为与文档不符时、用户询问更新时,或在给出 agent 能力建议前使用。
主要能力:通过运行脚本检查版本,约 70 毫秒内返回 JSON 结果,字段包括 plugin、org、local_version、remote_version、status 和 message。status 取值及含义:current 表示本地与 GitHub 一致;outdated 表示 GitHub 上有更新,建议用户执行 message 字段中的更新命令;ahead 表示本地比远端新,适用于开发环境;not_installed 表示缓存中未找到该插件;check_failed 表示无法访问 GitHub,属网络问题,不关键,可继续工作。
使用方式:在技能路径下执行 bash <skill-path>/scripts/check-version.sh,脚本会输出上述 JSON。若状态为 outdated,应告知用户并建议更新命令,但不要阻塞工作,仍按已安装版本继续。
适用场景:会话开始时确认使用最新 agents/skills;技能行为与文档描述不一致时排查;用户主动询问更新时;在基于 agent 能力给出建议前,避免因版本过旧产生误导。
限制:该检查依赖访问 GitHub,网络不可达时会返回 check_failed;版本信息来自缓存与远端对比,具体缓存路径、更新命令的可用性以实际环境为准,资料暂未提供更多细节。