fnvtk/soul-yongping
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新开发文档，调整团队角色及其技能描述，优化文档结构以明确各角色的责任与协作流程。增强经验库功能，支持经验吸收与技能升级，提升团队协作效率。

Browse Source
This commit is contained in:
Alex-larget
2026-02-26 18:55:22 +08:00
parent 1f175800fe
commit 32c222f241
6 changed files with 94 additions and 139 deletions
Download Patch File Download Diff File Expand all files Collapse all files

185
.cursor/README.md
View File

@@ -1,149 +1,104 @@
# Soul 创业派对 - .cursor 配置说明
本目录的 rules 与 skills 均为**当前项目（Soul 创业派对）**服务，用于约束开发、防止互窜、减少漏改。
**开发团队**：2 前端（小程序开发工程师、管理端开发工程师）+ 1 后端 + 1 产品经理 + 1 助理橙子。开发团队有**经验库**，根据经验自动升级 Skills。完整职责与 Skills 分配见 [开发团队职责定义.md](./docs/开发团队职责定义.md)，经验库见 [经验库 README](./经验库/README.md)。
**会话启动自检**：新 Cursor 打开本项目时，应优先执行 soul-project-boundary 中的「会话启动自检」，仅沿用本项目的 rules、skills、开发风格与配置参数，排除无关的全局或其它项目规则。
本目录的 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） |
| **product-manager.mdc** | 开发文档/1、需求/、临时需求池/、开发文档/10、项目管理/ | ❌ | 产品经理：需求、验收，加载 SKILL-产品经理 |
**执行逻辑**：alwaysApply 的规则始终生效；其余按当前编辑文件路径匹配 glob，匹配到的规则同时生效，无先后依赖。
---
## 二、Skills 索引（按团队角色驱动）
团队：**小程序开发工程师**、**管理端开发工程师**、**后端开发**、**产品经理**、**助理橙子**。各开发角色在各自端内**必须**遵循对应主 Skill；辅助 Skill 按「何时选用」选用。
### 速查：目录/场景 → 角色 → 应加载 Skills
| 当前编辑目录/场景 | 角色 | 主 Skill | 辅助 Skill（按需） |
|------------------|------|----------|--------------------|
| miniprogram/ | 小程序开发工程师 | SKILL-小程序开发.md | 三端架构 → API开发 → 变更关联检查 |
| soul-admin/ | 管理端开发工程师 | SKILL-管理端开发.md | 三端架构 → API开发 → 变更关联检查 |
| soul-api/ | 后端开发 | SKILL-API开发.md | soul-api-coding → 三端架构 → 变更关联检查 → MySQL直接操作 |
| 开发文档/1、需求/、临时需求池/ | 产品经理 | SKILL-产品经理.md | 需求汇总、运营与变更 |
| 说 小橙、橙子、讨论完毕、记录、同步文档 | 助理橙子 | SKILL-助理橙子-文档同步.md | - |
**跨端功能开发**：加载 **SKILL-角色流程控制.md**。
**变更完成**：**必过** **SKILL-变更关联检查.md** + **soul-change-checklist.mdc**。
### 快速决策（Agent 执行时）
## 目录结构
```
当前编辑目录？
→ miniprogram/ → 主：SKILL-小程序开发
→ soul-admin/ → 主：SKILL-管理端开发
→ soul-api/ → 主：SKILL-API开发
→ 开发文档/1、需求/、临时需求池/ → 主：SKILL-产品经理
说 小橙橙子讨论完毕记录同步？ → 主：SKILL-助理橙子-文档同步
涉及多端？ → 加载 SKILL-角色流程控制
改完准备提交？ → 必过 SKILL-变更关联检查 + soul-change-checklist
API 需操作数据库且 MCP 不可用？ → 加载 SKILL-MySQL直接操作
.cursor/
├── README.md # 本说明（入口）
├── rules/ # 规则（boundary、checklist、助理）
├── skills/ # Skills（按角色分配）
├── docs/ # 文档（职责定义、边界、分析）
└── 经验库/ # 经验沉淀，用于自动升级 Skills
├── README.md
└── 经验清单.md
```
---
### 角色一：小程序开发工程师
## 开发团队
| 类型 | Skill | 何时选用 |
|------|-------|----------|
| **主** | SKILL-小程序开发.md | 在 miniprogram/ 下编辑时**必加载** |
| 辅助 1 | SKILL-三端架构与框架分析.md | 拆解/迁移、选用框架语法时 |
| 辅助 2 | SKILL-API开发.md | 对接新接口、确认 miniprogram 路径时 |
| 辅助 3 | SKILL-变更关联检查.md | 变更完成后，过三端关联 |
| 协同 | SKILL-角色流程控制.md | 跨端功能开发（新增/优化）时 |
| 角色 | 负责 | 主 Skill |
|------|------|----------|
| 小程序开发工程师 | miniprogram/ | SKILL-小程序开发.md |
| 管理端开发工程师 | soul-admin/ | SKILL-管理端开发.md |
| 后端开发 | soul-api/ | SKILL-API开发.md |
| 产品经理 | 开发文档/1、需求/、临时需求池/ | SKILL-产品经理.md |
| 助理橙子 | 讨论后记录、经验升级 | SKILL-助理橙子-文档同步.md |
**负责**：miniprogram/
**经验库**：用户说「吸收经验」「升级 skills」→ 助理橙子执行入库 + 升级对应 Skill。详见 [经验库 README](./经验库/README.md)。
---
### 角色二：管理端开发工程师
## 快速决策
| 类型 | Skill | 何时选用 |
|------|-------|----------|
| **主** | SKILL-管理端开发.md | 在 soul-admin/ 下编辑时**必加载** |
| 辅助 1 | SKILL-三端架构与框架分析.md | 拆解/迁移、选用框架语法时 |
| 辅助 2 | SKILL-API开发.md | 对接新接口、确认 admin/db 路径时 |
| 辅助 3 | SKILL-变更关联检查.md | 变更完成后，过三端关联 |
| 协同 | SKILL-角色流程控制.md | 跨端功能开发时 |
**负责**：soul-admin/
| 编辑/场景 | 加载 |
|-----------|------|
| miniprogram/ | SKILL-小程序开发 + soul-miniprogram-boundary |
| soul-admin/ | SKILL-管理端开发 + soul-admin-boundary |
| soul-api/ | SKILL-API开发 + soul-api-boundary、soul-api-coding |
| 开发文档/1、需求/、临时需求池/ | SKILL-产品经理 |
| 小橙、橙子、讨论完毕、记录、同步文档 | SKILL-助理橙子-文档同步 |
| 吸收经验、升级 skills | 助理橙子：经验入库 + 升级 Skill |
| 跨端功能开发 | SKILL-角色流程控制（流程图见 docs/角色协同流程图.html） |
| 变更完成 | 必过 SKILL-变更关联检查 + soul-change-checklist |
---
### 角色三：后端开发
## Rules 一览
| 类型 | 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/
| 规则 | 生效范围 | 用途 |
|------|----------|------|
| soul-project-boundary | `**` | 总入口、防互窜、会话自检 |
| soul-change-checklist | miniprogram、soul-admin、soul-api | 变更后必过 |
| assistant-xiaofeng | 触发词 | 小橙：文档同步、经验升级 |
| soul-miniprogram-boundary | miniprogram/** | 只调 /api/miniprogram/* |
| soul-admin-boundary | soul-admin/** | 只调 /api/admin/*、/api/db/* |
| soul-api-boundary | soul-api/**/*.go | 路由按使用方归类 |
| soul-api-coding | soul-api/**/*.go | GORM、Model、响应规范 |
| product-manager | 开发文档/1、需求/、临时需求池/ | 产品经理 |
| api-reliability | next-project/** | 仅 next-project 参考 |
---
### 角色四：产品经理
## Skills 一览
| 类型 | Skill | 何时选用 |
|------|-------|----------|
| **主** | SKILL-产品经理.md | 需求分析、需求文档、验收、编辑 开发文档/1、需求/、临时需求池/ 时 |
| 辅助 | 需求汇总、运营与变更 | 查阅需求清单、项目推进表时 |
### 角色主 Skill
**负责**：需求、验收、与开发协调
| 角色 | 主 Skill | 辅助 Skill |
|------|----------|------------|
| 小程序开发工程师 | SKILL-小程序开发 | 三端架构 → API开发 → 变更关联检查 |
| 管理端开发工程师 | SKILL-管理端开发 | 三端架构 → API开发 → 变更关联检查 |
| 后端开发 | SKILL-API开发 | soul-api-coding → 三端架构 → 变更关联检查 → MySQL直接操作 |
| 产品经理 | SKILL-产品经理 | 需求汇总、运营与变更 |
| 助理橙子 | SKILL-助理橙子-文档同步 | - |
### 场景 Skill
| 场景 | Skill |
|------|-------|
| 跨端协同 | SKILL-角色流程控制 |
| 变更检查 | SKILL-变更关联检查、soul-change-checklist |
| 文档同步、经验升级 | SKILL-助理橙子-文档同步 |
| next-project | SKILL-next-project仅预览 |
| 项目拆解 | SKILL-Next全栈拆解为前后端分离与小程序 |
---
### 角色五：助理橙子
## 文档索引
| 类型 | Skill | 何时选用 |
|------|-------|----------|
| **主** | SKILL-助理橙子-文档同步.md | 小橙、橙子、橙橙、🍊、「讨论完毕」「记录一下」「同步到开发文档」 |
| 规则 | assistant-xiaofeng.mdc | 同上 |
**负责**：讨论后记录、文档同步
| 文档 | 说明 |
|------|------|
| [开发团队职责定义](./docs/开发团队职责定义.md) | 五角色职责、Skills 分配 |
| [三角色边界定义](./docs/三角色边界定义.md) | 开发三角色源码与业务边界 |
| [角色驱动Skills分析](./docs/角色驱动Skills分析.md) | Skills 组织方式 |
| [经验库 README](./经验库/README.md) | 经验入库、Skills 升级流程 |
---
### 通用 / 场景 Skill
## 会话启动自检
| 场景 | Skill | 何时选用 |
|------|-------|----------|
| 跨端协同 | SKILL-角色流程控制.md | 开发涉及多端时；流程图见 `.cursor/docs/角色协同流程图.html` |
| 变更检查 | SKILL-变更关联检查.md、soul-change-checklist.mdc | **开发改完必过** |
| 文档同步 | SKILL-助理橙子-文档同步.md | 讨论完毕、记录、同步文档 |
| next-project | SKILL-next-project仅预览.md | 编辑 next-project/ 或需区分线上后端时 |
| 项目拆解 | SKILL-Next全栈拆解为前后端分离与小程序.md | 拆解 Next.js 全栈时；拆解前必读 SKILL-三端架构与框架分析.md |
**助理橙子**：当用户说小橙、橙子、橙橙、🍊、「讨论完毕」「记录一下」「同步到开发文档」等时，加载 **SKILL-助理橙子-文档同步.md**，以小橙身份记录讨论要点并更新 `开发文档/`、`临时需求池/`。
**Skills 迭代**：开发团队经验库（`.cursor/经验库/`）沉淀经验，根据经验自动升级 Skills。用户说「吸收经验」「升级 skills」时，助理橙子执行：提炼 → 入库 → 更新对应 Skill。修 bug 时若发现规则/流程遗漏，建议写入经验库并升级 Skill。详见 [经验库 README](./经验库/README.md)。
---
## 三、无冲突、无顺序依赖
- 各 boundary 规则按目录互斥（改 miniprogram 不会触发 soul-admin-boundary）。
- soul-api-boundary 与 soul-api-coding 同作用于 soul-api，内容互补（边界 vs 编码），不冲突。
- soul-change-checklist 与各 boundary 互补（boundary 管「能做什么」，checklist 管「改完要检查什么」）。
新 Cursor 打开本项目时，优先执行 soul-project-boundary 中的「会话启动自检」：仅沿用本项目的 rules、skills、开发风格与配置，排除无关规则。