docs: 添加业务模块智能体目录及相关文件结构说明

2026-04-15 15:52:11 +08:00
parent c6ea6609cd
commit 524dee9d3c
6 changed files with 352 additions and 0 deletions
--- a/玩值AI/SKILL.md
+++ b/玩值AI/SKILL.md
@@ -276,6 +276,12 @@
 ```
 玩值AI/
 ├── SKILL.md                 ← 总控（本文件）
+├── 业务模块智能体/             ← 按业务模块调度配置
+│   ├── README.md
+│   ├── base-config.yaml
+│   ├── module-agents.json
+│   ├── dispatcher-prompt.md
+│   └── 乘风_智能体合并分工_基于env.md
 ├── references/               ← 共享参考资料
 │   └── 玩值电竞开发参考资料.md
 ├── scripts/
--- a/玩值AI/业务模块智能体/README.md
+++ b/玩值AI/业务模块智能体/README.md
@@ -0,0 +1,45 @@
+# 业务模块智能体 · 入口说明
+
+> 目标：按业务功能模块分配任务，而不是只按岗位分配。  
+> 位置：`玩值AI/业务模块智能体/`
+
+## 1. 文件结构
+
+- `base-config.yaml`：总开关、调度规则、质量门禁、复盘格式。
+- `module-agents.json`：模块级智能体清单（负责人、协作人、路由、API、数据集合）。
+- `dispatcher-prompt.md`：可直接复制给总控智能体的调度提示词模板。
+
+## 2. 当前业务模块（13个）
+
+- `用户与身份`
+- `内容与推荐`
+- `消息与聊天`
+- `星球生态`
+- `商城与订单`
+- `服务市场`
+- `酒店与网咖`
+- `账号交易与典当`
+- `大屏与数据看板`
+- `AI互动与任务撮合`
+- `用户资产数字化`
+- `环境与数据库集成`
+- `直播云厂商配置与鉴权`
+
+## 3. 调度规则（简版）
+
+- 先识别需求属于哪个业务模块（可多选）。
+- 每个模块只设 1 个主责智能体，协作人按依赖拉起。
+- 跨模块需求由 `module-dispatcher` 拆成子任务，并行推进。
+- 完成后统一输出：完成项、风险、下一步、进度变化。
+
+## 4. 与现有五人体系关系
+
+- 本目录是“业务模块视角”。
+- `玩值AI/SKILL.md` 和五人子 SKILL 是“岗位视角”。
+- 两套并行：模块决定“做哪块”，岗位决定“谁来做”。
+
+## 5. 合并智能体策略（乘风安排）
+
+- `联调执行组（合并）`：李玩 + 陈电（前后端一体推进接口联调）。
+- `环境安全组（合并）`：刘竞 + 张星（环境变量、数据库、部署与密钥治理）。
+- `进度验收组`：王值（需求拆解、验收口径、日志与复盘收口）。
--- a/玩值AI/业务模块智能体/base-config.yaml
+++ b/玩值AI/业务模块智能体/base-config.yaml
@@ -0,0 +1,56 @@
+version: 1.0.0
+project:
+  name: 玩值电竞 App
+  repo_root: E:/Gongsi/Maokaka/Gitea/Wanzhi
+  default_language: zh-CN
+  absorbed_files:
+    - ".env.example"
+
+agent_merge:
+  enabled: true
+  groups:
+    - name: "联调执行组"
+      members: ["李玩", "陈电"]
+      focus: "前后端联调与接口闭环"
+    - name: "环境安全组"
+      members: ["刘竞", "张星"]
+      focus: "环境变量、数据库连接、部署与密钥治理"
+    - name: "进度验收组"
+      members: ["王值"]
+      focus: "需求拆解、验收标准、进度与日志收口"
+
+dispatcher:
+  id: module-dispatcher
+  policy:
+    assign_mode: "by_business_module"
+    allow_multi_module: true
+    max_primary_owner_per_module: 1
+    require_owner_in_first_reply: true
+  required_output:
+    - 本次执行模块
+    - 本次主责人
+    - 协作人
+    - 已完成事项
+    - 风险与阻塞
+    - 下一步
+
+memory:
+  progress_doc: "玩值开发文档/10、项目管理/开发进度总表.md"
+  worklog_doc: "玩值开发文档/10、项目管理/工作日志.md"
+  analysis_doc: "玩值开发文档/10、项目管理/玩值电竞项目全量分析.md"
+  sync_on_finish: true
+
+quality_gates:
+  - name: route_mapping_check
+    desc: "新增页面需补充到模块路由映射"
+  - name: api_contract_check
+    desc: "前后端联调前先核对请求/响应契约"
+  - name: data_consistency_check
+    desc: "新增字段需同步数据库文档与索引策略"
+  - name: deploy_readiness_check
+    desc: "上线前确认环境变量、端口、回滚方案"
+
+fallback:
+  no_match_module: "需求与验收"
+  owner: "王值"
+  escalate_to: "火炬"
--- a/玩值AI/业务模块智能体/dispatcher-prompt.md
+++ b/玩值AI/业务模块智能体/dispatcher-prompt.md
@@ -0,0 +1,53 @@
+# Module Dispatcher Prompt
+
+你是 `module-dispatcher`，负责将需求按“业务功能模块”拆解并分配给主责智能体。
+
+## 输入
+
+- 用户原始需求
+- `base-config.yaml`
+- `module-agents.json`
+- `.env.example`（当需求涉及环境变量、直播云配置、数据库连接时必读）
+
+## 执行步骤
+
+1. 从需求中识别命中模块（可多选）。
+2. 每个模块仅指定 1 名主责人，并列出协作人。
+3. 输出该模块涉及的：
+   - 前端路径
+   - 管理端路径
+   - API 路径
+   - 数据集合
+4. 如果需求跨模块，按“先依赖后功能”排序执行。
+5. 若未命中任何模块，回退到 `fallback.owner`（默认王值），并说明原因。
+6. 若命中“环境与数据库集成”或“直播云厂商配置与鉴权”，优先拉起合并组协同（联调执行组/环境安全组）。
+
+## 输出模板
+
+```md
+本次执行模块：<模块A[, 模块B]>
+本次主责人：<姓名>
+协作人：<姓名列表>
+
+任务拆解：
+1) <子任务1>
+2) <子任务2>
+
+影响范围：
+- 前端：<path 列表>
+- 管理端：<path 列表>
+- API：<path 列表>
+- 数据：<collection 列表>
+
+风险与阻塞：
+- <风险1>
+
+下一步：
+- <next step>
+```
+
+## 固定约束
+
+- 回复必须中文简体。
+- 必须显式写出“本次执行模块”和“本次主责人”。
+- 若涉及数据变更，必须提醒同步 `数据库.md` 与索引策略。
--- a/玩值AI/业务模块智能体/module-agents.json
+++ b/玩值AI/业务模块智能体/module-agents.json
@@ -0,0 +1,149 @@
+{
+  "version": "1.0.0",
+  "dispatcher": "module-dispatcher",
+  "agents": [
+    {
+      "id": "mod-user-identity",
+      "module": "用户与身份",
+      "owner": "陈电",
+      "collaborators": ["李玩", "王值"],
+      "keywords": ["登录", "注册", "鉴权", "会员", "钱包", "充值", "profile", "vip"],
+      "frontend_paths": ["app/login", "app/profile", "app/vip", "app/recharge"],
+      "admin_paths": ["app/admin/users"],
+      "api_paths": ["app/api/auth", "app/api/user", "app/api/admin/users", "app/api/admin/auth"],
+      "collections": ["users", "wallet", "vip"]
+    },
+    {
+      "id": "mod-content-recommendation",
+      "module": "内容与推荐",
+      "owner": "李玩",
+      "collaborators": ["陈电"],
+      "keywords": ["首页", "动态", "推荐", "直播流", "moments", "live feed"],
+      "frontend_paths": ["app/page.tsx", "app/moments", "app/live", "app/zone"],
+      "admin_paths": ["app/admin/content", "app/admin/live"],
+      "api_paths": ["app/api/admin/content", "app/api/admin/live", "app/api/live"],
+      "collections": ["moments", "momentComments", "liveRooms"]
+    },
+    {
+      "id": "mod-message-chat",
+      "module": "消息与聊天",
+      "owner": "李玩",
+      "collaborators": ["陈电"],
+      "keywords": ["消息", "聊天", "会话", "聊天室", "party", "chat"],
+      "frontend_paths": ["app/messages", "app/chat", "app/party"],
+      "admin_paths": ["app/admin/party"],
+      "api_paths": ["app/api/admin/party"],
+      "collections": ["chatRooms", "chatMessages"]
+    },
+    {
+      "id": "mod-planet-ecosystem",
+      "module": "星球生态",
+      "owner": "李玩",
+      "collaborators": ["陈电", "王值"],
+      "keywords": ["星球", "明星", "公会", "cp", "陪练", "planet", "guild", "star"],
+      "frontend_paths": ["app/planet", "app/star", "app/guild", "app/cp", "app/coach"],
+      "admin_paths": ["app/admin/guilds", "app/admin/stars", "app/admin/streamers"],
+      "api_paths": ["app/api/admin/guilds", "app/api/admin/stars", "app/api/admin/streamers"],
+      "collections": ["stars", "guilds", "matches"]
+    },
+    {
+      "id": "mod-mall-order",
+      "module": "商城与订单",
+      "owner": "陈电",
+      "collaborators": ["李玩"],
+      "keywords": ["商城", "商品", "订单", "支付", "mall", "orders", "products"],
+      "frontend_paths": ["app/mall", "app/orders", "app/recharge"],
+      "admin_paths": ["app/admin/mall", "app/admin/orders"],
+      "api_paths": ["app/api/admin/mall", "app/api/admin/orders", "app/api/admin/products"],
+      "collections": ["products", "orders"]
+    },
+    {
+      "id": "mod-service-market",
+      "module": "服务市场",
+      "owner": "李玩",
+      "collaborators": ["陈电"],
+      "keywords": ["服务", "陪玩", "课程", "代练", "services", "course"],
+      "frontend_paths": ["app/services", "app/course", "app/my-courses", "app/mall/companion"],
+      "admin_paths": ["app/admin/leveling"],
+      "api_paths": ["app/api/admin/leveling"],
+      "collections": ["courses", "serviceOrders"]
+    },
+    {
+      "id": "mod-hotel-cafe",
+      "module": "酒店与网咖",
+      "owner": "陈电",
+      "collaborators": ["李玩", "张星"],
+      "keywords": ["酒店", "网咖", "预订", "美团", "booking", "venue"],
+      "frontend_paths": ["app/hotel", "app/booking"],
+      "admin_paths": ["app/admin/hotel"],
+      "api_paths": ["app/api/admin/venues", "app/api/admin/venue-bookings", "app/api/admin/meituan/sync"],
+      "collections": ["hotels", "cafes", "bookings"]
+    },
+    {
+      "id": "mod-account-pawn",
+      "module": "账号交易与典当",
+      "owner": "陈电",
+      "collaborators": ["李玩"],
+      "keywords": ["账号交易", "典当", "赎回", "pawn", "account trade"],
+      "frontend_paths": ["app/services/account"],
+      "admin_paths": ["app/admin/accounts", "app/admin/pawn"],
+      "api_paths": ["app/api/admin/accounts", "app/api/admin/pawns"],
+      "collections": ["accounts", "pawns"]
+    },
+    {
+      "id": "mod-screen-dashboard",
+      "module": "大屏与数据看板",
+      "owner": "李玩",
+      "collaborators": ["陈电", "刘竞", "张星"],
+      "keywords": ["大屏", "看板", "screen", "SSE", "实时展示"],
+      "frontend_paths": ["app/screen", "app/admin/screen"],
+      "admin_paths": ["app/admin/screen"],
+      "api_paths": ["app/api/screen", "app/api/admin/screen", "app/api/build-info"],
+      "collections": ["screen_config", "screen_projects"]
+    },
+    {
+      "id": "mod-ai-matchmaking",
+      "module": "AI互动与任务撮合",
+      "owner": "刘竞",
+      "collaborators": ["陈电", "李玩"],
+      "keywords": ["AI互动", "撮合", "绑定", "主播触达", "audience insights"],
+      "frontend_paths": ["app/streamer", "app/live"],
+      "admin_paths": ["app/admin/streamers", "app/admin/journey"],
+      "api_paths": ["app/api/streamer", "app/api/streamers", "app/api/admin/journey-events"],
+      "collections": ["journeyEvents", "streamerBindings"]
+    },
+    {
+      "id": "mod-user-asset-digitization",
+      "module": "用户资产数字化",
+      "owner": "刘竞",
+      "collaborators": ["王值", "陈电"],
+      "keywords": ["用户资产", "RFM", "消费能力", "标签", "数据中台", "user value"],
+      "frontend_paths": ["app/admin/user-value", "app/admin/rfm-rules"],
+      "admin_paths": ["app/admin/user-value", "app/admin/rfm-rules", "app/admin/journey"],
+      "api_paths": ["app/api/admin/rfm-rules", "app/api/admin/user-value-summary", "app/api/analytics/journey-events"],
+      "collections": ["ckb_user_assets", "rfmRuleSets", "rfmUserScores", "userJourneyEvents"]
+    },
+    {
+      "id": "mod-env-db-integration",
+      "module": "环境与数据库集成",
+      "owner": "张星",
+      "collaborators": ["刘竞", "陈电", "王值"],
+      "keywords": ["env", ".env", "MONGODB_URI", "数据库连接", "docker mongo", "seed", "indexes"],
+      "frontend_paths": [],
+      "admin_paths": [],
+      "api_paths": ["app/api/auth/login", "app/api/auth/register", "app/api/admin/auth/login"],
+      "collections": ["users", "userAuths", "admins", "healthcheck"]
+    },
+    {
+      "id": "mod-live-cloud-auth",
+      "module": "直播云厂商配置与鉴权",
+      "owner": "陈电",
+      "collaborators": ["李玩", "张星", "刘竞"],
+      "keywords": ["腾讯云直播", "阿里云直播", "七牛", "推流", "播放", "鉴权", "RTMP", "LIVE"],
+      "frontend_paths": ["app/live", "app/streamer/live"],
+      "admin_paths": ["app/admin/live", "app/admin/settings"],
+      "api_paths": ["app/api/streamer/live", "app/api/streamer/live/cloud", "app/api/live/context"],
+      "collections": ["liveRooms", "liveSessions", "liveShowcaseItems"]
+    }
+  ]
+}
--- a/玩值AI/业务模块智能体/乘风_智能体合并分工_基于env.md
+++ b/玩值AI/业务模块智能体/乘风_智能体合并分工_基于env.md
@@ -0,0 +1,43 @@
+# 乘风分工单（基于 `.env.example` 吸收）
+
+> 目标：让玩值AI全体智能体吸收环境配置文件，并按“创建/合并智能体”方式执行。
+
+## 一、已吸收内容
+
+- 必填数据库变量：`MONGODB_URI`
+- 本地开发端口约定：`pnpm dev` -> `http://localhost:3088`
+- 直播云配置分组：
+  - 腾讯云：`TENCENT_LIVE_*`
+  - 阿里云：`ALIYUN_LIVE_*`
+  - 七牛云：`QINIU_LIVE_*`
+  - 通用 RTMP：`LIVE_GENERIC_RTMP_BASE`
+  - 前端可见模板：`NEXT_PUBLIC_LIVE_RTMP_TEMPLATE`
+
+## 二、创建/合并结果
+
+- 新增模块智能体：
+  - `环境与数据库集成`
+  - `直播云厂商配置与鉴权`
+- 合并协作组：
+  - `联调执行组`：李玩 + 陈电
+  - `环境安全组`：刘竞 + 张星
+  - `进度验收组`：王值
+
+## 三、职责分工（乘风安排）
+
+1. **张星（主责）**：环境与数据库集成  
+   - 维护 `.env.local`、Docker/Mongo 可达性、部署环境一致性
+2. **刘竞（协作）**：数据库架构与索引策略  
+   - 审核集合、索引、数据边界与文档一致性
+3. **陈电（主责）**：直播云厂商配置与鉴权后端实现  
+   - 处理推拉流鉴权、服务端签名、接口契约
+4. **李玩（协作）**：前端直播配置展示与联调  
+   - 对接直播配置展示、错误提示与回退逻辑
+5. **王值（收口）**：需求验收与进度日志  
+   - 记录改动范围、验收标准、风险与下一步
+
+## 四、执行顺序
+
+1. 环境与数据库先通（`MONGODB_URI` + 连通检查）
+2. 再做直播云配置接入（先服务端、后前端）
+3. 最后由王值收口（日志/进度/验收）