本地全局 Agent Skills 同步器 Skill

本地全局 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 中，新增平台需修改该文件并升级技能版本。

使用方式

主脚本（推荐）

在技能安装目录（例如 ~/.agents/skills/sync-local-global-agents-skills/）下运行：

# 使用 tsx 运行
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

# 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 参数）。

Agent Skills: 本地全局 Agent Skills 同步器

Install this agent skill to your local

Skill Files