排障 FAQ

与代码版本无关的坑都放这里。格式：症状 → 原因 → 处置。新条目加在最上面。

sync 后本地改动没了

• 症状：cdgs sync 后，本地对 SKILL.md / references/ 的改动被覆盖。
• 原因：sync 是版本门控，以 origin/main 为准覆盖共享文件。
• 处置：共享内容要走「bump metadata.version + push/PR」；个人沉淀放 *.local.md / local/（永不覆盖）。

install.ps1 建 junction 全失败

• 症状：skills 没注册上，store 里没有 junction。
• 原因：在 Git Bash 里用了 mklink /J，MSYS 把 /J 当路径吞掉。
• 处置：一律用 PowerShell New-Item -ItemType Junction。

模板（新条目复制这段）

## <一句话症状>

- **症状**：
- **原因**：
- **处置**：