历史版本与核实范围
引用固定历史提交12c48de9d36ef839713792a440c651e22630b770中的完整主指南。2026-10-18 UTC核对精确文件、Git blob及完整正文,中文为全文翻译;代码示例和原始元数据按原样保留。文档中的安装、授权、设备、清理或发布命令均为历史资料,本站未执行;当前安装与运行效果未实测。原条目仓库、名称、标识、网址、安装命令及安装量保持原值。
完整主指南
更新项目技能
提供了名称?就更新这些。没有名称?就更新该项目持有的每个技能。
项目列表由用户决定。在他们选择之前不做任何更新。
流程
1. 查找项目
当用户未指定目录时,询问要搜索的目录。
当项目根目录存在 skills-lock.json 时,即表示该项目使用 skills CLI:
find <dir> -name skills-lock.json -not -path '*/node_modules/*' -not -path '*/.git/*'
锁文件中的 skills 键即技能名称。提供了名称?则保留其锁文件至少包含其中一个名称的项目,并说明你丢弃了哪些项目以及原因。
完成条件: 搜索发现的每个锁文件要么在列表中,要么被明确列为已丢弃。
2. 获得批准
用一张表列出:项目路径、当前分支以及匹配的技能。等待用户选择。“全部”是一个选择;沉默不是。
3. 更新,一次一个项目
先记录 git status --short。这是第 4 步的基线。
npx skills@latest update <names...> -p -y
-p将其限制在项目范围内。没有它,用户的全局技能也会被更新。-y跳过询问是否移除上游已消失技能的提示。- 名称是
skills-lock.json中的键,绝不是文件夹路径。 - 不提供名称会更新锁文件中的每个来源,而不只是你的。“Updated 54 skill(s)” 统计的是它检查的内容;
git status统计的是实际发生变动的文件。 - 上游重命名的技能会打印一条裸的
✗ Failed to update <name>。CLI 丢弃了原因,因此需要阅读源仓库来找出原因。
4. 单独提交每个项目
只暂存现在出现且在第 3 步基线中不存在的路径。仓库可能已经带有用户自己未提交的工作,那些保持原样。
git commit -m "chore(ai): updated skills"
推送是单独的请求。
完成条件: 每个选定的项目都有一个哈希以及实际发生变更的文件列表。
原始元数据
name: update-project-skills
description: Update skills installed by the skills CLI across your projects, then commit each project.
argument-hint: "[skill names, or nothing for all]"
disable-model-invocation: true