在多个项目中复用 Skills

代码审查、文档写作和测试约定等 Skills 可以在多个项目中复用。将它们集中保存在一个仓库，通过 Preset 选取目录，可以减少逐个复制文件的操作。

示例仓库 team-resources 的 skills 目录包含三个 Skill。两份配置分别用于引入全部 Skills，以及通过 exclude 排除 testing 目录。

示例说明

下方只演示文件变化，不会运行命令。试用前，先替换示例仓库地址，再把 JSON 保存到命令指定的路径。

生成版本

skills/code-review/SKILL.md

1---
2name: code-review
3description: Review code changes for correctness and edge cases.
4---
5 
6Read the diff. Report concrete problems with file references.

创建命令

Bash

pnpm create preset init .agents/skills --from ./presets/skills.json

目标目录

示例命令从项目根目录运行，目标是新建或空的 .agents/skills 目录。例如，仓库里的 skills/code-review/SKILL.md 会放到 .agents/skills/code-review/SKILL.md。

目标路径需要与所用 agent 的 Skills 目录一致，可以在命令中修改。同一个仓库可以供多个项目使用，不必为了分发再发布 npm 包。

已有 Skills 的处理

目标目录已有文件时，CLI 会询问是否替换整个目录，不会逐个合并 Skill。 为保留项目中的现有内容，可以先生成到一个新的临时目录：

Bash

pnpm create preset init skills-preview --from ./presets/skills.json

检查生成内容后，将需要的 Skill 文件夹复制到项目中；同名文件需要比较后再决定是否覆盖。源仓库更新后，也可以通过临时目录比较新旧文件。Create Preset 不会自动同步更新，也不会把 Skills 链接到其他 agent 的目录。

一份 Preset 只读取一个源仓库。如果常用 Skills 分散在多个仓库，需要先整理到同一个仓库，再用这份配置分发。