用途
course-skill-update-checker 负责维护 Course-Agent-Skills 技能包中全部 15 个智能体技能的版本一致性,使其始终对应 GitHub 上的官方发布版本。它解决的是技能包在本地使用过程中逐渐落后于上游发布的问题。
主要能力
- 读取本地版本:从 plugin.json 的 version 字段获取当前本地版本(例如 v1.0.0)。
- 检查远程版本:通过 GitHub API 的 releases/latest 接口或 plugin.json 获取远程最新版本(例如 v1.1.0)。
- 语义化版本评估:按 SemVer 规则判断远程版本是否高于本地版本。若远程不高于本地,则显示“所有技能均已是最新版本”;若远程更高,则展示 Changelog / What's New,并询问用户是否立即更新。
- 执行更新:在用户同意后,提供两种更新方式——全局 NPX 方式(推荐):npx --yes skills add -g https://github.com/lensetek/Course-Agent-Skills -y;Git Pull 方式(适用于本地仓库):git fetch origin && git pull origin main。
安全与凭据保护策略
- 被动且安全的检查:仅读取来自 https://api.github.com/repos/lensetek/Course-Agent-Skills/releases/latest 的公开元数据或 plugin.json 文件。
- 不向互联网发送令牌、API 密钥、内部配置或学生成绩数据。
- 用户确认门(User-Confirmation Gate):智能体不得在未经明确同意的情况下静默更新或覆盖用户的本地自定义文件。
使用方式
检查流程为:读取本地版本 → 检查远程版本 → 评估 SemVer → 若无需更新则提示已是最新;若需要更新则展示更新摘要并询问“是否现在更新?[Y/N]”。用户确认后按上述 NPX 或 Git Pull 方式执行更新。
适用场景
适用于使用 Course-Agent-Skills 技能包并希望保持其与官方发布同步的用户,尤其适合需要在不破坏本地自定义内容的前提下安全获取新版本功能的场景。
限制
资料未提供该技能对非 GitHub 来源、离线环境或私有仓库的支持说明;也未提供版本号格式异常、网络请求失败等边界情况的处理细节。