用途:Skill Updater 是已安装智能体技能的更新与分发闭环。技能以文件夹副本形式安装(全局 ~/.agents/skills/,项目 <repo>/.agents/skills/),并在对应的 .claude/skills/ 目录建立符号链接,因此直接编辑或拉取库仓库不会更新任何已安装副本,此工具用于弥合这一差距。
主要能力:找出作用域内每个安装;判断哪些技能已过期;生成报告;在获得批准后通过正确机制更新。支持 global、project、fleet(批量仓库)三种作用域,默认 global 加当前仓库(若其有安装)。可列出状态:in-sync、drifted、untracked-external、direct-copy、external-link、broken-link,并标记缺失或损坏的 .claude 链接。
两种更新路径:CLI 路径使用 npx skills check / npx skills update,针对 .agents/.skill-lock.json 跟踪的技能,比对记录的 git tree hash 与 GitHub,仅能看到已推送内容,是外部来源技能的唯允许路径。本地同步路径使用 scripts/skill_update_scan.py sync,将库检出副本覆盖已安装副本并修复 .claude/skills 符号链接,适用于未跟踪安装及本地库领先 GitHub 的情况,不重写锁文件,并拒绝不在库中的技能。
使用方式:先确定作用域与库检出位置,检查库新鲜度(git status、fetch、rev-list);运行 scan 脚本盘点与漂移扫描;对锁跟踪技能运行 CLI check;在操作前给出汇总表;进入批准门后应用更新;最后重新扫描并输出摘要。fleet 模式需先与用户确认根文件夹再扫描。
限制:不安装新技能(应使用 find-skills / npx skills add);不编辑技能内容,仅以库当前版本替换已安装副本;不手改 .skill-lock.json(由 CLI 掌管);永不通过本地同步更新外部来源技能;没有批准门不应用变更,check 模式不变更任何内容。fleet 扫描最多下探 3 层目录并裁剪 node_modules、.git、构建目录和虚拟环境,更深安装需用 --project 显式传入;.claude/skills 指向 .agents/skills 之外的插件符号链接报告为 external-link 且从不修改。具体收费、价格、平台信息暂未提供。