# Soul 创业派对 - .cursor 配置说明

本目录的 rules 与 skills 为**开发团队**服务，用于约束开发、防止互窜、经验升级。

---

## 目录结构

```
.cursor/
├── README.md                 # 本说明（入口）
├── rules/                    # 规则（boundary、checklist、助理、会议）
├── skills/                   # Skills（按角色分配）
├── docs/                     # 文档（职责定义、边界、分析）
├── 经验库/                   # 经验沉淀，用于自动升级 Skills
│   ├── README.md
│   ├── 经验清单.md
│   └── {小程序/管理端/后端/产品/助理橙子/团队}/
└── 会议记录/                 # 多角色会议纪要（橙子生成）
    ├── README.md
    ├── _模板.md
    └── YYYY-MM-DD_主题.md
```

---

## 开发团队

| 角色 | 负责 | 主 Skill |
|------|------|----------|
| 小程序开发工程师 | miniprogram/ | SKILL-小程序开发.md |
| 管理端开发工程师 | soul-admin/ | SKILL-管理端开发.md |
| 后端开发 | soul-api/ | SKILL-API开发.md（说「后端」「API」也可触发） |
| 产品经理 | 开发文档/1、需求/、临时需求池/ | SKILL-产品经理.md |
| 助理橙子 | 讨论后记录、经验升级 | SKILL-助理橙子-文档同步.md |

**经验库**：每角色独立文件夹 + 团队（跨角色共享）。用户说「吸收经验」「升级 skills」→ 入库 + 升级 Skill；说「保存开发进度」「任务完成」「搞定了」→ 更新项目索引。详见 [经验库 README](./经验库/README.md)。

---

## 快速决策（必须 Read = 使用 Read 工具读取完整内容）

| 编辑/场景 | 必须 Read 的 Skill | 自动加载的 Rule |
|-----------|-------------------|----------------|
| miniprogram/ | `SKILL-小程序开发.md` | soul-miniprogram-boundary |
| soul-admin/ | `SKILL-管理端开发.md` | soul-admin-boundary |
| soul-api/ | `SKILL-API开发.md` | soul-api |
| 开发文档/1、需求/、临时需求池/ | `SKILL-产品经理.md` | product-manager |
| 小橙、橙子、讨论完毕、记录、同步文档 | `SKILL-助理橙子-文档同步.md` | assistant-xiaofeng |
| 吸收经验、升级 skills、保存开发进度、任务完成、搞定了 | `SKILL-助理橙子-文档同步.md` | assistant-xiaofeng |
| 跨端功能开发 | `SKILL-角色流程控制.md` | - |
| 变更完成 | `SKILL-变更关联检查.md` | soul-change-checklist |
| 开个会、团队会议、需求评审、方案讨论 | `SKILL-团队会议.md` | soul-meeting |
| 会议结束、散会 | `SKILL-助理橙子-文档同步.md`（会议收尾） | soul-meeting |

---

## Rules 一览

| 规则 | 生效范围 | 用途 |
|------|----------|------|
| soul-project-boundary | `**`（alwaysApply） | 项目组成、核心原则、会话自检 |
| soul-change-checklist | miniprogram、soul-admin、soul-api | 变更后必过 |
| assistant-xiaofeng | 触发词 | 小橙触发器 → SKILL-助理橙子-文档同步 |
| soul-miniprogram-boundary | miniprogram/** | 只调 /api/miniprogram/* |
| soul-admin-boundary | soul-admin/** | 只调 /api/admin/*、/api/db/* |
| soul-api | soul-api/** | 路由边界 + 编码规范（合并版） |
| product-manager | 开发文档/1、需求/、临时需求池/ | 产品经理 glob 触发 |
| soul-meeting | 触发词 | 开个会、团队会议、需求评审 → SKILL-团队会议 |

---

## Skills 一览

### 角色主 Skill

| 角色 | 主 Skill | 辅助 Skill |
|------|----------|------------|
| 小程序开发工程师 | SKILL-小程序开发 | 三端架构 → API开发 → 变更关联检查 |
| 管理端开发工程师 | SKILL-管理端开发 | 三端架构 → API开发 → 变更关联检查 |
| 后端开发 | SKILL-API开发 | soul-api 规范 → 三端架构 → 变更关联检查 → MySQL直接操作 |
| 产品经理 | SKILL-产品经理 | 需求汇总、运营与变更 |
| 助理橙子 | SKILL-助理橙子-文档同步 | - |

### 场景 Skill

| 场景 | Skill |
|------|-------|
| 跨端协同 | SKILL-角色流程控制 |
| 变更检查 | SKILL-变更关联检查、soul-change-checklist |
| 文档同步、经验升级 | SKILL-助理橙子-文档同步 |
| **多角色会议** | **SKILL-团队会议** |
| next-project | SKILL-next-project仅预览 |
| 项目拆解 | SKILL-Next全栈拆解为前后端分离与小程序 |

---

## 文档索引

| 文档 | 说明 |
|------|------|
| [开发团队职责定义](./docs/开发团队职责定义.md) | 五角色职责、Skills 分配 |
| [三角色边界定义](./docs/三角色边界定义.md) | 开发三角色源码与业务边界 |
| [角色驱动Skills分析](./docs/角色驱动Skills分析.md) | Skills 组织方式 |
| [经验库 README](./经验库/README.md) | 经验入库、Skills 升级流程 |

---

## 会话启动自检

新 Cursor 打开本项目时，优先执行 soul-project-boundary 中的「会话启动自检」：仅沿用本项目的 rules、skills、开发风格与配置，排除无关规则。