问题：技能文件到处复制
用 AI 编程工具的同学大多有这个痛点：
你精心写了一套编码规范、一个 Prompt 模板、一套测试要求——然后发现要在 Cursor、Trae、CodeBuddy、VS Code 里各放一份。
改了一处，忘了同步其他；换了电脑，又要重新配置。时间全花在文件搬运上。
方案：符号链接（Symbolic Link）
符号链接是操作系统提供的一种文件系统功能。简单说，它可以让多个不同路径指向同一个真实文件或文件夹。
Windows 叫"符号链接"，Linux/macOS 叫"软链接"。原理一样，效果一样。
核心思路：建一个中央技能库文件夹，然后用符号链接把它"映射"到各个 AI 工具的配置目录下。工具读到的是同一份文件，修改任何一处，所有工具立刻同步。
整体架构一览
先看改造后的项目结构 —— 一张图说清楚：
── 项目结构总览 (setup-symlinks.ps1 执行后) ──▶ Agent-skills-library/ ✔ 唯一真实文件，所有工具共享├── 编码规范/ ├─ code-style.md └─ naming.md├── 提示词模板/ ├─ code-review.md └─ bug-fix.md├── 测试规范/ └─ unit-test-guide.md└── UI设计指南/ ├─ color-typo.md └─ component.md符号链接 (Symbolic Link) —— 多个路径指向同一份文件对比改造前：4 个目录各存一份副本，每次改动要手动同步 4 次。
动手配置（3 步）
第 1 步：创建中央技能库
在项目根目录下建一个文件夹，按分类存放技能文件（目录结构见上方总览图）。
第 2 步：运行一键配置脚本
Windows PowerShell（管理员身份）执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
& "setup-symlinks.ps1"脚本会自动检测你电脑上装了哪些 AI 工具，只为已安装的工具创建符号链接。
第 3 步：重启 IDE
重启你的 AI 编程工具，打开规则/技能面板，确认能看到技能库中的文件即可。
支持哪些 AI 编程工具？
目前支持以下主流工具的自动检测和配置：
| | |
|---|
| .vscode/ | |
| .cursor/rules/ | |
| .trae/rules/ | |
| .codebuddy/skills/ | |
| .zed/rules/ | |
| .opencode/rules/ | |
注：脚本会自动检测哪些工具已安装，只为已安装的工具创建链接。
常见问题
Q: 符号链接需要管理员权限吗？
Windows 上需要。创建符号链接要求管理员权限（或开启开发者模式）。脚本运行时会自动提权提示。macOS/Linux 则不需要。
Q: Git 能正常跟踪符号链接吗？
Git 会把符号链接作为链接本身存储（不会存储目标文件内容）。克隆仓库后需要重新运行脚本建立链接。
Q: 某个工具的配置格式和其他工具不一样怎么办？
符号链接指向的是文件，所以每个工具会按照自己的方式解析同一份文件。大部分 AI 编程工具都支持 Markdown 格式的规则文件，差异不大。如果某个工具需要特殊格式，可以在中央库中为它单独创建一个变体文件。
Q: 删除符号链接会删除原文件吗？
不会。删除符号链接只会删除链接本身，中央技能库中的原始文件完全不受影响。
Q: 如何验证链接是否生效？
Windows 下可以用以下命令检查：
Get-ChildItem .cursor/rules | Select-Object Name, LinkType, Target额外技巧：全局技能库
可以建一个全局技能库：
mkdir ~/agent-skills-library
& "setup-global-skills-library.ps1"这样你只需要维护一套技能文件，所有新项目开箱即用。
文件说明
agent-skills-library/ | |
setup-symlinks.ps1 | |
setup-global-skills-library.ps1 | |
粤ICP备14082021号
免费POC，
零成本试错
