47 lines
3.1 KiB
Markdown
47 lines
3.1 KiB
Markdown
# Soul 创业派对 - .cursor 配置说明
|
||
|
||
本目录的 rules 与 skills 均为**当前项目（Soul 创业派对）**服务，用于约束开发、防止互窜、减少漏改。
|
||
|
||
**会话启动自检**：新 Cursor 打开本项目时，应优先执行 soul-project-boundary 中的「会话启动自检」，仅沿用本项目的 rules、skills、开发风格与配置参数，排除无关的全局或其它项目规则。
|
||
|
||
---
|
||
|
||
## 一、Rules 执行顺序与生效范围
|
||
|
||
| 规则文件 | 生效范围 | alwaysApply | 用途 |
|
||
|----------|----------|-------------|------|
|
||
| **soul-project-boundary.mdc** | `**`（全项目） | ✅ | 总入口：项目组成、防互窜原则、开发时索引 |
|
||
| **soul-change-checklist.mdc** | miniprogram、soul-admin、soul-api | ❌ | 变更后必过：关联层检查清单，防漏改 |
|
||
| **soul-miniprogram-boundary.mdc** | miniprogram/**/* | ❌ | 小程序：只调 /api/miniprogram/* |
|
||
| **soul-admin-boundary.mdc** | soul-admin/**/* | ❌ | 管理端：只调 /api/admin/*、/api/db/* |
|
||
| **soul-api-boundary.mdc** | soul-api/**/*.go | ❌ | soul-api：路由按使用方归类 |
|
||
| **soul-api-coding.mdc** | soul-api/**/*.go | ❌ | soul-api：GORM、Model、响应等编码规范 |
|
||
| **api-reliability.mdc** | next-project/**/* | ❌ | 仅 next-project 参考（TypeScript/Next API） |
|
||
|
||
**执行逻辑**：alwaysApply 的规则始终生效；其余按当前编辑文件路径匹配 glob，匹配到的规则同时生效，无先后依赖。
|
||
|
||
---
|
||
|
||
## 二、Skills 索引（按编辑目录选用）
|
||
|
||
| 编辑目录 | 主 Skill | 辅助 Skill |
|
||
|----------|----------|------------|
|
||
| miniprogram/ | SKILL-小程序开发.md | SKILL-三端架构与框架分析.md（框架/语法）、SKILL-API开发.md、SKILL-变更关联检查.md |
|
||
| soul-admin/ | SKILL-管理端开发.md | SKILL-三端架构与框架分析.md、SKILL-API开发.md、SKILL-变更关联检查.md |
|
||
| soul-api/ | SKILL-API开发.md | soul-api-coding.mdc、SKILL-三端架构与框架分析.md、SKILL-变更关联检查.md |
|
||
| next-project/ | SKILL-next-project仅预览.md | api-reliability.mdc（若改 Next API） |
|
||
|
||
**拆解项目时**：有类似 next-project 的 Next.js 全栈项目需拆为前后端分离 + 小程序时，使用 **SKILL-Next全栈拆解为前后端分离与小程序.md**；拆解前必读 **SKILL-三端架构与框架分析.md**（小程序/H5/UniApp 语法与框架约束）。
|
||
|
||
**变更时**：无论改哪端，改完都需过 **soul-change-checklist.mdc**，并参考 **SKILL-变更关联检查.md**。
|
||
|
||
**Skills 迭代**：Skills 会随 bug 修复与项目演进持续升级。修 bug 时若发现规则、流程或约定有遗漏或错误，应同步更新对应 Skill，避免同类问题复现。
|
||
|
||
---
|
||
|
||
## 三、无冲突、无顺序依赖
|
||
|
||
- 各 boundary 规则按目录互斥（改 miniprogram 不会触发 soul-admin-boundary）。
|
||
- soul-api-boundary 与 soul-api-coding 同作用于 soul-api，内容互补（边界 vs 编码），不冲突。
|
||
- soul-change-checklist 与各 boundary 互补（boundary 管「能做什么」，checklist 管「改完要检查什么」）。
|