install-skills

安装项目技能

项目本地技能属于代码仓库。锁定文件会记录其来源，而已提交的 .agents/skills/ 和 .claude/skills/ 条目会让它们在全新检出后即可使用。

如果 skills-lock.json 未发生变化，且用户只想恢复已提交的技能目录，请运行：

pnpm skills:install

添加、移除、重命名或刷新锁定文件条目时，请阅读技能列表变更说明。其中定义了工作顺序、检查上游已重命名或已移除技能的方法、拉取请求摘要以及所需的验证。

安装前

1. 阅读 AGENTS.md、CLAUDE.md，以及有关 Agent 技能或共享工具的任何仓库说明。

2. 检查当前已安装列表。优先使用仓库脚本，例如 pnpm skills:list。否则请运行：

   test -f skills-lock.json && npm_config_ignore_scripts=true npx --yes skills@latest list --json
   

3. 确认所请求的来源和技能名称。如果其中任一项不明确，请在安装前列出该来源：

   npm_config_ignore_scripts=true npx --yes skills@latest add <source> --list
   

安装

从仓库根目录运行安装命令。切勿使用 --global。

从单个来源安装一个或多个指定技能：

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill <skill-a> <skill-b> --agent '*' --yes

仅当用户要求安装某个来源的所有技能时，才安装全部技能：

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill '*' --agent '*' --yes

GitHub 锁定条目包含 source 和 skillPath。恢复命令会克隆来源的默认分支，因此再次运行时可能会安装较新的上游内容。来源必须可公开读取。如果用户要求固定版本，请使用带有 git 引用的来源。

更改锁定文件后，请恢复所有已锁定的技能：

pnpm skills:install

此命令会读取 skills-lock.json，在 .agents/skills/ 下写入实际技能目录，并在 .claude/skills/ 下维护对应的相对链接。

对于 Patina Project 技能，请使用 patinaproject/skills，并且只安装所请求的名称。常见的仓库默认技能包括：

• scaffold-repository
• using-github
• install-skills
• design-by-contract
• grill-system-design
• review-system-design
• writing-for-pstack

验证

运行：

npm_config_ignore_scripts=true npx --yes skills@latest list --json
git status --short

执行 catalog-change.md 中的所有其他检查。报告已安装的技能、其来源，以及发生变更的锁定文件或技能目录。除非用户要求完成分支，否则请在提交前停止。