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 | ❌ | 变更后必过：关联层检查清单，防漏改 |
| assistant-xiaofeng.mdc | ** | ❌ | 小橙/橙子/橙橙/🍊：讨论后记录并更新开发文档 |
| 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 按「何时选用」选用，顺序表示推荐查阅先后。
速查：目录 → 角色 → 应加载 Skills
| 当前编辑目录 | 当前角色 | 主 Skill（必加载） | 辅助 Skill（按需） |
|---|---|---|---|
| miniprogram/ | 小程序开发者 | SKILL-小程序开发.md | 三端架构 → API开发 → 变更关联检查 |
| soul-admin/ | 管理端开发者 | SKILL-管理端开发.md | 三端架构 → API开发 → 变更关联检查 |
| soul-api/ | 后端 API 开发者 | SKILL-API开发.md | soul-api-coding → 三端架构 → 变更关联检查 → MySQL直接操作 |
跨端功能开发时：无论当前角色，加载 SKILL-角色流程控制.md。
变更完成后：无论当前角色，必过 SKILL-变更关联检查.md + soul-change-checklist.mdc。
快速决策（Agent 执行时）
当前编辑目录？
→ miniprogram/ → 主：SKILL-小程序开发
→ soul-admin/ → 主：SKILL-管理端开发
→ soul-api/ → 主：SKILL-API开发
涉及多端？ → 加载 SKILL-角色流程控制
改完准备提交？ → 必过 SKILL-变更关联检查 + soul-change-checklist
API 需操作数据库且 MCP 不可用？ → 加载 SKILL-MySQL直接操作
角色一：小程序开发者
| 类型 | Skill | 何时选用 |
|---|---|---|
| 主 | SKILL-小程序开发.md | 在 miniprogram/ 下编辑时必加载 |
| 辅助 1 | SKILL-三端架构与框架分析.md | 拆解/迁移、选用框架语法时 |
| 辅助 2 | SKILL-API开发.md | 对接新接口、确认 miniprogram 路径时 |
| 辅助 3 | SKILL-变更关联检查.md | 变更完成后，过三端关联 |
| 协同 | SKILL-角色流程控制.md | 跨端功能开发（新增/优化）时 |
负责目录：miniprogram/
角色二：管理端开发者
| 类型 | Skill | 何时选用 |
|---|---|---|
| 主 | SKILL-管理端开发.md | 在 soul-admin/ 下编辑时必加载 |
| 辅助 1 | SKILL-三端架构与框架分析.md | 拆解/迁移、选用框架语法时 |
| 辅助 2 | SKILL-API开发.md | 对接新接口、确认 admin/db 路径时 |
| 辅助 3 | SKILL-变更关联检查.md | 变更完成后，过三端关联 |
| 协同 | SKILL-角色流程控制.md | 跨端功能开发时 |
负责目录：soul-admin/
角色三：后端 API 开发者
| 类型 | Skill | 何时选用 |
|---|---|---|
| 主 | SKILL-API开发.md | 在 soul-api/ 下编辑时必加载 |
| 辅助 1 | soul-api-coding.mdc | 与主 Skill 一致，按 glob 自动生效 |
| 辅助 2 | SKILL-三端架构与框架分析.md | 路由分组、框架约束时 |
| 辅助 3 | SKILL-变更关联检查.md | 变更完成后，过三端关联 |
| 辅助 4 | SKILL-MySQL直接操作.md | MCP 无法连接、需增减字段/执行迁移时 |
| 协同 | SKILL-角色流程控制.md | 跨端功能开发时 |
负责目录：soul-api/
通用 / 场景 Skill
| 场景 | Skill | 何时选用 |
|---|---|---|
| 跨端协同 | SKILL-角色流程控制.md | 小程序/管理端/API 任一有功能开发且涉及多端时；流程图见 .cursor/docs/角色协同流程图.html |
| 变更检查 | SKILL-变更关联检查.md、soul-change-checklist.mdc | 无论改哪端，改完必过 |
| 文档同步 | SKILL-助理小风-文档同步.md | 讨论完毕、记录内容、同步到开发文档时；对应规则 assistant-xiaofeng.mdc |
| next-project | SKILL-next-project仅预览.md | 编辑 next-project/ 或需区分线上后端时 |
| 项目拆解 | SKILL-Next全栈拆解为前后端分离与小程序.md | 拆解 Next.js 全栈时；拆解前必读 SKILL-三端架构与框架分析.md |
小橙（橙子/橙橙/🍊）：当用户说小橙、橙子、橙橙、🍊、「讨论完毕」「记录一下」「同步到开发文档」等时，加载 SKILL-助理小风-文档同步.md，以小橙身份记录讨论要点并更新 开发文档/、临时需求池/，保持项目文档与讨论结论一致。
Skills 迭代：Skills 会随 bug 修复与项目演进持续升级。修 bug 时若发现规则、流程或约定有遗漏或错误，应同步更新对应 Skill，避免同类问题复现。详见 .cursor/docs/角色驱动Skills分析.md。
三、无冲突、无顺序依赖
- 各 boundary 规则按目录互斥（改 miniprogram 不会触发 soul-admin-boundary）。
- soul-api-boundary 与 soul-api-coding 同作用于 soul-api，内容互补（边界 vs 编码），不冲突。
- soul-change-checklist 与各 boundary 互补（boundary 管「能做什么」，checklist 管「改完要检查什么」）。