SuperAPI AI 工具集

skill-sync

智能体与模型

查看项目

更新于 10-15 23:33

技能介绍

用途:在创建或修改技能、智能体、提示词之后,维护各模型目录之间的一致性。采用基于符号链接的本地安装(CLI local 命令)时,大部分同步是自动的;本技能主要说明何时需要手动同步。

主要能力与同步架构:以 skills/ 目录为唯一事实来源,模型目录(如 .agents/skills/、.claude/skills/、.cursor/skills/ 等)通过符号链接指向源目录,因此修改源文件会即时传播,无需手动同步。需要手动同步的情况包括:新增尚未安装的技能、复制式(非符号链接)安装、以及 AGENTS.md 或模型指令文件的变更。

使用方式:新增技能或依赖变化后运行 npx ai-agents-skills local 重新安装并创建符号链接;用 npx ai-agents-skills validate --all 校验全部技能是否正确安装;用 npx ai-agents-skills list 查看各模型已安装技能。修改 AGENTS.md 后,如存在 .claude/instructions.md、.gemini/instructions.md 等模型指令文件,需同步更新。git pull 或批量变更后,先运行 local 再运行 validate --all。

限制与注意:不要直接编辑模型目录中的文件,应始终编辑 skills/ 下的源文件;模型目录只应包含符号链接或被同步覆盖的副本。提示词不会被复制到模型目录,因此修改提示词无需同步。若未安装任何模型目录,可跳过同步,待首次运行 npx ai-agents-skills local 时再安装。部分安装时只同步已存在的模型目录。模型目录内容冲突时,以 skills/ 为准,重新运行 CLI 覆盖。