跳转到内容
Skills Manager/文档
简体中文

标签与预设

标签用于分类技能；预设保存明确的技能集合。

用标签分类

Section titled “用标签分类”
终端窗口
skills tag add hello-skill writing example
skills tag list hello-skill
skills list tag:writing
skills tag remove hello-skill example
skills tag set hello-skill writing

skills tag set 会替换技能的全部标签。将标签或预设重命名为已有名称时会报告冲突；传入 --merge 可合并技能并删除源组，同时保留目标组的颜色和描述。TUI 会先显示确认对话框，并默认选择取消。预设也可以从操作菜单中合并。skills tag delete NAME --yes 会删除分类和所有成员关系，但不会删除技能。

Tags 页面按标签归类 Library 中的技能。

保存部署集合

Section titled “保存部署集合”
终端窗口
skills preset create writing-kit --description "Writing helpers" --tag writing
skills preset show writing-kit
skills preset add writing-kit hello-skill
skills preset deploy writing-kit --agent claude --dry-run
skills preset deploy writing-kit --all-agents

--tag writing 只复制该标签当时的成员。以后标签成员发生变化，预设不会随之更新。使用 skills preset add 或 skills preset remove 调整预设成员；两个命令都接受技能 key 或 --tag。skills preset create 还可以重复传入 --skill KEY。

Presets 页面显示每个预设保存的固定成员。

部署和取消部署必须重复传入 --agent AGENT，或使用 --all-agents。

取消部署前先预览：

终端窗口
skills preset undeploy writing-kit --agent claude --dry-run
skills preset undeploy writing-kit --all-agents

preset delete NAME --yes 只删除预设定义，不会删除已安装技能或已有部署链接。

在 TUI 中使用 Tags 和 Presets

Section titled “在 TUI 中使用 Tags 和 Presets”

两个页面都包含组面板和技能面板。a 打开 Actions，m 进入多选，Ctrl+A 添加当前结果而不清除之前的选择。

标签选择器中的修改会立即生效，因此 Esc 只关闭选择器，不会撤销修改。暂存成员变更的对话框提供 Apply 和 Cancel。预设中的标签覆盖情况描述的是已保存成员，不是实时标签查询。

存储与迁移

Section titled “存储与迁移”

设置 tags_enabled = false 可隐藏标签分类并禁用标签命令，不会删除标签或预设数据。TUI 命令面板和 Ctrl+O 提供相同的确认开关。

每个标签单独保存在 .skills-meta/tags/<tag>.toml。预设保存在 .skills-meta/presets/<name>.toml，其中明确记录技能；重复的技能 key 会被去重。

打开旧版本写入的标签或预设时，程序会先升级格式：标签从 config.toml 移到各自的文件中，按标签列出成员的预设会改为以这些标签的技能作为固定成员。Skills Manager 会报告备份目录，确认升级结果前请保留该备份。详见元数据格式升级。