用途:skills_sync 是管理、同步和配置 AI 智能体技能的命令行工具。它读取配置文件,把用户本地技能目录(通常为 ~/.agents/skills)与远程仓库同步。
配置优先级:项目级 ./skills.yaml 优先,其次全局 ~/.config/skills_sync/skills.yaml。注意:其他技能(如 skills-optimizer)修改 skills.yaml 后不会自动生效,必须运行 skills_sync sync 才会下载新技能、删除已移除技能并应用排除规则。
主要命令: skills_sync sync:按配置同步技能,默认执行 clean 同步(先删除已有技能)。选项 --clean(默认 true)、--no-clean(跳过删除,更快但可能残留孤立技能)、--agent <name>(默认 antigravity,* 表示全部)。 skills_sync update:检查并安装已配置技能的最新版本,不先删除。选项 --agent <name>。 skills_sync list:列出当前配置与本地已安装技能。 skills_sync config:用默认编辑器(或 $EDITOR)打开 skills.yaml。 skills_sync init:若不存在则生成默认全局配置文件。
skills.yaml 规范:根键为 global(安装到 ~/.agents/skills)或具体路径(安装到该项目的 .agents/skills,路径不存在则跳过)。每个目标目录下定义来源:owner/repo、GitHub 分支或文件夹 URL、本地技能目录。每个来源可加筛选:留空安装全部;写具体名称;用 * 通配符;用 ! 前缀排除,排除优先于包含。
工作流:修改配置后需执行 skills_sync sync 使更改生效,可选运行 skills_sync list 验证。
最佳实践与限制:未经用户明确许可,绝不自动运行 skills_sync sync;不要静默修改 skills.yaml,应说明增删内容;不要猜测文件路径或手动下载、克隆到技能目录;sync 下载大仓库可能耗时,需等待完成;可用 --dry-run 预览将执行的命令。