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

本目录按 **cursor标准模板** 重构，rules、skills、agent 为**开发团队**服务，用于约束开发、防止互窜、经验升级。

---

## 目录结构

```
.cursor/
├── README.md                 # 本说明（入口）
├── config/                   # 配置（paths.py、workspace.txt、model_switch.json）
├── rules/                    # 规则（boundary、checklist、助理、会议、老板分身-索引）
├── skills/                   # Skills（按角色分配）
├── agent/                    # 智能体（标准开发团队结构）
│   ├── 老板分身/             # 最高权限，协调所有角色
│   ├── 开发助理/             # 规则进化、通用经验、项目索引、bat 入口
│   │   ├── evolution/        # 通用经验池
│   │   ├── script/           # 一键-列出经验池.bat、一键-添加经验.bat 等
│   │   └── 项目索引/         # 各角色开发进度（小程序.md、管理端.md 等）
│   ├── 小程序开发工程师/
│   ├── 管理端开发工程师/
│   ├── 后端工程师/
│   ├── 产品经理/
│   ├── 软件测试/
│   └── 团队/                 # 跨角色共享经验
├── scripts/                  # 共享脚本（evolution.py、经验模板.md、db-exec）
├── docs/                     # 文档（职责定义、边界、分析）
├── process/                  # 工作流
├── meeting/                  # 会议纪要（橙子生成）
└── archive/                  # 历史归档
```

---

## 开发团队

| 角色 | 负责 | 主 Skill | Agent 目录 |
|------|------|----------|------------|
| 小程序开发工程师 | miniprogram/ | SKILL-小程序开发.md | agent/小程序开发工程师/ |
| 管理端开发工程师 | soul-admin/ | SKILL-管理端开发.md | agent/管理端开发工程师/ |
| 后端开发 | soul-api/ | SKILL-API开发.md | agent/后端工程师/ |
| 产品经理 | 开发文档/1、需求/、临时需求池/ | SKILL-产品经理.md | agent/产品经理/ |
| 测试人员 | miniprogram、soul-admin、soul-api | SKILL-测试.md | agent/软件测试/ |
| 助理橙子 | 讨论后记录、经验升级 | SKILL-助理橙子-文档同步.md | agent/开发助理/ |

**经验**：每角色 `agent/{角色}/evolution/`，团队共享 `agent/团队/evolution/`。用户说「吸收经验」「升级 skills」→ 入库 + 升级 Skill；说「保存开发进度」「任务完成」→ 更新 `agent/开发助理/项目索引/{角色}.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 |
| 测试、测试用例、回归测试、功能测试、QA | `SKILL-测试.md` | - |
| 小橙、橙子、讨论完毕、记录、同步文档 | `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） | 项目组成、核心原则、会话自检 |
| 老板分身-索引 | `**`（alwaysApply） | 经验自动收集、Soul 角色推断、编码习惯 |
| 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-测试 | 变更关联检查、小程序/管理端/API 规范 |
| 助理橙子 | SKILL-助理橙子-文档同步 | - |

### 场景 Skill

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

---

## 文档与脚本

| 文档 | 说明 |
|------|------|
| [开发团队职责定义](./docs/开发团队职责定义.md) | 六角色职责、Skills 分配 |
| [三角色边界定义](./docs/三角色边界定义.md) | 开发三角色源码与业务边界 |
| [config/目录地图](./config/目录地图.md) | paths.py 路径别名 |
| [meeting/](./meeting/) | 会议纪要（橙子生成） |
| [经验清单](./agent/开发助理/经验清单.md) | 跨角色经验索引 |
| evolution 脚本 | `python .cursor/scripts/evolution.py list` 列出经验池；`add --stdin` 添加经验 |
| 一键 bat | `agent/开发助理/script/一键-列出经验池.bat` 等 |

---

## 会话启动自检

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