SuperAPI AI 工具集

migrate-skills-between-libraries

通用与其它

查看项目

更新于 10-16 01:18

技能介绍

用途:在不同技能库工作区之间迁移技能,或从个人库升级到团队库,目标是不丢失元数据、不破坏依赖、不产生重复条目。

主要能力与工作流:

  1. 导出:先列出源工作区全部技能,命令为 cd /path/to/source-library 后执行 npx ai-agent-skills list --format json --fields name,tier,workArea,collections。对 house copies 记录技能文件夹路径,对 upstream picks 记录 installSource。
  2. 导入:house copies 用 vendor 复制技能文件夹到目标库,命令为 cd /path/to/target-library 后执行 npx ai-agent-skills vendor /path/to/source-library --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library." --dry-run,确认后再去掉 --dry-run 执行。upstream picks 用 catalog 从原始来源重新编目,命令为 npx ai-agent-skills catalog <owner>/<repo> --skill <name> --area <workArea> --branch <branch> --why "Migrated from source library." --dry-run,确认后再执行。
  3. 迁移后在目标工作区执行 npx ai-agent-skills build-docs 重建文档,再执行 npx ai-agent-skills validate 校验。

限制与注意事项:任何变更命令前必须先用 --dry-run;导入前必须用 --list 检查源库;脚本化迁移时用 --format json;导入前必须检查目标工作区是否存在名称冲突,技能名在每个工作区必须唯一。house copies 是完整文件夹复制,迁移后源与目标相互独立;upstream picks 从原始上游来源重新编目,而非中间库。依赖(requires 字段)也必须一并迁移,可用 info --format json 查看每个技能的依赖图。集合成员关系不会自动转移,需用 curate --collection <id> 将迁移后的技能加入目标集合。

适用场景:技能库整理、个人库向团队库升级、跨工作区搬迁技能。具体收费、平台支持等信息暂未提供。