soul-yongping/.cursor/README.md

# 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 按「何时选用」选用，顺序表示推荐查阅先后。

### 速查：目录 → 角色 → 应加载 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 | **无论改哪端，改完必过** |
| next-project | SKILL-next-project仅预览.md | 编辑 next-project/ 或需区分线上后端时 |
| 项目拆解 | SKILL-Next全栈拆解为前后端分离与小程序.md | 拆解 Next.js 全栈时；拆解前必读 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 管「改完要检查什么」）。