不过，

痛点一的观点是，规则分散导致维护成本飙升

在实际项目中。我同时使用 Claude、Cursor还有国内的 CodeBuddy 和 Qoder。每个工具都有自己的规则文件：

• Claude 使用 CLAUDE.md
• Cursor 使用 .cursorrules 或 .cursor/rules/
• CodeBuddy 与 Qoder 均支持项目级规则文件

最初每个工具各自维护一套。修改一次规范要手动同步三四遍，极易出现不一致。

痛点二的观点是，跨网站软链接在 Windows 上失效

为实现统一。我们尝试通过符号链接让 Cursor 指向 Claude 的配置。但在 Windows 环境下Git GUI 常常把软链接当作普通文件读取，导致工具读取不到真实规则。

至于痛点三，缺乏统一的版本管理与变更流程

规则虽已写好。却没有明确的版本号标记，也没有变更审核 checklist，使得团队在代码审查时难以追溯“这条规范何时加入、为何加入”。

概念澄清的观点是，规则 vs 技能

规则

定义：约束 AI 如何写代码——命名规范、异常处理方式、日志格式等。它直接影响生成代码的风格和质量。

技能

定义：描述完成特定业务任务的完整流程——如 “新建 React 项目”、 “生成 PDF 报告”、 “部署到测试环境”。技能是一组可执行脚本、资源和元数据。

An​thropic 于 YYYY‑MM 正式推出 Claude Skills 功能，并在 MM 月开放 Agent Skills 标准；Cursor Nightly 已支持对应插件。

Skill 正在成为 AI 时代表层软件——模型相当于 CPU。Agent Runtime 如同操作程序，而 Skill 则是运行在其上的应用程序。

各网站配置文件对比

┌─────────────────────────────────────────────────────────────────┐
│ 各网站配置文件对比 │
│ │
│ 网站 规则配置 技能配置 │
│ ────── ────────── ────────── │
│ Claude CLAUDE.md .claude/skills// │
│ .claude/rules/ SKILL.md + scripts/ │
│ .claude/settings.json │
│ │
│ Cursor .cursorrules .cursor/skills/ │
│ │
│ CodeBuddy 项目级规则文件 Skills │
│ CLAUDE.md │
│ │
│ Qoder 项目级规则文件 支持 CLAUDE.md 风格配置 │
│ CLAUDE.md │
└─────────────────────────────────────────────────────────────────┘

主要问题：虽然文件名不同，但实际内容高度重叠。团队的 Java 编码规范在所有网站都应保持一致，却被迫维护多份。不过，

从方案主要来看，以 .claude/ 为唯一真实源

1. .claude/ 目录结构最清晰：/rules/ 放规章。/skills/ 放技能，/settings.json 存全局设置。
2. Cursor 原生支持第三方插件扫描：打开 “Include third‑party Plugins,Skills。and or configs” 后会自动读取 .claude/skills/ .
3. ACTION：把所有规章放进 .claude/ ,接下来让其他工具通过软链接或初始化脚本指向它。按理说，

项目目录示例

项目根目录/
├── .claude/ ← 唯一真实源
│ ├── CLAUDE.md # 主要通用规章
│ ├── rules/
│ │ ├── java.md
│ │ ├── test.md # 测试相关约束
│ │ └── security.md # 安全合规检查
│ ├── skills/
│ │ ├── web-builder/
│ │ │ ├── SKILL.md # 技能描述+步骤
│ │ │ └── scripts/
│ │ └── pdf-processor/
│ │ ├── SKILL.md
│ │ └── scripts/
│ └── settings.json # 全局选项，如模型版本等
├── .cursorrules ← 符号链接 → .claude/CLAUDE.md
├── .cursor/rules ← 符号链接 → .claude/rules/
└── .cursor/skills ← 符号链接 → .claude/skills/

实操步骤

第一步先的观点是，把所有已有规章迁移到 .claude/

mkdir -p .claude/rules
# 将旧有 Claude 配置搬入统一目录
mv .cursorrules .claude/CLAUDE.md >/dev/null 2>&1 || true
# 合并 Cursor、CodeBuddy 等已有 rule 文件到统一目录下的子目录中
mv .cursor/rules/* .claude/rules/ >/dev/null 2>&1 || true
# 如有其他工具专属 rule，也搬进相应子目录，例如：
# mv codebuddy_rules/*.md .claude/rules/

至于接下来，创建软链接或初始化脚本

a. macOS / Linux 推荐使用符号链接：

# Cursor 的 rule 链接
ln -sf .claude/CLAUDE.md .cursorrules
ln -sf .claude/rules .cursor/rules
ln -sf .claude/skills .cursor/skills

b. Windows 推荐使用批处理或 PowerShell 脚本创建“NTFS 符号链接”。并将其加入 .gitignore

：Git 配置与软链接策略

• a. 将真实文件全部提交至 Git，仅把软链接排除：

# 在仓库根部添加
echo ".cursorrules">> .gitignore
echo ".cursor/rules">> .gitignore
echo ".cursor/skills">> .gitignore
git add .
git commit -m "Add unified `.claude` rule set"
git push origin main

• b. 若坚持让符号链接进入仓库，需要强制文本属性：

# 在仓库根部创建或编辑 `.gitattributes`
.cursorrules binary
.cursor/** binary
# 提交后 Git 会保存 symlink 本身而非目标内容，在 macOS/Linux 正常工作，# Windows clone 时仍需自行运行 `setup.ps1` 恢复本地 link。

从第四步来看，在 Cursor 中开启第三方插件扫描

3. .claude/skills/ .

Skill 文件格式对比：Claude vs Cursor

S K I L L . M D 示例：

name这方面。web-builder
description: 用 React + Tailwind 快速搭建前端页面。包含初始化、开发、打包流程。---
# Web Builder 步骤
1. 执行 `scripts/init.sh ` 创建项目结构。2. 编辑生成的代码，话说回来，3. 执行 `scripts/bundle.sh` 打包为单页 HTML。老实说，4. 提交 PR 并等待审查。bash
# 示例脚本片段
#!/usr/bin/env bash
npm install && npm run build

.mdc 文件 示例：