SuperAPI AI 工具集

sync-skills-wsl

通用与其它

查看项目

更新于 10-16 09:45

技能介绍

用途:在 Windows 与 WSL2 之间同步 Cursor agent 技能,使两端共享唯一权威存储 %USERPROFILE%.cursor\skills。WSL 与 .agents\skills 只以链接或联接方式指向该目录,不保留第二份真实副本。当出现「同步技能」「restore/relink WSL skills」「Windows 和 WSL 技能目录对齐」等需求,或一侧刚增删技能需另一侧即时一致时执行完整同步流程。

主要能力:从 Windows 侧(PowerShell 或 Cursor)按顺序执行两步。第一步先解析技能安装路径,可在 .cursor\skills 或 .agents\skills 下查找,再运行 restore-windows.ps1:确保 %USERPROFILE%.agents\skills 存在,对其中每个真实文件夹(非联接)在缺失时复制进 .cursor\skills,然后把 agents 条目替换为指向 .cursor\skills<name> 的联接;跳过已是联接/符号链接的条目,清理目标已不存在的失效联接。第二步运行 WSL 侧 restore-wsl.sh,建立 ~/.cursor/skills → /mnt/c/Users/<win>/.cursor/skills、~/.agents → /mnt/c/Users/<win>/.agents、以及存在时的 ~/.claude 链接;已有不同目标会先备份为 *.bak.<timestamp> 再重新链接,随后执行 absorb-agents-skills.sh。完成后报告权威路径与技能数量、WSL 链接目标、清理的失效联接或 absorb 动作。

使用方式:完整同步默认两步均执行;也可仅修复 Windows .agents 联接(只跑第一步)、仅修复 WSL 链接(只跑第二步),或删除技能后清理悬空链接。若 USERNAME/用户目录名不匹配,可在 WSL 内设置 WIN_USER 或调用脚本时传入。

限制与注意:用户必须启用 WSL,否则停止并报告;联接创建失败时需在非受限沙箱、具备 %USERPROFILE% 文件系统权限的 PowerShell 中运行。不要在 WSL home 用 cp -r 复制整棵树;不要在 ~/.cursor/skills-cursor/(Cursor 内置)下创建技能;不要在两处留下真实重复项。技能计数不一致时重跑完整同步,并确认 WSL 路径是指向 /mnt/c/... 的符号链接而非真实目录。旧脚本位于 ~/.cursor/skills/restore-skills.ps1、restore-skills.sh、absorb-agents-skills.sh,优先使用本技能的可移植脚本。安装命令以资料中的 npx skills add 为准,具体参数与脚本内容详见原始资料,此处不展开。