Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/ruan-cat/monorepo --skill sync-local-global-agents-skillsAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
本地全局 Agent Skills 同步器
本技能用于将 Vercel skills CLI 全局安装的 skills（~/.agents/skills）作为唯一数据源，批量同步到本机其他本地 agent 平台的 skills 目录。
触发边界
合法触发包括：
skills add ... -g已成功后，用户要求继续同步到本地平台。- 用户明确要求把全局
~/.agents/skills同步到 WorkBuddy、QoderWork、Kimi Work、CodeBuddy。 - 新增平台完成目录语义和链接能力核验后，需要执行同步。
- 目标 skills 链接失效、误删或指向错误位置，需要重建。
用户给出尚未执行的完整 skills add 命令时，不抢在原命令前运行本同步器；应先执行或按用户语义确认原命令，失败后再按错误分流。
使用场景
当遇到以下情况时使用本技能：
- 已使用
skills add ... -g全局安装/更新了 skills，需要同步到 WorkBuddy、QoderWork、Kimi Work、CodeBuddy 等本地 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 |
使用方式
主脚本（推荐）
在技能安装目录（例如 ~/.agents/skills/sync-local-global-agents-skills/）下运行：
bash
# 使用 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 脚本：
powershell
# Windows PowerShell
fallback/sync.ps1bash
# 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 兜底
