创建符号链接失败：cc-switch 技能同步报错或目标应用看不到 skill
Quick fix
Windows 上 symlink 需要管理员权限或开发者模式，以管理员身份运行 cc-switch 即可；Hermes/Pi 另有路径与扫描机制问题，见下文。
Symptom
Section titled “Symptom”创建符号链接失败: C:\Users\<user>\.cc-switch\skills\find-skills -> C:\Users\<user>\.claude\skills\find-skills该问题簇包含三种导致"skill 同步后不可用/状态不对"的机制。其一（#4241）：Windows 的 symlink_dir 默认需要管理员权限或开启开发者模式，普通用户运行 cc-switch 时创建符号链接会直接失败且没有明确提示；有用户补充在 WSL 环境下即使以管理员身份运行仍然报错。其二（#4896，已修复）：Hermes Desktop（Electron）在 Windows 上读取的是 %LOCALAPPDATA%\hermes\skills\，而不是 CLI/TUI 使用的 ~/.hermes/skills/，旧版 cc-switch 只向后者投影，导致 UI 显示已启用但 Desktop 里 0 个技能。其三（#8000，未修复）：Pi 除了 ~/.pi/agent/skills/ 外还会扫描 settings.json 的 skills 数组和 ~/.agents/skills/，cc-switch 不感知这些通道，导致不勾选时 Pi 实际已加载（状态失真）、勾选时又产生冗余投影（重名技能加载两遍并告警）。
（针对"创建符号链接失败"）关闭 cc-switch，右键以管理员身份重新运行，然后重新启用 Claude Code 的 skill 同步；Issue #4241 报告者确认此方法有效。
或者开启 Windows 开发者模式（设置 → 隐私和安全性 → 开发者选项），使普通用户也能创建符号链接，再以普通权限运行 cc-switch。
（针对 Hermes Desktop 看不到技能）升级到 v3.17.0 或更新版本，并在 cc-switch 中重新切换一次对应 skill 的 Hermes 开关，以刷新旧版本留下的失效投影。
（针对 Pi 状态失真/冗余投影）检查 ~/.pi/agent/settings.json 的 skills 数组以及 ~/.agents/skills/ 目录是否已让 Pi 间接加载同一批技能；若是，可暂时不在 cc-switch 中勾选 Pi，等待官方支持（#8000 仍 open）。注意 SSOT Unified 模式下 Pi 零配置即可看到全部托管技能。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 3 个真实 issue
- 以管理员身份运行还是报"创建符号链接失败"怎么办？
- 有用户反馈在 WSL 环境下以管理员身份运行仍然会报错。该 issue（#4241）目前仍为 open，暂无官方修复；可考虑开启开发者模式或改用 copy 方式（但注意 #2762 提到回退 copy 可能覆盖用户数据）。
- 升级到 v3.17.0 后 Hermes Desktop 里还是看不到技能？
- 维护者要求升级后必须重新切换一次对应 skill 以刷新旧投影；若 %LOCALAPPDATA% 路径仍未同步，请重新打开 issue 并补充 Hermes 版本、实际目录和日志。
- 为什么我没在 cc-switch 勾选 Pi，Pi 却加载了这些技能？
- Pi 原生会扫描 ~/.agents/skills/ 以及 ~/.pi/agent/settings.json 中 skills 数组列出的目录（如 ~/.claude/skills），无需 cc-switch 投影。cc-switch 目前不感知这些通道，所以界面显示"未启用"但实际已加载（#8000，未修复）。
- 勾选 Pi 后技能被加载两遍并告警重名，是为什么？
- 因为该技能所在目录已被 Pi 通过 settings.json 的 skills 数组或 ~/.agents/skills/ 引用，cc-switch 又向 ~/.pi/agent/skills 做了一次投影，造成冗余。Pi 对重名技能保留先发现的并告警。官方尚未实现跳过冗余投影（#8000）。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。