games-development-ai/docs/superpowers/specs/mvp-execution-spec-design.md
zizi d97e194383 docs(治理): SoT注册表+docs-gate六检门,清缩历史档126→69
- 注册表:docs/architecture/README.md §2,37 份 canonical(frontmatter topic+canonical:true)与表双向机器对账
- 门:.agents/tools/docs-gate.py 六检(品牌根/canonical唯一/死链/入口卫生/留痕隔离/设计档申报),挂 .githooks/pre-commit(本仓已激活)+ .gitea/workflows/docs-gate.yml(待runner)+ wave-close 第8步;旧 check-deadlinks.sh 退役并入 G3
- 清缩:删 54 项历史档(plans 16/agent-specs 设计与spike 20/brainstorms 5/memorys 3/goals+作战清单完成史归档/王蓝莓design/SAA现状html/add-game-template);channel-spike 564K 代码资产迁仓级 spikes/;六件删前蒸馏已迁(代码评审16条open项→进度总账§5、prefix-cache字段表→cheap-model skill、意图基线29条→需求清单附录、九门降级rationale→验收门、A11 TODO→tech-decisions、3layer边界→littlejs-game-dev 指针)
- 修口径约90处:六处SAA『现行主线』旧标、Nacos/RocketMQ『未部署』旧述(07-01反转)、gameDefinition残留、全部死链改 git show 定位;AGENTS.md 249→136行(决策史归tech-decisions);_index 改纯在飞板;对外演示版 md→html
- 依据:docs/agent-specs/2026-07-02-文档治理-{全量普查与裁决-report,SoT注册表与治理门-设计}.md(四路普查191份md+Codex/Opus双评审必修项已折入);恢复基线 8ea97234(单档 git checkout 8ea97234 -- <路径>)
2026-07-02 14:24:12 +08:00

21 KiB
Raw Blame History

date, topic, status
date topic status
2026-06-07 MVP执行spec 视图(项目上线主计划之下)

MVP 总执行 Spec — 10人×3周验收 55 项 P0 产品功能 · 工作量≈137 技术项)

文档定位2026-07-02:本 spec 是 可行性方案16周-波次映射.md(项目上线主计划 SoT之下的一个视图 —— 提供上线的产品验收来源55 项 P0 产品功能、工作量 ≈137 技术项)与一段 3 周冲刺执行视图contract-first + 五工位并行的打法)。它不是平行的执行基线;日常排期以 16 周主计划为准,引用本 spec 时只取其 55 P0 验收定义。

⚠️ 状态横幅2026-06-12仅作历史:本 spec 为 v1.0 原始执行规划2026-06-07其中 WS2 的「Dify / OpenGame / ComfyUI 文生代码」部署与编排步骤§工位编制、M1 里程碑 Dify/OpenGame Docker 部署、§6 Dify workflow 6 节点、§风险"切纯 Dify+模板填充")均已作废——现行裁决Dify/OpenGame 降级远期、从未部署C2 2026-06-09 / HJ-GEN-001生成主线=new-api 网关 + agent 写码于插件库agentic 编排基建=AgentScope 2.xHJ-AGI-001RocketMQ/Nacos=future-state 未部署Tier1 引擎=LittleJS 增强发行版2026-06-12 终裁);「玩法模板层」已废除(模板=LittleJS 插件)。现行口径以 .agents/knowledge/tech-decisions.md §1/§1.1、docs/mvp/MVP进度总账.md 为准。以下正文保留原貌,仅作历史规划留痕,勿照其 Dify/OpenGame/模板步骤执行。

文档编号HJ-MVP-SPEC-001 版本v1.0 受众:全体开发团队 + 产品运营 生成时间2026-06-07 前置:系统概要设计-技术决策版、产品需求清单(Doc A)/技术架构与模块(Doc B)/需求模块映射(Doc C) 约束10 人团队、3 周15 个工作日);MVP 验收 = Doc A 的 55 项 P0 产品功能工作量≈137 技术项,核心闭环不砍


1. 目标

1.1 交付目标

3 周后2026-06-27交付一个种子用户可试用的 MVP,覆盖完整链路:

