SuperAPI AI 工具集

sync-local-global-agents-skills

智能体与模型

查看项目

更新于 10-16 04:41

技能介绍

本地全局 Agent Skills 同步器

本技能用于将 Vercel skills CLI 全局安装的 skills(~/.agents/skills)作为唯一数据源,批量同步到本机其他本地 agent 平台的 skills 目录。

触发边界

合法触发包括:skills add ... -g 已成功后,用户要求继续同步到本地平台;用户明确要求把全局 ~/.agents/skills 同步到 WorkBuddy、QoderWork、Kimi Work、CodeBuddy、Qoder;新增平台完成目录语义和链接能力核验后,需要执行同步;目标 skills 链接失效、误删或指向错误位置,需要重建。

用户给出尚未执行的完整 skills add 命令时,不抢在原命令前运行本同步器;应先执行或按用户语义确认原命令,失败后再按错误分流。

使用场景

当遇到以下情况时使用本技能:已使用 skills add ... -g 全局安装/更新了 skills,需要同步到 WorkBuddy、QoderWork、Kimi Work、CodeBuddy、Qoder 等本地 agent 平台;新增了一个本地 agent 平台,需要把现有 skills 分发过去;某个平台的 skills 目录被误删或链接失效,需要重建。

核心职责

唯一数据源:始终从 ~/.agents/skills 读取,不维护第二份副本。

目录级符号链接:把目标平台的 skills 目录替换为指向源目录的符号链接。

幂等执行:重复运行不会重复创建链接。

安全备份:遇到真实目录时自动备份为 skills.bak.<timestamp>-<uuid>。

错误链接修复:遇到指向错误位置的符号链接时自动删除并重建。

已支持平台

平台注册表在 src/platforms.ts 中维护,新增平台需修改该文件并升级技能版本。

平台与目标目录:WorkBuddy 对应 ~/.workbuddy/skills;QoderWork 对应 ~/.qoderworkcn/skills;Kimi Work 对应 ~/AppData/Roaming/kimi-desktop/daimon-share/daimon/skills;CodeBuddy 对应 ~/.codebuddy/skills;Qoder 对应 ~/.qoder/skills。

使用方式

主脚本(推荐):在技能安装目录(例如 ~/.agents/skills/sync-local-global-agents-skills/)下运行。

使用 tsx 运行:tsx scripts/sync.ts

只查看计划,不修改文件系统:tsx scripts/sync.ts --dry-run

指定自定义源目录:tsx scripts/sync.ts --source <custom-skills-root>

不备份直接替换:tsx scripts/sync.ts --no-backup

兜底脚本

fallback 只在同步主脚本不可用、Node/TypeScript 不可用、权限不足、符号链接能力失败,或同步脚本已经失败后作为降级路径;它不是 skills add 前的默认路径。

当需要降级执行时,可使用同目录下的 fallback 脚本:Windows PowerShell 使用 fallback/sync.ps1;WSL / macOS / Linux 使用 fallback/sync.sh。

符号链接策略

Windows:优先创建原生目录符号链接(lrwxrwxrwx / MSYS=winsymlinks:native 形式),权限不足时自动 fallback 到 junction。

Linux/macOS:使用标准 ln -s 目录软链接。

同步行为

目标目录不存在 → 创建目录级符号链接。

目标目录已是正确链接 → 跳过。

目标目录是真实目录 → 备份后替换为链接。

目标目录是错误链接 → 直接替换(不备份)。

目标路径是普通文件 → 删除后创建链接。

Memorix Skills 刷新

本版本已集成 memorix 内部 skills 刷新能力。运行 sync.ts 时会自动先从 memorix 官方仓库(GitHub raw)刷新最新的内部 skills 到 ~/.agents/skills/,然后再同步到各 agent 平台。

相关参数:--skip-memorix-refresh 跳过 memorix 刷新步骤;--force-memorix-refresh 强制覆盖已存在的 memorix skills;--memorix-source <github|local|cli|auto> 来源策略(默认:auto);--memorix-agent <agent> agent 来源(默认:cursor)。

独立刷新脚本:scripts/fetch-memorix-skills.ts(支持 --dry-run、--force 参数)。

相关文件

scripts/sync.ts — CLI 入口;src/sync.ts — 核心同步逻辑;src/platforms.ts — 平台注册表;fallback/sync.ps1 — Windows PowerShell 兜底;fallback/sync.sh — Bash 兜底。