用途:刷新通过 skills CLI 安装的智能体技能,保持项目技能为最新,并处理项目范围内更新未检测到上游变更的情况。
主要能力:先执行标准更新命令 npx skills update;区分项目范围与全局安装(项目范围通常有本地 skills-lock.json 及 .agents/skills/、.claude/skills/、.augment/skills/ 等目录,全局锁文件如 ~/.agents/.skill-lock.json 或 $XDG_STATE_HOME/skills/.skill-lock.json);以 skills-lock.json 或全局锁文件为已跟踪技能的唯一依据,不假定手动复制的技能被跟踪。
使用方式:全局安装且 npx skills update 成功即可结束;项目范围若明确报告已更新则结束;若报告 All skills are up to date 或无变更,则进入回退流程。回退时优先使用技能目录内自带的脚本 scripts/reinstall_project_skills_from_lock.sh(按 .agents/skills、.claude/skills、.augment/skills 顺序查找,可执行则运行 --project-root .),脚本会读取锁文件、按仓库批量重装并使用 -y 非交互。若脚本不可用,则手动按仓库分组重装:npx skills add [repository] --skill [skill1] [skill2] ... -y;sourceType 为 github 且 source 记为 owner/repo 时,转换为 https://github.com/owner/repo。交互提示时,Agent 选默认、Scope 选 Project、安装方式选 Symlink。
适用场景:项目或全局技能刷新、技能过期排查、锁文件与已安装目录不一致时的修复。
限制:不得仅凭目录存在判断成功;不得用广泛 find/rg 搜索脚本;不要为查参数而阅读 CLI 源码;完成前需确认技能内容已更新且与来源、名称一致,并说明是标准更新还是回退重装、刷新了哪些技能及来源、更新范围是项目还是全局。资料未提供具体版本、收费或平台信息。