问题:技能文件到处复制
用 AI 编程工具的同学大多有这个痛点:
你精心写了一套编码规范、一个 Prompt 模板、一套测试要求——然后发现要在 Cursor、Trae、CodeBuddy、VS Code 里各放一份。
改了一处,忘了同步其他;换了电脑,又要重新配置。时间全花在文件搬运上。
方案:符号链接(Symbolic Link)
符号链接是操作系统提供的一种文件系统功能。简单说,它可以让多个不同路径指向同一个真实文件或文件夹。
Windows 叫"符号链接",Linux/macOS 叫"软链接"。原理一样,效果一样。
核心思路:建一个中央技能库文件夹,然后用符号链接把它"映射"到各个 AI 工具的配置目录下。工具读到的是同一份文件,修改任何一处,所有工具立刻同步。
整体架构一览
先看改造后的项目结构 —— 一张图说清楚:
对比改造前:4 个目录各存一份副本,每次改动要手动同步 4 次。
动手配置(3 步)
第 1 步:创建中央技能库
在项目根目录下建一个文件夹,按分类存放技能文件(目录结构见上方总览图)。
第 2 步:运行一键配置脚本
Windows PowerShell(管理员身份)执行:
& "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 下可以用以下命令检查:
额外技巧:全局技能库
可以建一个全局技能库:
& "setup-global-skills-library.ps1"
这样你只需要维护一套技能文件,所有新项目开箱即用。
文件说明
agent-skills-library/ |
|
setup-symlinks.ps1 |
|
setup-global-skills-library.ps1 |
|


