cursor Init 完善多人协同changelog,以及godot相关基础skill和代码规范

This commit is contained in:
Nostars Developer
2026-07-15 14:38:08 +08:00
parent fc8557f2a9
commit 6446261c69
56 changed files with 3523 additions and 1584 deletions

View File

@@ -1,43 +1,35 @@
---
description: 跨项目底层通用约定语言、目录归属
description: 跨项目底层约定语言、目录归属、运行时版本与 Windows 文本编码
alwaysApply: true
---
## 语言约定
# 基础约定
Agent回复时使用简体中文。
代码注释时尽量使用简体中文。
写SKILL的时候文档部分也尽量使用简体中文。
专业术语和项目专有名词不受此语言限制,通常是英文则保留。
## 语言
## Rules / Skills 目录归属约定
- 面向用户的回复使用简体中文;代码注释和 Skill 文档优先使用简体中文。
- API、类型名、命令和项目专有名词保留其惯用英文写法。
本项目使用以下目录结构区分跨项目通用内容与项目专属内容:
## Rules / Skills 目录归属
### Rules
- 跨项目通用 Rule 放在 `.cursor/rules/common/`。
- 当前项目或特定技术栈 Rule 放在 `.cursor/rules/project/`。
- 项目内 Skill 放在 `.cursor/skills/`;全局副本只能作为可选共享副本,不能替代项目内版本。
- 新建 Rule 或 Skill 前先判断归属;无法判断时先询问用户。
| 目录 | 用途 | 示例 |
|------|------|------|
| `.cursor/rules/common/` | 跨项目通用规则,开新项目时可直接复制 | 语言约定、Orchestrator 触发、延期方案回忆 |
| `.cursor/rules/project/` | 当前项目专属规则 | 项目架构约定、框架特定规范、项目专属工作流 |
## 运行时版本
### Skills
创建环境、安装依赖、启动项目或运行测试前,先确认项目声明的运行时版本;禁止直接采用系统默认版本,也不得擅自升级到最新或预发布版本。
| 位置 | 用途 | 示例 |
|------|------|------|
| `.cursor/skills/` | **所有 Skill 的主存储位置**(含通用和项目专属) | epee-orchestrator、deferred-decisions、项目特定 Skill |
| `~/.cursor/skills/` | 跨项目通用 Skill 的全局副本(可选,方便其他项目复用) | epee-orchestrator、deferred-decisions |
- Godot检查 `project.godot` 的兼容声明、项目 README 的版本要求,以及 `.cursor/local-env.json` 记录的本机可执行文件与版本;本机配置只用于选择运行时,不能覆盖项目要求。
- Python检查 `pyproject.toml`、`.python-version` 和 README。
- Node.js检查 `package.json` 的 `engines`、`.nvmrc`、`.node-version` 和 README。
- 声明互相冲突时指出冲突;版本仍不明确时,先向用户确认再安装或执行。
- 本机版本不匹配时先报告并给出调整方案,不通过修改业务代码迁就错误环境。
> **重要**:无论 Skill 是通用还是项目专属,都**必须**在项目的 `.cursor/skills/` 下保留一份,
> 以确保能被 Git 管理和版本控制。全局目录 `~/.cursor/skills/` 仅作为跨项目共享的便利副本,
> 不作为唯一存储位置。
## Windows UTF-8 安全
### 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/`(可选,方便其他项目使用)
- 文本文件统一保存为 UTF-8 无 BOM、LF 换行;修改后按需校验 BOM 与换行。
- 优先使用 IDE 的文件读写工具,避免文本经控制台编码转换后再写回。
- 必须用 PowerShell 写文本时显式使用可产生 UTF-8 无 BOM 的 API并明确 LF不要依赖 Windows PowerShell 与 PowerShell 7 不同的默认编码。
- 必须查看含中文的命令输出时先将控制台输出编码设为 UTF-8若仍有乱码写入显式 UTF-8 的临时文件后再用文件工具读取。