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 管「改完要检查什么」)。