用途:check-updates 是一个只读更新检查器,用于识别提供该技能的安装来源,将其版本与仓库 main 分支比较,并展示当前智能体宿主所支持的更新路径。它从不自动更新。
主要能力:区分自动调用与显式调用。其他 Fabric 技能在每个会话开始时自动调用它一次;自动调用对每个安装身份每 7 天最多执行一次远程查询。用户直接询问版本、变更日志或更新检查时属于显式调用,会绕过 7 天网络限制。无论检查被跳过还是失败,自动调用后都继续调用者的原任务。
安装上下文:解析候选安装根目录,区分 plugin、git clone、copy、unknown 四种通道,并独立解析运行时宿主(copilot-cli、claude-code、cursor、windsurf、codex、other、unknown)。插件通道读取插件清单的 name、version、repository;Git 通道要求 package.json、直接 .git 以及 skills-for-fabric 身份。
网络限制与缓存:使用 ~/.config/fabric-collection/last-update-check.json(Windows 为 $env:USERPROFILE.config\fabric-collection\last-update-check.json),以安装身份为键记录 UTC 日期。
远程版本读取顺序:Git CLI、已认证的 GitHub 工具、公开 raw 内容,均读取 main 引用下的 package.json 与 CHANGELOG.md,不使用最新 GitHub Release 标签。
更新指引:插件通道按宿主给出命令。GitHub Copilot CLI 市场安装为 /plugin update <installed-name>@<marketplace>,直接安装为 /plugin update <manifest-name>;Claude Code 为 claude plugin update <installed-name>@<marketplace> --scope <scope>,之后运行 /reload-plugins 或重启;Cursor 指向 Customize > Plugins;其他宿主只报告版本和仓库,不提供可执行插件命令。Git 通道使用 git -C "<detected-root>" pull --ff-only。unknown 通道不提供更新命令。复制的散装技能需用户确认来源后才能给出替代安装路径。
限制:绝不自动更新;不猜测安装身份、作用域或宿主;不复制尚未提供的事实。