环境搭建

权威步骤以仓库 README 为准；本页只记跑通后的经验补充。

新机器安装（速查）

1. git clone git@git.hairoutech.com:casa.ji/cdgs.git D:\projects\cdgs（或 HTTPS：https://git.hairoutech.com/casa.ji/cdgs.git）
2. powershell -ExecutionPolicy Bypass -File D:\projects\cdgs\install.ps1
   • 自动创建 ~/.agents/skills 共享 store，并为仓内顶层 skill 建 junction
   • 从 .skillsrc.example 生成本机私有 .skillsrc
3. 填 .skillsrc：ESS_ROOT、WORK_ORDER_ROOT、LARK_MCP_TOKEN 等

升级

cd D:\projects\cdgs
.\cdgs.ps1 sync

版本门控：远端 metadata.version 更高才覆盖共享文件；*.local.md、local/、.skillsrc 永不被覆盖。

已知环境坑

• junction 必须用 PowerShell New-Item -ItemType Junction；Git Bash 的 mklink /J 会被 MSYS 把 /J 当路径吞掉，全部失败。
• （补充你机器上遇到的坑……）