soul-yongping/.cursor/docs/开发团队职责定义.md

# Soul 创业派对 - 开发团队职责定义

> **开发团队**：2 前端 + 1 后端 + 1 产品 + 1 测试 + 1 助理。按职责分配 Skills，有**经验库**用于根据经验自动升级 Skills。速查见 [.cursor/README.md](../README.md)。

---

## 一、开发团队总览

| 角色 | 职责 | 负责目录/场景 | 主 Skill |
|------|------|---------------|----------|
| **小程序开发工程师** | 微信原生小程序 C 端 | miniprogram/ | SKILL-小程序开发.md |
| **管理端开发工程师** | React 管理后台 | soul-admin/ | SKILL-管理端开发.md |
| **后端开发** | Go + Gin + GORM 接口服务 | soul-api/ | SKILL-API开发.md |
| **产品经理** | 需求、验收、协调 | 开发文档/1、需求/、临时需求池/ | SKILL-产品经理.md |
| **测试人员** | 功能测试、回归测试、三端联调 | miniprogram、soul-admin、soul-api | SKILL-测试.md |
| **助理橙子** | 讨论后记录、文档同步 | 触发词：小橙、橙子、讨论完毕 | SKILL-助理橙子-文档同步.md |

---

## 二、开发角色（源码）

### 2.1 小程序开发工程师

| 项目 | 说明 |
|------|------|
| **源码** | miniprogram/pages、utils、components、app.js |
| **API** | 只调 `/api/miniprogram/*` |
| **禁止** | 不调 `/api/admin/*`、`/api/db/*` |
| **主 Skill** | SKILL-小程序开发.md |
| **辅助** | 三端架构 → API开发 → 变更关联检查 |
| **协同** | SKILL-角色流程控制.md（跨端时） |

### 2.2 管理端开发工程师

| 项目 | 说明 |
|------|------|
| **源码** | soul-admin/src/pages、components、api、layouts |
| **API** | 只调 `/api/admin/*`、`/api/db/*`、`/api/orders` 等 |
| **禁止** | 不调 `/api/miniprogram/*` |
| **主 Skill** | SKILL-管理端开发.md |
| **辅助** | 三端架构 → API开发 → 变更关联检查 |
| **协同** | SKILL-角色流程控制.md（跨端时） |

### 2.3 后端开发

| 项目 | 说明 |
|------|------|
| **源码** | soul-api/internal/router、handler、model、wechat、config |
| **路由** | 按使用方挂 miniprogram / admin / db / payment |
| **主 Skill** | SKILL-API开发.md |
| **辅助** | soul-api 规范 → 三端架构 → 变更关联检查 → MySQL直接操作 |
| **协同** | SKILL-角色流程控制.md（跨端时） |

---

## 三、非开发角色

### 3.1 产品经理

| 项目 | 说明 |
|------|------|
| **职责** | 需求分析、需求文档、验收标准、与开发协调 |
| **文档** | 开发文档/1、需求/、临时需求池/、开发文档/10、项目管理/ |
| **主 Skill** | SKILL-产品经理.md |
| **产出** | 需求汇总、需求分析、验收清单、项目推进表 |

### 3.2 测试人员

| 项目 | 说明 |
|------|------|
| **职责** | 功能测试、回归测试、三端（小程序、管理端、API）联调验证 |
| **测试范围** | miniprogram、soul-admin、soul-api |
| **主 Skill** | SKILL-测试.md |
| **产出** | 测试用例、测试报告、Bug 列表 |
| **协同** | 与开发角色对接 Bug、验收前测试 |

### 3.3 助理橙子

| 项目 | 说明 |
|------|------|
| **职责** | 讨论后记录、文档同步、更新开发文档 |
| **触发** | 小橙、橙子、橙橙、🍊、「讨论完毕」「记录一下」「同步到开发文档」 |
| **主 Skill** | SKILL-助理橙子-文档同步.md |
| **规则** | assistant-xiaofeng.mdc |

---

## 四、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-助理橙子-文档同步 | 讨论完毕、记录、同步文档 |
| next-project | SKILL-next-project仅预览 | 编辑 next-project/ 或区分线上后端 |

---

## 五、角色推断

| 触发条件 | 推断角色 | 加载 |
|----------|----------|------|
| 编辑 miniprogram/** | 小程序开发工程师 | SKILL-小程序开发 + soul-miniprogram-boundary |
| 编辑 soul-admin/** | 管理端开发工程师 | SKILL-管理端开发 + soul-admin-boundary |
| 编辑 soul-api/** | 后端开发 | SKILL-API开发 + soul-api |
| 编辑 开发文档/1、需求/、临时需求池/ | 产品经理 | SKILL-产品经理 |
| 说 测试、测试用例、回归测试、功能测试、QA | 测试人员 | SKILL-测试 |
| 说 小橙、橙子、讨论完毕、记录、同步文档 | 助理橙子 | SKILL-助理橙子-文档同步 |

---

## 六、开发团队经验库

| 项目 | 说明 |
|------|------|
| **位置** | `.cursor/agent/*/evolution/`，每角色独立 evolution 目录 |
| **项目索引** | 每角色有 `项目索引.md`，根据开发进度做总结、保存进度，**每次保存写日期** |
| **经验存储** | 按天存储，文件名 `YYYY-MM-DD.md`，在对应角色文件夹下 |
| **用途** | 沉淀 bug 修复、最佳实践、决策、踩坑；根据经验**自动升级 Skills** |
| **触发** | 用户说「吸收经验」「升级 skills」「记录经验」→ 助理橙子执行入库 + 升级 |
| **流程** | 提炼 → 写入 `{角色}/YYYY-MM-DD.md` → 更新 `{角色}/项目索引.md` → 更新 `经验清单.md` → 升级 SKILL |

详见 [经验清单](../agent/开发助理/经验清单.md)、[.cursor README](../README.md)。

---

## 七、相关文档

| 文档 | 说明 |
|------|------|
| [经验清单](../agent/开发助理/经验清单.md) | 经验索引、Skills 升级触发 |
| [三角色边界定义](./三角色边界定义.md) | 开发三角色源码与业务边界 |
| [角色驱动Skills分析](./角色驱动Skills分析.md) | Skills 组织方式 |
| [SKILL-角色流程控制](../skills/role-flow-control/SKILL.md) | 跨端协同流程 |

---

**更新日期**：2026-02