创作者登录 → 资产管理 → Prompt生成/资产组装 → 预览试玩 → 发布
  → 审核通过 → 游戏流推荐 → 玩家试玩 → 互动 → 分享
  → 广告展示 → 收益归集 → 创作者钱包可见
  → 遥测采集 → 质量评分 → 推荐优化

1.2 量化验收标准

指标 标准
P0 产品功能覆盖 55/55 项 Doc A 的 P0 产品功能全部可用(可验证)
端到端链路 创作→生成→预览→发布→审核→游戏流→试玩→互动→广告→收益 全走通
生成成功率 ≥ 80%(基于 3-5 个模板)
游戏流首屏 P75 < 3s
冒烟测试 核心 5 条链路自动化通过
P0 Bug 0 个P1 可遗留不超过 10 个)

2. 团队编制

工位 代号 人数 角色 职责边界
平台基座 WS1 2 后端 Senior × 2 Huijing fork / Gateway / DB / CI-CD / project / compliance
AI 生成 WS2 2 AI 工程师 + 后端 Dify / OpenGame / ComfyUI / aigc 模块 / 质量门禁
运行时与分发 WS3 2 后端 + 前端(SDK) runtime / SDK / LayaAir导出 / feed 推荐 / 互动 / 分享
产品前端 WS4 2 前端 × 2 game-studio 全页面 / game-admin 审核+模板+看板
数据与变现 WS5 2 后端 + 产品运营 telemetry / ad / trade / pay / community / biz / seed / 验收

3. 契约先行Day 06月9日上午

全员用半天对齐并锁定以下契约文件,写入 contracts/ 目录提交 git

