| name | sync-local-global-agents-skills |
| description | 同步本机全局 agent skills 到多个本地 agent 平台（WorkBuddy、QoderWork、Kimi Work 等）。 以 C:\Users\<user>\.agents\skills 为唯一真理数据源，通过目录级符号链接分发安装，避免重复拷贝。 支持 dry-run、自动备份、错误链接替换。已集成 memorix 内部 skills 刷新能力，同步前自动从 memorix 官方仓库拉取最新 skills。 触发关键词：sync-local-global-agents-skills、同步 skills、全局 skills 同步。 |
| metadata | {"version":"0.1.0"} |
本地全局 Agent Skills 同步器
本技能用于将 Vercel skills CLI 全局安装的 skills（~/.agents/skills）作为唯一数据源，批量同步到本机其他本地 agent 平台的 skills 目录。
使用场景
当遇到以下情况时使用本技能：
- 已使用
skills add ... -g 全局安装/更新了 skills，需要同步到 WorkBuddy、QoderWork、Kimi Work 等本地 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 |
使用方式
主脚本（推荐）
在技能安装目录（例如 ~/.agents/skills/sync-local-global-agents-skills/）下运行：
tsx scripts/sync.ts
tsx scripts/sync.ts --dry-run
tsx scripts/sync.ts --source D:\custom\.agents\skills
tsx scripts/sync.ts --no-backup
兜底脚本
当无法使用 Node/TypeScript 时，可使用同目录下的 fallback 脚本：
# Windows PowerShell
fallback/sync.ps1
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 兜底
