44 lines
1.9 KiB
Plaintext
44 lines
1.9 KiB
Plaintext
---
|
||
description: 跨项目底层通用约定（语言、目录归属）
|
||
alwaysApply: true
|
||
---
|
||
|
||
## 语言约定
|
||
|
||
Agent回复时使用简体中文。
|
||
代码注释时尽量使用简体中文。
|
||
写SKILL的时候文档部分也尽量使用简体中文。
|
||
专业术语和项目专有名词不受此语言限制，通常是英文则保留。
|
||
|
||
## Rules / Skills 目录归属约定
|
||
|
||
本项目使用以下目录结构区分跨项目通用内容与项目专属内容：
|
||
|
||
### Rules
|
||
|
||
| 目录 | 用途 | 示例 |
|
||
|------|------|------|
|
||
| `.cursor/rules/common/` | 跨项目通用规则，开新项目时可直接复制 | 语言约定、Orchestrator 触发、延期方案回忆 |
|
||
| `.cursor/rules/project/` | 当前项目专属规则 | 项目架构约定、框架特定规范、项目专属工作流 |
|
||
|
||
### Skills
|
||
|
||
| 位置 | 用途 | 示例 |
|
||
|------|------|------|
|
||
| `.cursor/skills/` | **所有 Skill 的主存储位置**（含通用和项目专属） | epee-orchestrator、deferred-decisions、项目特定 Skill |
|
||
| `~/.cursor/skills/` | 跨项目通用 Skill 的全局副本（可选，方便其他项目复用） | epee-orchestrator、deferred-decisions |
|
||
|
||
> **重要**：无论 Skill 是通用还是项目专属，都**必须**在项目的 `.cursor/skills/` 下保留一份，
|
||
> 以确保能被 Git 管理和版本控制。全局目录 `~/.cursor/skills/` 仅作为跨项目共享的便利副本，
|
||
> 不作为唯一存储位置。
|
||
|
||
### Agent 创建 Rule 或 Skill 时必须遵守
|
||
|
||
1. **先判断归属**：新建 Rule 或 Skill 前，评估其是否为跨项目通用内容
|
||
2. **如果不确定，必须询问用户**："这个 Rule/Skill 是通用的还是项目专属的？"
|
||
3. 确认后放入对应目录：
|
||
- 通用 Rule → `.cursor/rules/common/`
|
||
- 项目专属 Rule → `.cursor/rules/project/`
|
||
- **所有 Skill（含通用）→ `.cursor/skills/`**（必须，确保 Git 可管理）
|
||
- 通用 Skill 额外同步 → `~/.cursor/skills/`（可选，方便其他项目使用）
|