为AI代理提供符号链接指令文件跟随能力，自动解析并加载链接指…

# 共享团队规范文档的符号链接方案

方案思路

符号链接只解决“本地指向”，无法让12个同事和工具“自动获取”。推荐 Git 仓库 + dotfiles/配置管理 的组合方案：

第一步：确认文件来源唯一化

• 将 team-rules.md 移入一个中心仓库（如 team-config 或已有的 docs 仓库）
• 原路径 /home/docs/team-rules.md 改为指向仓库内文件的符号链接，保持旧路径兼容

第二步：创建符号链接

```bash

# 假设文件已移入仓库 ~/team-config/team-rules.md

ln -s ~/team-config/team-rules.md /home/docs/team-rules.md

```

• 用 ln -s 创建软链接（不用硬链接，跨目录管理更灵活）
• 验证：ls -l /home/docs/team-rules.md 应显示 -> 指向

第三步：接入 AI 工具

Claude Code：

• 方式一：在项目根目录建符号链接 ln -s /home/docs/team-rules.md CLAUDE.md（或放入 .claude/ 目录）
• 方式二：直接在 CLAUDE.md 中写一行 @/home/docs/team-rules.md 引入

Cursor：

• 在项目根目录建符号链接指向 .cursorrules 或 .cursor/rules/ 下的规则文件
• Cursor 对符号链接的支持因版本而异，建议在团队内先验证加载是否生效，不行就用“构建脚本复制”兜底

第四步：分发给12位同事

• 每人克隆 team-config 仓库到约定路径（如 ~/team-config）
• 提供一键初始化脚本（setup.sh），内容为创建上述符号链接，避免各自手敲出错
• 脚本中加入判断：目标已存在时先备份再替换

第五步：保持同步更新

• 规范变更只改仓库内源文件，提 PR 评审后合并
• 同事定期 git pull 即可同步（符号链接本身不用动）
• 可在 CI 中加检查，防止有人直接修改链接目标外的副本

注意事项

• macOS 与 Linux 的 ln 基本兼容，但注意路径不要写死他人用户名，用 ~ 或 $HOME
• 符号链接断裂（源文件被移动/删除）会导致工具加载失败，脚本里加存在性检查