契约文件 内容 负责人
api-schemas/*.yaml 所有模块 API 的 OpenAPI 3.0 定义Request/Response WS1 lead 主笔,全员 review
db-schemas/V1__*.sql 核心表结构Flyway 迁移脚本) WS1
sdk-interface.d.ts WanxiangGameSDK 全部 public API 类型定义 + postMessage 协议 WS3 SDK 负责人
game-package.schema.json GamePackage manifest 格式 + 目录结构 WS3 + WS2
events.schema.json telemetry 事件名 + 字段v1 WS5
dify-workflow-io.json Dify workflow 的输入/输出契约 WS2
ad-slot.schema.json 广告位配置格式 WS5

以上 7 个 contracts/ 文件为 Day-0 契约;Prompt Registry独立 prompt/ 目录)为第 8 类契约,与全局 8 契约口径一致。

契约锁定后:各工位 mock 对方接口独立开发,联调在 Day 11 开始。


4. 三周逐日计划

Week 16/9 ~ 6/13基座 + 各工位独立开发

WS1 平台基座

Day 任务 交付物
1 Fork huijing-cloud + 本地跑通 + docker-compose.middleware.yml 全栈中间件可启动
1 CI/CD pipeline 搭建GitHub Actions / GitLab CI push→lint→test→build 流水线
2 创建 13 个 game-module Maven 骨架(含 studio+ game-server 单体入口 编译通过
2 DB 迁移 V1project + compliance + telemetry + feed 核心表) Flyway migrate 成功
3 project 模块CRUD + 状态机 + 版本管理 Swagger 可调
3 Gateway 路由配置 + CORS + 匿名Token 前端可调通 API
4 project 模块:草稿 + 发布前检查 + 发布审核(BPM) 审核流程可走通
5 compliancePrompt 文本安全 + 图片安全(对接 safe-content-ai 安全检测 API 可调

M1 验证Day 3 下午)docker compose up → 全栈绿灯 → Swagger 可调 project CRUD。

WS2 AI 生成

已作废(现行注):本段原为 Dify / OpenGame / ComfyUI 的 Docker 部署与 6 节点 workflow 编排步骤。Dify / OpenGame 已降级远期、从未部署ComfyUI 亦未部署;生成主线现已收敛到 AgentScope 三档Tier0/1/2 按 AI 参与深度分,引擎随复杂度在 LittleJS / Phaser 间选A-model 直接写真 src/)。现行口径见运行时 SoT docs/architecture/架构/生成引擎/agentic运行时架构图说.md;原步骤见 git基线 8ea97234

WS3 运行时与分发

Day 任务 交付物
1 SDK Core 开发lifecycle + event-bus + telemetry npm 包 v0.1 发布(内部)
2 SDK Core 开发error-track + postMessage 协议完整 SDK < 8KB 验证通过
2 runtime 编译服务GamePackage→Web 包 + manifest + OSS 上传 API 可调
3 SDK Plugin.Ad 桩 + Plugin.Pay 桩(接口齐全,实现为 mock npm 包 v0.2
3 runtime 预览交付端点(按版本返回 manifest + 资源 URL GET /app/runtime/preview/:versionId
4 feed 推荐引擎 MVPRedis Sorted Set + 规则排序) GET /app/feed/list 可调
5 feed 互动 API点赞/收藏/分享/举报)+ 候选集刷新 POST /app/feed/interaction 可调

WS4 产品前端

Day 任务 交付物
1 game-studio 项目初始化Vue3 + Vant + Vite + Router + Pinia 项目可运行
1 game-admin forkhuijing-ui-admin-vue3+ 菜单配置 admin 可登录
2 studio登录/注册页 + Token 管理 + 路由守卫 可登录
2 admingame/review 审核队列页骨架 页面可访问
3 studio创作工作台骨架项目列表 + 创建项目) mock API 驱动
4 studio资产管理页列表/上传/AI生成入口 UI 可操作
5 studio游戏流页骨架 + 滑动切换 + 封面卡片 mock 数据可滑动
5 admin模板管理页 + 精选池管理页 页面可操作

WS5 数据与变现

Day 任务 交付物
1 telemetry事件摄取 API/events/batch+ MQ 异步入库 API 可调
2 telemetry事件 Schema 校验 + 限流 + 去重 异常事件被拦截
2 seed 数据脚本:用户/模板/标签/配置 一键导入
3 telemetry质量评分聚合GameDailyStats 定时任务) 质量分可查
3 ad广告位定义 API + 穿山甲 SDK 集成准备 广告位 CRUD 可调
4 ad广告展示上报 API + eCPM 基础统计 上报可入库
4 pay积分充值订单 API + 微信支付对接骨架 订单可创建
5 trade创作者钱包 API余额/收益明细/分成规则) 钱包数据可查
5 制作 3 款 demo 游戏(用 AI 生成 + 手工调整) demo 内容就绪

Week 26/16 ~ 6/20链路串通 + 功能完善

WS1 平台基座

Day 任务
6 compliance音频安全 + AI 输出风控规则 + 违禁词库管理
6 project审核拒绝反馈 + 重新提交 + 精选池管理
7 project创作者主页 API + 下架/封禁
7 compliance举报处理 + 阈值降权 + 用户封禁
8 compliance操作审计日志 + RBAC 精细权限 + 匿名用户约束
8 发布前检查清单完善7 道门禁联动 compliance
9 compliance隐私政策/适龄提示/防沉迷桩接口 + CSP/CORS 加固
10 联调准备:修复 WS4 对接时发现的契约偏差

WS2 AI 生成

Day 任务
6 模板库完善3-5 个玩法模板(躲避/跑酷/点击收集/解谜/射击)
6 每个模板Schema + 默认参数 + 示例 Prompt(3-5个)
7 aigc生成任务状态机完整queued/running/succeeded/failed/timeout/canceled
7 aigcLLM 熔断降级 + 确定性 Fallback 生成器
8 aigc生成失败原因分类 + 用户可读提示
8 质量门禁GameConfig Schema 校验 + 资源有效性 + 可玩性基础验证
9 aigc生成进度 SSE 推送 + 超时后台通知
9 ComfyUI封面/宣传图自动生成 workflow
10 端到端验证5 个模板 × 3 个 Prompt = 15 次生成全部成功率 ≥ 80%

WS3 运行时与分发

Day 任务
6 SDK Plugin.Ad 真实实现(宿主侧穿山甲 SDK 加载 + postMessage
6 runtimeGameConfig 静态校验 + Manifest 完整性校验
7 feed新人保底曝光 + 低质降权 + 冷启动策略
7 runtime资源大小限制 + hash 命名长期缓存 + CDN 刷新
8 feed分享链接 + Open Graph 元数据 + 分享落地页
8 SDK调试面板开发模式+ trace_id 贯穿
9 LayaAir CLI 集成:微信小游戏导出 + 自动图标封面
9 runtimeWeb 沙箱 iframe 隔离 + CSP + postMessage 来源校验
10 runtime三容器预加载策略 + 加载超时跳过 + 错误上报

WS4 产品前端

Day 任务
6 studioPrompt 输入 + 风格/模板选择 → 调真实 aigc API
6 studio生成状态展示进度/成功/失败/重试)
7 studio资产空间完善分类/搜索/AI生成单项资产
7 studio游戏组装页模板选择 + 资产拖入 + 配置机制)
8 studio预览试玩页iframe + SDK 集成 + 调试面板)
8 studio发布流程检查清单 + 提交审核)
9 studio游戏流 → 对接真实 feed API + 三容器预加载
9 studio互动浮层点赞/收藏/分享/举报)+ 分享页
10 admin审核队列完善试玩预览 + 通过/拒绝/下架 + 拒绝理由)
10 admin数据看板核心 5 指标:生成率/发布率/留存/互动/收益)

WS5 数据与变现

Day 任务
6 telemetry创作漏斗 + 游戏流消费漏斗
6 telemetry运营看板 API审核积压/生成成功率/举报率)
7 ad激励视频 + 插屏广告触发逻辑 + 合规植入规则
7 trade广告分成结算逻辑T+1+ 多渠道收入归集
8 trade创作者收益明细 + 提现申请 APIMVP 展示余额,真实打款 P1
8 pay积分充值流程完善 + 订单状态管理
9 community站内信系统 + 生成完成/审核结果/收益变动通知
9 bizB 端需求表单 + 模板选择 + 进度看板(简化版)
10 制作 5 款追加 demo 游戏 + 审核通过 + 游戏流内容补充

M2 验证Day 10 / 6/20:创作→生成→预览→发布→审核→游戏流→试玩→互动→广告→收益 全链路端到端走通(可能有 bug但链路通了


Week 36/23 ~ 6/27联调 + 修 bug + 加固 + 上线

全工位进入联调模式,每天站会同步阻塞点。

Day 全体任务
11 全链路联调创作→生成→预览WS1+WS2+WS3+WS4 对接)
12 全链路联调发布→审核→游戏流→试玩→互动→分享WS1+WS3+WS4
12 全链路联调广告→收益→钱包WS3+WS5+WS4
13 Bug 修复P0 优先)+ 性能优化CDN/缓存/预加载调优)
13 安全加固WAF 配置 + 渗透测试基础项 + 密钥轮换
14 冒烟测试脚本编写并通过5 条核心链路)
14 seed 数据最终版 + demo 内容充实≥10 款游戏)
15 灰度发布 staging → 种子用户 10 人内测 → 收集反馈
15 紧急 bug 修复 + MVP 交付确认

M3 验证Day 15 / 6/27:种子用户完成全链路操作 + 冒烟测试全绿 + P0 bug = 0。


5. 里程碑与验证节点

里程碑 日期 验证标准 验证人
M0 契约锁定 6/9 上午 contracts/ 目录 7 个文件提交 git 全员签字
M1 全栈可启动 6/11 (Day 3) docker compose up → 全服务绿灯 + API 可调 WS1 lead
M2 创作链路跑通 6/18 (Day 8) Prompt→AI 生成→预览试玩 端到端(真 LLM非 mock WS2 lead
M3 分发链路跑通 6/20 (Day 10) 发布→审核→游戏流→试玩→互动→分享 WS3 lead
M4 变现链路跑通 6/23 (Day 11) 广告展示→收益→钱包可见 WS5 lead
M5 MVP 交付 6/27 (Day 15) 种子用户全链路 + 冒烟绿 + P0=0 产品负责人

6. 并行解耦规则

6.1 Mock 策略

工位 依赖谁 Mock 方式 真实对接时间
WS4(前端) WS1/WS2/WS3/WS5 的 API vite-plugin-mock 基于契约 yaml 自动生成 Day 6 起逐步替换
WS3(SDK) WS4(宿主) 独立测试页模拟 postMessage Day 6 集成
WS2(aigc) WS1(project) 内存态写入 + MQ mock Day 5 真实对接
WS5(telemetry) WS3(SDK 上报) curl 模拟 /events/batch Day 6 真实对接

6.2 每日站会15 分钟)

  • 时间:每天 10:00
  • 格式:每人 2 分钟(昨天完成 / 今天计划 / 阻塞点)
  • 阻塞点处理:会后 10 分钟两人对齐,不拖会

6.3 联调窗口

  • Day 11-12预留 2 天专门联调,不安排新功能开发
  • 联调期间:前端主导提 bug后端 30 分钟内响应
  • P0 bug当天必须修复P1 bug联调期内修复

7. P0 工作量到工位的映射≈137 技术项 · 验收口径见 §1.2 = 55 项 P0 产品功能)

生成域拆为 aigc无状态生成原子+ studio创作编排域;首屏骨架能力归位为:专区 Zone 实体 / 发布去向 launchZone / 统一发布编排 → project锁风门 Gate 二态 → compliance渠道发布状态机 → runtime按 Zone 分区推荐 → feed。下列为工作量分解(技术项粒度,各模块标题计数与逐条列举一致;最终以 Doc B 的 T-id 与契约为准);逐条产品功能↔技术功能映射见 Doc C验收以 55 项 P0 产品功能为准。

WS1 负责43 项)

project 模块14 项 P0

  1. 项目 CRUD
  2. 游戏状态机
  3. 版本管理
  4. 草稿保存与恢复
  5. 标题/简介/封面/标签编辑
  6. 发布前检查清单
  7. 发布审核(BPM)
  8. 审核决策与操作
  9. 审核拒绝反馈
  10. 创作者主页
  11. 精选池管理 + 下架/封禁
  12. 专区 Zone 实体与游戏归属(双轨) ←G1
  13. 发布去向 launchZone 选择 ←G1
  14. 统一发布编排compliance→runtime→feed失败回滚 ←G6

compliance 模块29 项 P0 文本安全 / 图片安全 / AI 输出风控 / 违禁词库 / 举报处理 / 举报阈值降权 / 人工审核队列 / 审核状态机 / 风险分层 / 操作审计 / 审计长期保存 / 安全日志告警 / RBAC / 游戏沙箱CSP / 文件安全校验 / Prompt 注入防护 / OWASP 防护 / Secrets 管理 / 敏感数据加密 / 数据传输加密 / 日志脱敏 / 登录安全限频 / 匿名用户约束 / CORS+CSP / 隐私政策 / 数据最小化 / 适龄提示 / 用户封禁 / 锁风门 Gate 二态(pass/block) ←G2

WS2 负责16 项studio 6 + aigc 10

studio 模块6 项 P0创作编排自 aigc 迁出 + demo 缺口) 创作会话与草稿装配 / 六类资产模块化生成调度 / 附件驱动创作上下文 / agentic 任务链编排 / 生成进度流(SSE) / 重生成迭代编排

aigc 模块10 项 P0无状态生成原子 Prompt 解析 / 模板匹配 / GameConfig 生成 / 参数校验兜底 / LLM 熔断 / Prompt 安全检测 / 确定性 Fallback / 失败原因分类 / 模板注册管理 / 示例 Prompt 库

WS3 负责38 项 + SDK

runtime 模块20 项 P0 Web 包编译 / Manifest 生成 / 资源打包上传 / Web 沙箱隔离 / SDK 事件桥接 / Canvas 渲染容器 / GameConfig 注入 / 实时预览 / 资源大小限制 / hash 缓存 / 版本化路径 / 预加载策略 / 超时跳过 / 错误捕获上报 / 多端适配 / 竖屏适配 / postMessage 校验 / Manifest 校验 / GameConfig 静态校验 / 渠道发布状态机(待开通/申请中/已上线) ←G6

feed 模块18 项 P0 Feed 推荐列表 / cursor 分页 / 候选集缓存 / 新人保底 / 低质降权 / 冷启动策略 / 上下滑切换 / 点赞 / 收藏 / 分享 / 举报 / 分享链接 / OG 元数据 / 分享落地页 / 行为信号推荐 / 首屏封面展示 / 精选池接口 / 按 Zone 分区推荐/浏览 ←G1

SDKCore(lifecycle/telemetry/error-track) + Plugin.Ad + Plugin.Pay 桩

WS4 负责(前端页面承载所有 P0 的 UI 表现)

game-studio:登录 / 创作工作台(项目列表/资产管理/Prompt/生成状态/组装/预览/发布/专区选择 / 游戏流(滑动/卡片/互动/分享/双专区 / 创作者中心(主页/数据/收益)

game-admin:审核队列 / 模板管理 / 精选池 / 数据看板 / 内容安全

WS5 负责45 项)

telemetry17 项 P0:事件批量摄取 / Schema 治理 / 前端批量上报 / 质量评分 / 事件聚合 / 创作漏斗 / 消费漏斗 / 运营看板 / 玩家留存 / 创作者复创率 / Product Metrics / 加载时间埋点 / 服务健康监控 / 生成任务健康 / Runtime 健康 / 异常告警 / 失败根因

ad5 项 P0:广告联盟对接(穿山甲) / 广告联盟对接(优量汇) / 激励视频 / 插屏广告 / 展示上报

trade8 项 P0:广告分成结算 / 多渠道收入归集 / T+1 对账 / 创作者钱包余额 / 提现 / 收益明细 / 平台营收报表 / 渠道收入归集

pay3 项 P0:积分充值 / 支付网关抽象 / 订单管理

community6 项 P0:站内信 / 短信通知 / 生成完成通知 / 审核结果通知 / 收益变动通知 / 新人任务奖励(T-CMU-11 等级引擎)

biz5 项 P0B 端需求表单 / 模板选择预览 / 进度看板 / 交付验收 / 品牌营销模板

ip1 项 P0:素材安全扫描(T-IP-01 版权基础原子ip 域无 P0 产品功能出口,仅此基础原子计入工作量)


8. 技术约束与规范

8.1 开发规范(全工位遵守)

  • 分支:feature/{ws}-{module}-{brief} → PR → develop
  • CommitConventional Commitsfeat(aigc): xxx
  • PR< 500 行 + 至少 1 人 review + CI 通过
  • 测试Service 层单元测试覆盖核心逻辑;集成测试覆盖 API 端点
  • 文档:新 API 必须有 Swagger 注解;变更必须更新契约文件

8.2 幂等性(全工位遵守)

  • 所有写操作 API前端防抖 + 后端 idempotency_key
  • MQ 消费message_id 去重Redis SET + 5min TTL
  • 支付回调:订单状态机 + 乐观锁

8.3 联调规则

  • 前端 mock → 真实 API 切换:改 .envVITE_API_BASE_URL 即可
  • 后端新增/变更 API必须同步更新 contracts/api-schemas/ 并通知前端
  • 阻塞超过 30 分钟:立即升级到站会解决

9. 风险与应对

风险 概率 应对
Dify/OpenGame 集成比预期复杂 WS2 前 3 天全力攻坚;失败则 Day 3 切换为纯 Dify + 模板填充
联调期 bug 过多 Week 3 前 2 天只联调不加功能P0 优先
广告联盟审核未通过 先用 mock 广告;真实对接可延到 MVP 后 1 周
某工位进度落后 Day 5/Day 10 两次检查点;落后则其他工位支援
3 周内 10 人无法完成 工作量≈137 技术项,每项约 1 人天10人×15天=150 人天 > 137留约 13 人天缓冲

10. 交付物清单

MVP 结束时 git 仓库应包含:

game-cloud/         后端全部模块可编译运行
game-admin/         管理后台可登录可操作
game-studio/        产品端全链路可用
contracts/          契约文件API/DB/SDK/事件)
deploy/
├── docker-compose.yml          # 全栈启动
├── docker-compose.middleware.yml
├── docker-compose.ai.yml
├── sql/seed-*.sql              # 初始化数据
└── smoke-test.sh               # 冒烟测试脚本
docs/
├── architecture/               # 已有架构文档
└── mvp/
    ├── this-spec.md            # 本文档
    └── changelog.md            # 每日进展记录