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

150 lines
6.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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