docs(gen-plan): plan① 换轴重构为纵切执行序列 SoT + 蒸馏切分轴 skill

把生成引擎统一执行计划从关注面横切(WU-A..F)重构为成果纵切三切片(便宜档达标上线 / tier2 go/no-go / A11 调整回路)+ 基建线 + 已冻协议基线,WU-A..F 降为 §7 设计面对账。补上执行序列 SoT 这一缺失的中间层(夹在设计 SoT 与切片细化 plan 之间)。canonical 唯一性门:原地重构、文件名保留、旧主轴降对账。

过 Codex + Opus 双评审,必修项已修:假前置门(A1-A13 定级设计 SoT 已冻、非待拍)/ 散文元叙述 / 切片三对切片一真依赖(A2A·D12)/ §7 对账补全八面 / 插件数 11→12 / base 编号去掉。

蒸馏:新增 skills/execution-plan-slicing.md(横切 vs 纵切判据 + 换轴动作 + canonical 唯一性门 + 四坑),README 索引同步。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
lili 2026-06-26 18:13:09 -07:00
parent b7b3982d5c
commit de496321c6
3 changed files with 264 additions and 274 deletions

View File

@ -64,6 +64,7 @@
| `skills/drive-remote-claude-tmux.md` | 远程驱动交互式 Claude Code(ssh + tmux):双向通道 send-keys 派活 + capture-pane 读屏,不走 ACP/headless;每设备配置块 + onboarding 侦察配方 + 专用会话(独立 worktree 防撞树) + bypass-perms + 安全红线;**完成判据=git push 非读屏**(创始人 2026-06-18 拍板·多设备复用) |
| `skills/architecture-diagram-atlas.md` | 架构图集生成配方:house style 规格 / 图说文档结构(金样板) / 三范式纪律(单源·防漂移门·状态双层) / 按域并行编排(克隆金样板·结构化返回) / 复验脚本 / 双评审揪出的六坑(漏域·现行远期错标·缺状态列·契约画理想·凑数配额·复制Mermaid漂移) / 分两期+跨session协调(生成引擎子树归在飞线只链不画)(2026-06-22 第一期实证) |
| `skills/feature-design-doc.md` | **功能设计文档作业手册**:取代 agent-specs review/execution 双档;一份文档 WHAT(意图/目标/边界/验证)+HOW(方案/步骤)合一;一式两份(文字+Mermaid 给人/AI · SVG/HTML 给人更重要、看图即懂);复用 atlas house style + 防漂移单源(文字为准) + 媒介分工(md 直渲 Mermaid/SVG · HTML 链接打开)(2026-06-24 创始人定) |
| `skills/execution-plan-slicing.md` | **执行 plan 切分轴:横切关注面 vs 纵切成果切片**:多单元 plan 按成果纵切(每片自带全部关注面、做完不回头)而非按关注面横切(目标与手段分散→返工);诊断信号="每到下阶段前面要重做"+依赖≠返工;换轴=横切降为"单元→切片"设计面对账(不删不新建、canonical 唯一性门原地重构、文件名留)+执行按切片走;三层文档(设计SoT→执行序列SoT→切片细化);必查四坑=过时口径搬成假前置门/对账漏面/元叙述/评审状态漂移(2026-06-26 plan① 换轴实证) |
**workflows/**

View File

@ -0,0 +1,45 @@
# 执行 plan 切分轴 —— 横切关注面 vs 纵切成果切片
> 一份多单元的执行 plan,工作单元按什么轴切,决定它能不能照着走。切错轴,执行时每推进一个单元都要回头补前一个,表现为"每到下个阶段,前面阶段的工作都要重做"。
## 两种切分轴
| 轴 | 怎么切 | 适合 | 风险 |
|---|---|---|---|
| 横切关注面(facet) | 按活动类型 / 架构面切单元(框架、实例、校验、标准、门……) | 给"设计怎么落地"建结构索引——每个面对应设计 SoT 一节 | 当执行序列用会返工 |
| 纵切成果切片(slice) | 按可独立交付的成果切单元,每片自带它要的全部关注面 | 执行序列——按什么顺序一步步推到上线 | 难在找准"什么算一个完整成果" |
横切答"设计有哪几个面",纵切答"按什么顺序交付"。同一批工作可以两种视图并存,但**执行只能照纵切走**。
## 什么时候横切会返工(诊断信号)
- 一个交付成果的**目标**和它的**实现手段**被切到了不同单元(目标挂 A、手段在 B/C)。做 A 时手里没有实现工具,必须回头做 B/C 才能推进。
- 一个真实成果**纵向穿过多个关注面**——要框架 + 实例 + 校验 + 标准 + 门一起到位才算交付,而它们分散在不同单元。
- 主观信号:推进时反复感到"每到下个阶段,前面阶段的工作要重做"。
**依赖 ≠ 返工**:依赖是 A 完成后 B 才开始、A 不回改(健康);返工是做 B 时发现 A 没做够、回头改 A(切分错)。横切单元之间常是后者伪装成前者。
## 换轴动作(重组,不推翻)
1. **横切结构不作废,降为"设计面对账"**:保留一张"单元 → 切片"映射表,作切片落地时下钻设计 SoT 的索引。横切的架构一致性(同口径同契约)由设计 SoT + 机器门保证,对账表只做映射。
2. **执行按纵切切片走**:每片自带框架 / 实例 / 校验 / 标准 / 门,做完即交付、不回头。完成度回填对账表。
3. **切片按价值排序**;切片间真实依赖要**标实**,别把"晚做"误写成"无强依赖可并行"——若 B 用到 A 在某里程碑才建成的基础设施,那就是实依赖,画依赖边、不画"可并行"。
4. **三层文档定位**:设计 SoT(怎么设计)→ 执行序列 SoT(按什么顺序)→ 切片细化 plan(具体实现单元 / 文件 / 测试)。换轴产出的是中间层;每个切片开工前据设计 SoT 产一份它的细化 plan 再交付。
## 治理约束(别制造影子 SoT)
- **canonical 唯一性门**:同 topic 至多一份 canonical。换轴**原地重构现有 plan**、不新建第二份;文件名保留(防止引用它的活档死链);旧主轴内容降为对账小节(留痕、不删)。
- frontmatter `supersedes` 记"自身旧主轴版",git 留演进痕。
## 换轴时必查的四坑(双评审实证)
- **过时口径搬运 → 假前置门**:旧 plan 的某些状态可能已被设计 SoT 推翻(例:plan 写"协议定级待创始人拍",而设计 SoT 已三处明写"定级已冻")。照搬就把已就绪的执行项错挂成"等决策",制造不存在的阻塞。换轴时逐项核对设计 SoT 的**当前**状态,别信旧 plan 的措辞。
- **对账表漏面**:横切有几个面,对账表就要覆盖几个(例:声称"八面"却只列六面,漏掉的面在换轴里掉落)。
- **元叙述**:执行 SoT 别写"本文回答 X 不回答 Y、读本文你会知道……"这类教读者怎么读的话——直陈内容(散文红线,见 [`../../AGENTS.md`](../../AGENTS.md) §6 第 12 条)。
- **评审状态漂移**:重构时 frontmatter 的评审状态要对齐当前这一版,别把旧版的"已过评审"字面带过来误导读者与机器门。
## 来源
2026-06-26 plan①《生成引擎统一执行计划》换轴:横切 WU-A..F(框架 / 实例 / 八面 / 采标准 / 控制面 / 验收门)→ 纵切三切片(便宜档达标上线 / tier2 go/no-go / A11 调整回路)+ 基建线 + 已冻协议基线。触发 = 创始人 catch 两点:"每到下个阶段前面阶段的工作都要重做"(返工信号)、"主线是方案计划?没有执行计划吗?"(缺执行序列这个中间层)。双评审(Opus + Codex 末轮)揪出假前置门 / 对账漏面 / 元叙述 / 评审状态漂移四坑。
> 相关:[`feature-design-doc.md`](feature-design-doc.md)(设计文档怎么写)、[`wave-close-checklist.md`](wave-close-checklist.md)(收口同步纪律)、[`../workflows/ai-development-protocol.md`](../workflows/ai-development-protocol.md)(plan 在协议中的位置)、[`../rules/engineering-conventions.md`](../rules/engineering-conventions.md)(canonical 唯一性门 §10)。

View File

@ -1,333 +1,277 @@
---
title: "feat: 生成引擎统一执行计划 — AgentScope 三档(reframe 后唯一执行 SoT)"
status: 正式 · §6.8 双评审已过(Codex + Opus,必修已修)· WU-A 迁移归属创始人 2026-06-25 拍板 F1=(B):便宜档 Node amodel-gen 用 Python 重写进 AgentScope、三档彻底同构
topic: 生成引擎统一执行计划(框架收敛 AgentScope + 三档实例 + 八面落地 + 采标准 6 ADR)
title: "feat: 生成引擎统一执行计划 — 执行序列(纵切成果切片 · 执行 SoT)"
status: 正式 · 2026-06-26 换轴重构(关注面横切 WU-A..F → 成果纵切三切片;WU 降为设计面对账)· 换轴版已过 Codex + Opus 双评审(plan 双评审门,必修已修;Codex 两评占位、回落 Opus + 末轮补评)· WU-A 便宜档框架对照已坐实(三品类 equivalent)
topic: 生成引擎统一执行计划(执行序列 SoT:三切片 + 基建线 + 已冻协议基线;WU-A..F 作设计面对账)
date: 2026-06-25
updated: 2026-06-26
canonical: true
supersedes:
- docs/plans/2026-06-18-001-feat-gen-lifecycle-and-tier1-breadth-plan.md (SAA 主线骨架退役;有效项入 WU-A/C)
- docs/plans/2026-06-19-001-feat-coredone-验收闭环执行-plan.md (验收闭环入 WU-C 5.4 / WU-F)
- 自身 2026-06-25 横切 WU 主轴版(本次换轴为纵切执行序列;WU-A..F 全部内容保留为 §7 设计面对账,git 留演进痕)
- docs/plans/2026-06-18-001-feat-gen-lifecycle-and-tier1-breadth-plan.md(SAA 主线骨架退役;有效项入切片一与基建线)
- docs/plans/2026-06-19-001-feat-coredone-验收闭环执行-plan.md(验收闭环入切片一的达标门与各切片九门)
absorbs:
- docs/plans/2026-06-22-003-feat-tier2-富游戏自治生成线-plan.md (复杂档,整体入 WU-B/C/F;U1–U10 作子计划保留引用)
- docs/plans/2026-06-22-003-feat-tier2-富游戏自治生成线-plan.md(复杂档整体入切片二;U1–U10 作子计划保留引用)
design_sot: docs/architecture/架构/生成引擎/agentic运行时架构图说.md
---
# 生成引擎统一执行计划 — AgentScope 三档
# 生成引擎统一执行计划(执行序列)
![§0 · 生成引擎统一执行总览](assets/00-生成引擎执行总览.svg)
![§0 · 生成引擎执行总览](assets/00-生成引擎执行总览.svg)
> §0 为全局执行总览;六个工作单元的依赖与状态见上图,逐项展开以下文各节与档内 mermaid 为准。
> 顶部 SVG 是 2026-06-26 换轴前的横切 WU 版,纵切执行序列以 §5 的切片依赖图与 §4 各节为准;SVG 待 redraw 成切片序列图(列入 §11 收口 TODO)。
## Summary
2026-06-25 框架 reframe 把生成引擎的执行收成一条线。此前执行散成三摊:便宜档在 SAA Java 路上跑(06-18-001)、验收闭环单列(06-19-001)、tier2 富游戏在 AgentScope 上自成一份(06-22-003)。reframe 之后,生成编排统一收敛到 AgentScope 一套框架,三档按 AI 参与深度切分(Tier0/1/2),SAA / dify / coze 降为最低优先级、留作远期适配验证可插拔。
这条生成线的执行此前按关注面横切成六个工作单元(框架 WU-A、实例 WU-B、八面 WU-C、采标准 WU-D、控制面 WU-E、验收门 WU-F)。这套切分把设计 SoT 的八个关注面与六条 build-vs-buy 决策落地管得很清楚,却不是一条能照着走的执行序列:一个真实成果——“便宜档能达标上线”“tier2 富游戏走不走定了”——纵向穿过这几个关注面,要框架、实例、校验、标准、门一起到位才算交付。按 WU 横向一个面一个面推进,就会在纵向成果上反复回头补前一个面没做够的部分。
这里要先讲清便宜档的真实拓扑,WU-A 才有准确的迁移面。便宜档的多轮 ReAct 生成循环本体(scaffold → ReAct 即 M3 加五工具沙箱 → done 门 → stage)已经在 Node.js + M3 上跑,落点是 amodel-gen;SAA Java 在这条链路里只当外层编排节点,加上九门 play 的 shell-out 调用方,它不持有生成逻辑。WU-A 的迁移不是只换外层那层壳、把生成核心留在 Node 这侧——而是把 amodel-gen 这条 Node 生成核心整条用 Python 重写成 AgentScope agent:移植它的范式(多轮 ReAct / 五工具沙箱 / done 门 / 历史压缩),但用 Python 重新实现,与 tier2 同语言同框架,三档彻底同构在 AgentScope/Python 上。A1–A13 适配器协议骨架不变,变的是便宜档的实现语言与框架;SAA Java 外层壳加上 Node 旧路在 Python 版达标后退役。
这份计划落的是设计 SoT [`agentic运行时架构图说.md`](../architecture/架构/生成引擎/agentic运行时架构图说.md):§一命题(可插拔 agent 平台)、§二补三(6 条 build-vs-buy ADR)、§三 adapter 协议层(A1–A13 固定 + B 类可插拔)、§四 两引擎三档生成实例、§五运行时八面。六个工作单元覆盖框架收敛(WU-A)、三档实例就位(WU-B)、八面落地(WU-C)、采标准 6 ADR 分批(WU-D)、控制面与配置发布审批边界(WU-E)、验收与预算门(WU-F)。
reframe 的硬口径写进每个单元:三档全模板化、不从零写,去超休闲玩具(最低档也要能商业闭环);引擎按表现复杂度选 LittleJS / Phaser、不是分档轴;gameDefinition 已废、A-model 写真 src/;per-gen 预算硬闸便宜档 < ¥10、复杂档 < ¥50(图音另算);tier2 spike `feie-005` 已 accept、核心已落,验证走 **n=5 收敛环**(并发跑 5、有错追加 5、收敛即 go),不做 n≥30 统计批跑。
2026-06-26 换轴:执行主轴改成按可交付成果纵切的切片。当前剩余工作是三条相对独立的成果线——便宜档达标上线、tier2 富游戏 go/no-go、A11 对话式调整回路,外加一条按需生长的基建线;协议定级与 6 ADR 已冻,作采标准落地的基线。每个切片自带它需要的框架、实例、校验、标准、门,做完就是一个能验收的成果,不回头。WU-A..F 不丢,降为 §7 的设计面对账——它仍是把设计 SoT 八面与六 ADR 落地的结构索引,后续每个切片细化时按它下钻设计。
---
## 执行现状(2026-06-25 · 诚实盘点)
## §1 本文定位:三层文档,各管一层
reframe 之后这条线既有大量既成事实、也有真空白。三档逐档的"已落 vs 待办":
生成线的文档分三层,职责不重叠:
**便宜档(轻-中 AI 深度 · LittleJS · A-model)**
| 层 | 文档 | 回答什么 | 粒度 |
|---|---|---|---|
| 设计 SoT | [`agentic运行时架构图说.md`](../architecture/架构/生成引擎/agentic运行时架构图说.md) | 引擎长什么样、为什么这么设计(§一命题 / §二补三 6 ADR / §三 A1–A13 协议 / §四三档 / §五八面) | 架构关注面 |
| **执行序列 SoT(本文)** | 本文件 | **按什么顺序一步步推到上线** | 切片 / 里程碑 |
| 切片细化 plan | `docs/plans/` 下各切片细化档(如 [`002 multi-genre`](2026-06-26-002-feat-cheap-worker-multi-genre-plan.md) 之于 WU-A) | 某个切片具体怎么实现(实现单元 / 文件 / 测试场景) | 代码级 |
- **已落**:A-model 写真 `src/` 多文件范式现行(取代已废的 gameDefinition · `new Function` 路),落点 `game-runtime/tools/amodel-gen/`(多轮 ReAct + M3 循环 + 5 工具沙箱)+ `game-runtime/games/_wg1-gen/`;11 插件能力库(8 基元 + 4 编排 `scene-fsm/hud-ui/session-score/timer-scheduler`)+ `sim-business` 配方;九门 harness 引擎无关、生产已跑、判过大量游戏(SAA-mode `__GameBundle` + driven 感知 advisory 分级)。已实证地板 = W-G1 L1 worker + 九门真玩 + 3 款冒烟(¥0.01–0.03 < ¥0.15 闸)。
- **待办**:生成核心现行仍在 **Node amodel-gen + SAA Java 外层壳** 这条路上跑——reframe 要把它整条用 Python 重写进 AgentScope(WU-A,三档同构;Node 旧路灰度兜底到达标后退役);便宜档 ≥80% 达标门未跑(全 20 款 bake-off + 四模型横比 + Claude-free judge 门待跑,WU-F);per-gen < ¥10 硬闸接线(WU-F)。
**复杂档(最高 AI 深度 · Phaser · tier2)**
- **已落(主体已落,基准 = `tier2/HANDOFF.md`)**:U1–U7 核心生成线(种子 fork + 有界外层 resume + Phaser `validate`/`run`/`prompt`/`roles` 重写)、Phaser CDP 探针 + 九门 + 富游戏三门(三联动/经济/latch)、四道收敛契约机器门(`validate_datatable`/`LOCKED_PLATFORM_FILES`/`validate_play_scene`/finish 门)、mmx 资产工具、M3 Anthropic 接法 + `RecordingChatModel(Anthropic)` 成本取证、`Tier2TraceMiddleware`→TraceAdapter(真跑 647 事件 dropped=0、cost_rmb=¥1.29)、L3 视觉软检 observe-only、**n=5 收敛环批跑底座**(便宜档 client / `RunRecord` / 退路树判定器 / `batch_run`+`aggregate`)、**服务化 P4 部署 `mini-desktop:8200`**(Agent Service + 落库 MySQL+MinIO,save→fetch 已验)。0 号 spike `feie-005` = `decision=accept`(首跑 n=1 机制验证)。
- **待办**:**n=5 收敛环 go/no-go**(并发 5、有错追加 5、收敛即 go;底座已就位可直接跑,WU-B/F);阶段 1 工作室 Agent Team(Phase B);把偏脆的文本契约门(play-scene 工厂结构)做成更稳的结构化校验(WU-C 5.4)。
**横切(八面 · 控制面 · 采标准)**
- **已落**:D12 运行治理门现行已落(默认关闭,在 SAA Java 后端);prompt 注册表 = "现·部分"(构建期 maven 快照,非热取);tier2 侧 `genconfig` 热配雏形;`contracts/trace/` additive 事件契约位已立。
- **待办**:配置注册表运行时热取、推广到 skill/tool/mcp、配置审计日志、管理面三 phase(WU-E);6 条 build-vs-buy ADR 分批落地(WU-D,当前全在设计层、零实现);统一 trace 契约 `contracts/trace/` 公共核心子集 + adapter 映射(WU-C 5.7);源项目契约 tier2 七要素 schema + feed→play 第二装载分支(WU-C 5.6,交后端)。
- **退役/被推翻的字面口径**:① 06-22-003 的 U8–U10「B 门后才投·纲要」口径已被既成事实部分推翻(服务化/落库/观测已落),读时以 `tier2/HANDOFF.md` 为准;② `tier2/HANDOFF.md`(2026-06-22 稿)多处仍写「n≥30 达阈值」,**已被 2026-06-25 reframe 推翻为 n=5 收敛环**——本计划一律按 n=5,HANDOFF 待 doc-sync 改词(列入 WU-F 收口 TODO);③ 76KB《接口协议层与可插拔模块》(2026-06-23)已于 2026-06-25 并入 SoT §三 + §二补,原档已退役,不再作活档引用。
后续每个切片开工前,据设计 SoT 产一份它的细化 plan,再交付执行。
---
## Problem Frame
## §2 执行现状
reframe 之前,生成引擎的执行计划是三份各自为政的活档,且都建在已被推翻的前提上。06-18-001 把便宜档押在 "SAA 裸图 16 节点 studio + gameDefinition 声明式源" 上;2026-06-20 对抗式裁决判定 gameDefinition 名实不符(声明式数据壳 + 未受契约约束的自由 JS),便宜档随后切到 A-model 写真 src/,而那份 SAA 主线骨架计划没人收口。06-22-003 把 tier2 富游戏押在 AgentScope 上、跑到 spike accept,却与便宜档那条 SAA 线在框架层并行养着两套基建。06-19-001 的验收闭环又把九门、广度、前端真验证单列成第三摊。
三档逐档的“已落 vs 待办”,是切片划分的事实基础。
三摊各自都对,但合起来有两个结构问题。一是**框架双轨**:便宜档 SAA-only、tier2 AgentScope,两套 agentic 基建并行维护,换框架的可插拔原则只在 tier2 一侧兑现。二是**执行口径漂移**:同一个生成引擎,三份计划用三套现状描述、三套验证口径(SAA ≥60% cutover 门、tier2 n≥30、便宜档 ≥80%),读者要在三份活档之间自己对账哪条还活着、哪条被推翻。
**便宜档(轻-中 AI 深度 · LittleJS · A-model · Tier0/1)**
2026-06-25 reframe 给出收敛口径:框架统一 AgentScope,三档共用一套 adapter 协议;SAA/dify/coze 降最低优先级,留作后期"把异构框架适配进来、用这件事验证可插拔原则不是空话"的目标。这份计划据此把三摊收成一条线——一份现状盘点、一套工作单元、一套验证门,并把三份旧 plan 的有效项吸收进对应单元、把被推翻的骨架显式退役。
已落:A-model 写真 `src/` 多文件范式现行(取代已废的 gameDefinition 与 `new Function` 路),落点 `game-runtime/tools/amodel-gen/` 加 `game-runtime/games/_wg1-gen/`;12 插件能力库(8 基元 + 4 编排:scene-fsm / hud-ui / session-score / timer-scheduler)加 `sim-business` 配方;九门 harness 引擎无关、生产已跑、判过大量游戏。**WU-A 框架收敛已坐实**:便宜档生成核心已从 Node/SAA-Java 双轨整条用 Python 重写进 AgentScope,三个 tap-targets 品类(点击得分 / 打地鼠 / 经营点客)金标 play-spec 对照 Python ≈ Node 全部 equivalent,无回退品类——框架等价成立,这是切片一头号风险 R1 三道闸的第一道。
待办:便宜档生成质量当前五款九门 3/5,卡两类品类的生成幻觉;≥80% 达标门未跑;per-gen < ¥10 硬闸未接线;Node 旧路灰度退役未做。这些是切片一的内容。
**复杂档(最高 AI 深度 · Phaser · tier2 · Tier2)**
已落(基准 = `tier2/HANDOFF.md`):U1–U7 核心生成线(种子 fork + 有界外层 resume + Phaser validate/run/prompt/roles 重写)、Phaser CDP 探针加九门加富游戏三门(三联动 / 经济 / latch)、四道收敛契约机器门、mmx 资产工具、M3 Anthropic 接法加成本取证、`Tier2TraceMiddleware`→TraceAdapter(真跑 647 事件 dropped=0、cost_rmb ¥1.29)、n=5 收敛环批跑底座、服务化部署 `mini-desktop:8200`(Agent Service 加落库 MySQL + MinIO)。0 号 spike `feie-005` = decision accept(n=1 机制验证)。
待办:n=5 收敛环 go/no-go 未定;DockerWorkspace 托管 CDP harness 小验(收敛环前置阻断项)未做;偏脆的文本契约门未做成结构化校验。这些是切片二的内容。
**横切(控制面 · 观测 · 采标准)**
已落:D12 运行治理门现行(默认关闭,在 SAA Java 后端);tier2 侧 OTel 映射全部已落并真跑;`contracts/trace/` additive 事件契约位已立。
待办:配置注册表运行时热取、推广到 skill/tool/mcp、配置审计日志、管理面 phase-1;6 条 build-vs-buy ADR 分批落地;统一 trace 公共核心子集契约定稿。这些是基建线与采标准落地的内容。
A11 对话式调整回路(确定性覆写 + 模块重生成)尚未落地,是切片三的内容。
---
## Key Decisions
## §3 为什么纵切:关注面横切会返工
reframe 的权威口径(创始人 2026-06-25),本计划逐条据此:
WU-A..F 是六个关注面,不是六个时间阶段。把它们当执行序列串行推进,会在三个地方反复返工,根源都是“一个成果的目标和它的实现手段被切到了不同的 WU”:
1. **框架收敛 AgentScope,三档彻底同构**。生产编排只押 AgentScope 一套,三档同语言同框架。便宜档的多轮 ReAct 生成核心现在跑在 Node/M3 的 amodel-gen 上,SAA Java 是它的外层编排节点 + 九门 play 的 shell-out 壳;WU-A 把 amodel-gen 这条 Node 生成核心整条用 Python 重写成 AgentScope agent——移植其范式(多轮 ReAct / 五工具沙箱 / done 门 / 历史压缩),用 Python 重新实现,三档同构在 AgentScope/Python 上;A1–A13 适配器协议骨架不变,变的是便宜档的实现语言与框架。tier2 已在 AgentScope。SAA Java 外层壳与 Node 旧路在 Python 版达标后退役。SAA / dify / coze 降最低优先级,留作远期适配验证可插拔——它们被适配进来这件事本身,就是对 §一可插拔原则的验证,作此用、不作并行生产基建。
1. **便宜档达验收**。目标挂在 WU-B(实例就位),但实现手段——生成质量护栏、生产自验 play-spec 自动生成——在 WU-C 5.4,达标判定在 WU-F。做 WU-B 这块时手里没有任何实现工具,要回头做 C 和 F 才能推进。
2. **tier2 收敛环**。同一件事被切成四块:跑收敛环(WU-B)、DockerWorkspace harness 前置(WU-D 的 ADR-6 子项)、结构化契约门(WU-C 5.4)、go/no-go 判定(WU-F)。要四个 WU 的零件同时在手才跑得动一次收敛环。
3. **控制面与采标准**。控制面切成 WU-C 5.2 加 WU-E 两段(WU-E 自己定义为“WU-C 5.2 的后期深化”);六条 ADR(WU-D)又交织进 WU-C 的四个面(5.2 配置热取、5.5 工具协议、5.6 任务协议、5.7 观测)。
2. **三档按 AI 参与深度切分(Tier0/1/2),不是按引擎**。级别越高、AI 写进游戏的内容与代码越多。引擎按表现复杂度选(轻-中档 LittleJS、最高档 Phaser),引擎只是实现、不是分档轴。
3. **全模板化、去超休闲**。三档都在玩法模板加工程脚手架上生成,没有一档从零写;最低档也得能商业闭环(挂广告或内购),无法闭环的超休闲玩具不做。玩法模板退化为可选的品类引导框架(经营/剧情/解谜/TRPG/非遗五品类,影响 prompt 与脚手架),不是可执行的游戏壳。
4. **gameDefinition 已废,A-model 写真 src/ 是便宜档现行形态**。无 factory/gamedef 双轨、无 cutover。产物终态都是 `src/` 多文件源工程(改源不改包、重新构建)。
5. **per-gen 预算硬闸按 AI 深度档分级**:便宜档一次生成 < ¥10、复杂档 < ¥50;图像与音乐生成各走独立预算线、不计入这两个上限。这是"拉高、给足探索空间"的口径(对比 tier2 富游戏 spike 实测仅 ¥1.29)。失效条件 = 单位经济或模型单价大变即复审。
6. **tier2 验证走 n=5 收敛环,不是 n≥30**。并发跑 5、有错(>1)就读日志分析修复再追加一次 5、收敛即 go;退路树按收敛失败模式分流(装不出→补骨架 / 表现层崩→更模板化 / 便宜档全线不收敛而强档能过→换档 / 收敛需微调→留观)。批跑底座已就位、设 n=5。(便宜档 ≥80% 达标门是另一回事——测成功率需统计样本,走 bake-off 批跑,见 WU-F,不在 n=5 收敛环口径内。)
7. **采标准、自研只留两块护城河**。adapter 退化成三个标准端点(A2A 任务 / MCP 工具 / OTel trace)加两块自研(确定性验收门 + 生成专属 checkpoint/续跑)。采标准把"换框架"从推倒重来降到"重写 B 类实现、A 类协议不动",不降到零(业务语义层仍 net-new)。这条经 §6.8 双评审"采纳但修",修正已收口为 6 条 build-vs-buy ADR(SoT §二补三),WU-D 分批落它。
纵切消解这三处返工:每个切片把它要的全部关注面一次性纳进来,做完即交付。横切的 WU 结构不作废——它换个角色,作 §7 的设计面对账,保证纵切切片在落地时仍能按八面下钻设计 SoT、不丢架构一致性。
---
## High-Level Design
## §4 执行序列(主轴)
六个工作单元的依赖关系。WU-A 框架收敛是地基(便宜档迁框架),WU-B 三档实例就位坐在 WU-A 上,WU-C 八面落地是横切实现、与 WU-B 并行推进并被 WU-D 的标准供给,WU-E 控制面/配置发布审批是 WU-C 5.2 控制面的后期阶段深化,WU-F 验收与预算门收口全线 go/no-go。
三切片按价值排序串行:便宜档达标先(阶段一主力、本机可跑、无前置、直接接 WU-A 刚坐实的框架等价),tier2 go/no-go 次(决断价值最高,但有 harness 与机器前置),A11 调整回路后(接产品对话式创作出口)。切片一与切片二之间无强依赖;切片三依赖切片一已就位的便宜档实例与 A2A/D12 配额基础设施(切片一 M2/M3 建成),故排在其后。基建线横穿三切片、按需生长;A1–A13 定级与 6 ADR 已冻、供采标准落地(非待拍阻塞),切片二的技术前置是 harness 小验。
### 切片一 · 便宜档达标上线
**目标**:便宜档(Tier0/1 · LittleJS · A-model)从框架已迁、九门 3/5,推到稳定 ≥80% 达标并端到端上线,Node 旧路退役。
**起点**:WU-A 已把生成核心重写进 Python/AgentScope,三品类金标对照 Python ≈ Node 全 equivalent(框架等价坐实,R1 第一道闸过)。当前五款 3/5,卡两类品类的生成幻觉。
**三个里程碑递进**:
- **M1 达标门绿(本机 / 实验室口径)**。治生成幻觉护栏(oracle 静态扫描:drawButton 返 void 被误赋值、define 形状误判、check 只查方法名的盲区),把卡住的品类救回;便宜档生产自验 play-spec 自动生成,脱离金标 spec、生产里自动产 spec 驱动九门;≥80% 达标门 bake-off(20 款测试样本 + 四模型横比 + 不依赖 Claude 的判定门);预算闸 < ¥10 接线 fail-closed。交付定义 = 便宜档稳定出 ≥80% 达标游戏(统计批跑口径)。
- **M2 上线就绪(到 Node 退役条件齐)**。auto-vs-golden delta 核对——生产自动 spec 要达到金标 spec 同等过门率,这是面向生产的 Node 退役授权前置(WU-A 对照证据是金标 spec 下采的,生产用自动 spec,两者要核平);灰度切换基础设施设计(路由 flag、A2A 任务状态、幂等 key、在途任务处理、D12 配额扣退语义,设计加本地可验部分);Node 退役门(达标 + 对照等价 + auto-vs-golden 三条齐,才把默认路由切到 Python)。交付定义 = 便宜档具备把默认路由切到 Python 的全部条件。
- **M3 真上线(后端集成)**。game-cloud 后端路由 flag 与 D12 扣退真接线;创作页一句话 → 生成 → 九门 → 发布门 → feed → 种子用户真人试玩端到端;对外开闸放行 6 门(独立 SoT [`验收门.md`](../architecture/架构/生成引擎/验收门.md))验过。交付定义 = 便宜档真上线跑在生产,Node 旧路退役。
**依赖与顺序**:M1 → M2 → M3。M1 本机可跑、无前置(WU-A 已就位)。M3 需后端协同。
**验收口径**:九门机制地板 + L2 设计符合 + ≥80% 达标门(统计批跑,与 tier2 的 n=5 收敛环是两套口径,别混);对外开闸放行 6 门在 M3。
**跨设计面**:WU-B 便宜档实例 · WU-C 5.4(护栏 / 自动 spec / 三层校验)· WU-C 5.6(engineBundle 装载)· WU-F(达标门 / 预算闸 / 灰度 / 退役);设计 SoT §4.1 / §5.4 / §5.6。
**后续细化**:M1 一份细化 plan(护栏 + 自动 spec + 达标门,接 002 的 harness 范式),M2 与 M3 各一份。
### 切片二 · tier2 富游戏 go/no-go
**目标**:复杂档(Phaser · tier2)用 n=5 收敛环定 go/no-go,拆掉“便宜或中等模型自治写约 56% 表现层能否稳定收敛”这个全线最大的悬念。
**起点**:U1–U7 核心、服务化 @8200、观测、落库已落(`tier2/HANDOFF.md`);0 号 spike `feie-005` accept,是首跑 n=1 机制验证、不是结论。
**序列**:
- **前置阻断小验:DockerWorkspace 托管 CDP harness**。验 agentscope 2.0.2 DockerWorkspace 能否托管 CDP 九门 harness(对比自建 Docker)。harness 跑不起来,收敛环无从批量取证,所以它前置于收敛环、先于其余运行时选型。
- **结构化契约门**。把偏脆的文本契约门(play-scene 工厂结构)做成结构化校验。收敛强依赖机器门把每类契约违规变成响亮可修的反馈,纯放开 ReAct 加软约束 prompt 不行。
- **n=5 收敛环**。并发跑 5,有错(超过 1)就读日志分析修复再追加一次 5,收敛即 go;给“前置阻断小验通过、收敛环开跑之前”的调参加显式上限(不超过 K 轮,或不超过预算 / 墙钟),超了按退路树走、不无限调。
- **go/no-go 判定 + 退路树**。装不出 → 补骨架;表现层崩 → 更模板化;便宜档全线不收敛而强档能过 → 换档;收敛需微调 → 留观。
**前置外部条件**:mini-desktop 可达(服务态 @8200 与真玩门都在 mini-desktop)。
**验收口径**:九门 + 富游戏三门(三联动 / 经济 / latch)+ 四收敛契约门;n=5 收敛环 go/no-go,不走 n≥30 统计批跑。
**跨设计面**:WU-B 复杂档 · WU-D 的 DockerWorkspace harness 小验(ADR-6 子项)· WU-C 5.4 结构化门 · WU-C 5.6(tier2 源项目契约七要素 schema + feed→play 第二装载分支,go/no-go 后交后端)· WU-F 判定;设计 SoT §4.2 / §5.1 / §5.4 / §5.6 / §二补⑥。
**后续细化**:06-22-003 的 U1–U10 作复杂档子计划保留引用(主体已落);收敛环跑作一份细化执行,不重排其可跑 runbook。
### 切片三 · A11 对话式调整回路
**目标**:用户试玩生成的游戏后回头调整,这条调整回路在生成实例侧有工程承接,落地产品阶段三承诺的对话式创作出口。首次生成不是终点,没有这条回路,对话式创作就是个无入口的孤儿。
**两档起步 + 一档后期**:
- **确定性覆写(起步必落)**。参数级调整(数值、配色、文案、节奏等可被结构化捕获的改动)不重跑生成,直接对源工程做确定性覆写再重新构建。零 LLM 不确定性、最快、可控性最高,是对话式微调的主路。
- **模块重生成(起步必落)**。调整落在某个模块(某个关卡、某条规则、某个场景),只对该模块走一次有界重生成,复用既有外层 resume 与三层校验,不动其余已验证模块,改完仍过九门。
- **整体重设计(后期)**。改动伤筋动骨(换玩法骨架、换品类),退化为一次新的整体生成。
**依赖与顺序**:坐在切片一的便宜档实例之上;两档都接 A2A 任务状态与 D12 配额(一次调整是一次受计费、受配额的生成任务)。
**验收口径**:九门 + 三层校验;确定性覆写额外要求重构建后产物仍过九门。
**跨设计面**:WU-B 的 A11 反馈回路 · WU-C 5.4 · WU-F 配额;设计 SoT §三 A11。
**后续细化**:一份 A11 细化 plan(确定性覆写 + 模块重生成两档)。
### 基建线 · 控制面 / 观测 / 配置热取
**内容**:配置注册表运行时热取(Langfuse 式 `id@label` 取、缓存 TTL、回落内置默认)、统一 trace 公共核心子集契约定稿(traceId / step / cost / verdict / timestamp 五字段对称,各轨不对称扩展段)、管理面 phase-1 只读最小切片(看各角色当前用什么模型、回放任意一次生成全轨迹、按 new-api 口径对账成本)。
**生长纪律**:这条线不预先全铺,按切片二 / 三的可观测、可调试、可治理需要长出来。硬约束两条:别在裂的地基(prompt 构建期快照这个反模式)上盖更大的注册表,先补一致性 CI 再推广;只有 Phaser 一个真实现时不抽能力面五件套通用接口,等第二引擎落地有两个实现再抽(rule-of-three)。
**现状**:D12 治理门已落(默认关、SAA Java 后端);tier2 侧 OTel 全落真跑;prompt 构建期快照是待治的反模式。
**跨设计面**:WU-C 5.2 / 5.5 / 5.7 / 5.8 · WU-E phase-1 · WU-D 第一批(ADR-3 trace、ADR-4 配置热取);设计 SoT §5.2 / 5.5 / 5.7 / 5.8。
**后续细化**:配置热取一份、公共 trace 契约一份、管理面 phase-1 一份,各自在被切片二 / 三拉动时产。
### 基线项 · A1–A13 协议定级与 6 ADR(设计已冻)
**状态**:A1–A13 的“现 / 建”定级与 §二补三 6 条 build-vs-buy ADR,已于 2026-06-24 §6.8 双评审(采纳但修)后收口定稿、定级已冻(设计 SoT §三、§二补二/三)。76KB 接口协议设计已并入设计 SoT、原档退役。这一项不是待拍的阻塞,是后续采标准落地的已冻基线。
**WU-D 采标准三批据已冻定级落地**:第一批观测治理(ADR-3/4)进基建线、第二批协议、第三批运行时 future-state,排期与依赖见基建线与切片二,不再有“等采纳拍板”这一步。
**剩余两项是执行验证、不是设计批准**(设计 SoT §二补⑥ 收口 TODO 明确):① DockerWorkspace 托管 CDP harness 小验——切片二收敛环的技术前置,不依赖任何待拍决策(见切片二);② durable-execution / 跨机扩容选型 spike——future-state。
---
## §5 High-Level Design:纵切切片依赖图
```mermaid
flowchart TB
subgraph NEAR["近期(reframe 核心执行)"]
WUA["WU-A 框架收敛<br/>便宜档 Node amodel-gen → Python 重写进 AgentScope agent(三档同构)<br/>移植范式、Node 旧路灰度兜底<br/>(吸收 06-18-001 地基产线化/策略外置)"]
WUB["WU-B 三档实例就位(SoT §四)<br/>便宜档 LittleJS·A-model(已落地板·待迁框架+达标门)<br/>复杂档 tier2·Phaser(吸收 003 主体成果 + n=5 收敛环)"]
WUC["WU-C 八面落地(SoT §五)<br/>控制面/热取·单写 ReAct·三层校验九门·能力面·源项目契约·OTel·四层职责"]
WUD["WU-D 采标准 6 ADR 分批(SoT §二补三)<br/>① OTel+Langfuse → ② A2A+MCP → ③ durable-exec+sandbox"]
subgraph DEC["基线:A1–A13 定级 + 6 ADR(设计已冻)"]
D["已冻定级供 WU-D 采标准落地"]
end
subgraph LATER["后期阶段"]
WUE["WU-E 控制面/管理面 + 配置发布审批边界<br/>配置注册表/观测仓/D12/管理面三 phase<br/>重要配置走 yudao 配置发布审批=受治理发版"]
subgraph SLICES["执行序列:三切片(按价值串行)"]
direction TB
S1["切片一 便宜档达标上线<br/>M1 达标门绿 → M2 上线就绪 → M3 真上线<br/>跨 WU-B / C5.4 / C5.6 / F"]
S2["切片二 tier2 go/no-go<br/>harness 前置 → 结构化门 → n=5 收敛环 → 判定<br/>跨 WU-B / D / C5.4 / F"]
S3["切片三 A11 调整回路<br/>确定性覆写 → 模块重生成<br/>跨 WU-B / C5.4 / F"]
end
subgraph INFRA["基建线(按需长出 · 不预铺)"]
I["控制面 / 观测 / 配置热取<br/>跨 WU-C5.2/5.5/5.7/5.8 / E / D 第一批"]
end
WUF["WU-F 验收与预算门(横切收口)<br/>便宜档 ≥80% 达标门 · 预算闸 <¥10/<¥50 接线<br/>tier2 n=5 收敛环 go/no-go · 协议层 A1–A13 待创始人拍"]
WUA --> WUB
WUB --> WUC
WUD -.标准供给.-> WUC
WUC --> WUE
WUB --> WUF
WUC --> WUF
WUD --> WUF
WUE -.受治理发版.-> WUF
S1 --> S2 --> S3
S1 -.便宜档实例·A2A·D12 前置.-> S3
D -.已冻定级供给.-> S2
D -.已冻定级供给.-> I
I -.可观测 / 治理供给.-> S2
I -.可观测 / 治理供给.-> S3
```
依赖与排序:WU-A 框架收敛先行(便宜档迁框架是后续达标门与控制面接入的前提);WU-B 与 WU-C 可并行推进(实例就位与八面实现互为支撑),WU-D 的标准落地按依赖顺序供给 WU-C(先观测/治理、后协议、再运行时);WU-E 是 WU-C 5.2 控制面的后期阶段深化、gated 在主线稳定后;WU-F 横切收口,在各档实例与八面就位后收 go/no-go。
三切片按价值串行(一 → 二 → 三):切片一、二无强依赖,切片三依赖切片一的便宜档实例与 A2A/D12 配额基础设施;基建线横穿、被切片二 / 三拉动时长出;A1–A13 定级与 6 ADR 已冻、供 WU-D 采标准落地(非待拍阻塞),切片二的技术前置是 harness 小验。每个切片纵向跨多个关注面,做完即交付。
---
## Work-Units
## §6 排期(挂 16 周波次轴)
### WU-A 框架收敛(reframe 核心执行项)
挂 [`docs/mvp/可行性方案16周-波次映射.md`](../mvp/可行性方案16周-波次映射.md) 的波次轴,状态以 [`docs/mvp/MVP进度总账.md`](../mvp/MVP进度总账.md) 为准。
**目标**:把便宜档的 Node amodel-gen 生成核心用 Python 重写成 AgentScope agent,与 tier2 同语言同框架,三档彻底同构在 AgentScope/Python 上;对齐 SoT §三 A1–A13 固定协议;生产编排收敛到 AgentScope 一套,SAA 降为远期适配验证目标。tier2 已在 AgentScope,本单元只处理便宜档重写迁移与框架双轨的消解。
**真实拓扑(定迁移面)**:便宜档的多轮 ReAct 生成循环(scaffold → ReAct M3 加五工具沙箱 → done 门 → stage)本体已在 Node.js + M3 的 amodel-gen 上跑;SAA Java 在这条链路里只当外层编排节点 + 九门 play 的 shell-out 调用方,不持有生成逻辑。因此本单元的迁移面 = 把 amodel-gen 这条已在 Node 上跑通的生成核心整条用 Python 重写进 AgentScope,而不是把生成逻辑从 Java 里搬出来(它本就不在 Java 里);SAA Java 这层外层壳与 Node 旧路在 Python 版达标后一并退役。
**迁移归属(三档彻底同构于 AgentScope/Python)**:创始人 2026-06-25 拍板便宜档与三档同构走重写、不走"JS 留、只换外层"。据此,WU-A 的迁移 = 把 amodel-gen 这条 Node.js 生成核心用 Python 重写成 AgentScope agent——移植它的范式(多轮 ReAct / 五工具沙箱 / done 门 / 历史压缩),用 Python 重新实现,与 tier2 同语言同框架。A1–A13 适配器协议骨架不变(语言中立的固定协议),变的是便宜档的实现语言与框架:从 Node/M3 整条搬成 Python/AgentScope。SAA Java 外层壳与 Node 旧路在 Python 版 ≥80% 达标后退役。本单元起步先出一个**迁移面 spike**,用 Python 重写一条最小生成链路(scaffold → ReAct → done → stage),对照现有 Node 版同输入跑、验产物等价 + 范式可移植,坐实"范式能整条搬上 Python"成立,再铺全量重写。
**落 SoT**:§一(可插拔 agent 平台)、§三(A 类固定协议 / B 类 `B-FRAMEWORK-AgentScope` 主框架 · `B-FRAMEWORK-SAA` 最低优先级)、§5.3(WG1 单轮 + 外层 repair 范式承接到 AgentScope 多轮)。
**吸收 06-18-001 的有效项**(SAA 主线骨架退役,但这些做法有效、迁进 AgentScope adapter):
- **地基产线化**:运行时访问约定(2D 适配器契约)→ A-model 已用真 src/ 兑现,把"约定迭代 1-2 轮收 3-5 类游戏真实输出再正式化、别冻早"的纪律带进 AgentScope 能力面(对应 §3.1 rule-of-three:单一实现不冻接口)。
- **策略外置**:多模型回退链(主便宜档 → stage2 救场升档)、JSON 容错、重试/超时/退避——这些是与框架无关的稳态策略,Python 重写时把范式一并移植、用 Python 重新实现,不随 SAA 与 Node 旧路一起退役。
- **oracle 加固**:校验边界静态扫描(治死循环 / 沙箱 / 确定性逃逸)、driver 命名路径投影、latch 终态驻留——这些是验收侧加固,归入 WU-C 5.4 三层校验。
**关键取舍**:便宜档迁框架不是把 SAA 裸图 16 节点平移到 AgentScope,而是把 amodel-gen 已在 M3 上跑通的整套范式(多轮 ReAct done 门 + check/build 快反馈 + 历史压缩)用 Python 在 AgentScope 上重新实现,使便宜档与 tier2 同语言同框架。amodel-gen(Node)在重写期作 Python 版的范式对照源——同输入比产物、比过门率——并作灰度兜底活跑到 Python 版达标,但它不再是迁移终态的运行时核心。SAA 那套裸图确定性多步编排作为 §一可插拔原则的远期适配样本保留——后期把它接成一个 A2A+MCP+OTel 端点,验证"异构框架共用同一套固定协议"。
**迁移契约(重写 + 对照验证)**:这是 R1 回滚与 WU-F 切换门的对账依据,逐项钉死。
- **当前链路(Node 旧路)**:创作页一句话 → D12 配额 + 提交侧合规两道入口门 → SAA Java 外层编排节点 → shell-out 调 Node amodel-gen 跑多轮 ReAct → done 门(check+build+stage+smoke 绿)→ SAA Java 九门 play 节点(shell-out `play.cdp.cjs`)→ verdict → 发布门入 feed。
- **目标链路(Python 新路)**:同两道入口门 → AgentScope(Python)agent 自身跑用 Python 重写的同一套多轮 ReAct(五工具沙箱 / done 门 / 历史压缩)→ done 门(同一套 check+build+stage+smoke 绿判据)→ 九门 play → verdict → 发布门入 feed。生成核心从 Node/M3 整条搬到 Python/AgentScope,产物形态(真 src/ 多文件)与验收口径(九门)两路一致。
- **路由 feature flag(灰度)**:走 Node 旧路还是 Python 新路由路由 flag 控,按比例灰度放量(先小流量 → 逐步抬比例),两条路同期可活,任何时刻可瞬切回 Node 旧路。
- **Python 版 vs Node 版对照验证**:Python 新路与 Node 旧路同输入跑,逐项比产物(真 src/ 结构与可玩性)与过门率(九门通过率),作为"范式已正确移植、未回退"的硬证据;对照不达标即不抬灰度比例。
- **任务状态迁移**:对齐 A2A 任务状态(submitted/working/input-required/completed/failed/canceled),两条路产同一组状态语义,前端轮询进度不感知底层换了实现。
- **幂等 key**:以创作请求维度的稳定 key 标识一次生成,灰度切换期同一 key 只允许一条路认领、产一份产物,防双跑双扣。
- **超时重试**:Python 新路移植既有稳态策略(双层超时、重试/退避、JSON 容错)再用 Python 重新实现;内部 done 门 / 墙钟上限的语义随范式一并搬过去、不丢。
- **D12 配额扣退**:入口先扣 D12 配额,失败或取消按补偿路径退还;灰度切换不改 D12 扣退语义,两条路走同一配额门。
- **在途(in-flight)任务处理**:切换或回滚瞬间已在途的生成不强杀,让其在原路(Node 旧路或 Python 新路)内跑完落 verdict;新进任务才按当前 flag 路由,避免半路换实现产脏态。
- **切换门槛**:Python 新路的便宜档生成成功率达到 ≥80% 达标门(WU-F)且与 Node 旧路对照验证产物等价才把默认路由切到它;未达标前默认仍走 Node 旧路,Python 新路只在灰度小流量上验证。
- **回滚触发条件**:灰度放量期生成成功率回退、九门通过率掉、或 Python 新路出现框架级稳定性问题,即把路由 flag 切回 Node amodel-gen 旧路(保留它活跑到 Python 版 ≥80% 达标)。
**验证**:便宜档经 AgentScope/Python agent 端到端产真 src/ 过九门;迁移面 spike 用 Python 重写最小链路、对照 Node 版验产物等价 + 范式可移植;Node 旧路与 SAA Java 外层壳保留活跑作灰度兜底、待 Python 版 ≥80% 达标后退役,SAA 异构适配仅作远期可插拔验证目标;框架双轨消解(三档同构在 AgentScope/Python 上,便宜档不再依赖 Node 运行态与 SAA Java 运行态)。
---
### WU-B 三档实例就位(SoT §四)
**目标**:两引擎三档生成实例各就位,都跑在 AgentScope 一套框架上,是同一套 adapter 协议在不同 AI 参与深度上的实例。
**落 SoT**:§四(三档·两引擎)、§4.1(轻-中档 LittleJS·A-model)、§4.2(最高档 Phaser·富游戏)。
**三档矩阵(Tier0 / Tier1 / Tier2)**:Tier0/1/2 按 AI 参与深度切分。Tier0 与 Tier1 同跑 LittleJS,过去被并称"便宜档"而没分开,这里分行拆清:它们引擎相同,但 AI 深度、模板/脚手架深度、预算档不同。引擎不是分档轴,AI 参与深度才是。
| 维度 | Tier0 | Tier1 | Tier2 |
|---|---|---|---|
| AI 参与深度 | 轻:AI 主要做配置与参数级填充,核心玩法由脚手架定 | 中:AI 在能力库之上自由写 L3 游戏代码(玩法逻辑、关卡、规则) | 最高:AI 自治写多系统富游戏,玩法/数据表/场景/角色整套自产 |
| 玩法模板 / 工程脚手架深度 | 深脚手架 + 强玩法模板,AI 改动面小、可控性最高 | 工程脚手架 + 可选品类引导框架,AI 在 L2 能力库上自由组合 | 薄玩法模板 + 富工程骨架(锁平台文件),AI 写绝大部分游戏代码 |
| 引擎 | LittleJS | LittleJS | Phaser |
| 产物形态 | `src/` 多文件源工程(改源不改包、重新构建) | `src/` 多文件源工程(同上) | 真 Phaser `src/` 工程(独立源项目契约七要素,落库可取回) |
| 验收口径 | 九门机制地板 + L2 设计符合 | 九门 + 三层校验(L1/L2/L3),≥80% 达标门(统计批跑) | 九门 + 富游戏三门(三联动/经济/latch)+ 四收敛契约门;n=5 收敛环定 go/no-go |
| 预算档(per-gen) | 便宜档 < ¥10(图音独立预算线另算) | 便宜档 < ¥10(同上) | 复杂档 < ¥50(图音独立预算线另算) |
| 波次锚点 | 阶段一(1-4 周) | 阶段一(便宜档已落地板,待迁框架) | 阶段二(5-8 周,富游戏品类) |
Tier0 与 Tier1 当前在执行盘点里合称"便宜档·LittleJS·A-model"(下文沿用此合称,内部按 AI 深度自然分布);Tier2 = 复杂档·tier2·Phaser。下面两节按便宜档(Tier0/1)与复杂档(Tier2)展开各自现状与待办。
**便宜档 · LittleJS·A-model(§4.1,含 Tier0/1)**:
- 现状 = 已落地板(A-model 写真 src/ + 11 插件 + 九门),待办 = 迁框架(依赖 WU-A)+ 达标门(交 WU-F)。
- 创作入口已开闸为一句话直接驱动(templateId 可选、缺省走 generic 通用路);这一档端到端闭环 = 创作页一句话 → D12 配额 + 提交侧合规两道入口门 → generic 的 AgentScope 生成路 → 轮询进度 → 过发布门入游戏 feed → 种子用户真人试玩。
- "轻量≠简单":用公共素材、玩法模板、工程模板低成本生成相对不复杂、又不易同质化的高质小游戏(L2 能力库 + L3 自由写),不是产没人会玩的简单玩具。
**复杂档 · tier2·Phaser(§4.2)**:
- 现状 = 吸收 06-22-003 的主体成果(U1–U7 核心 + 服务化 + 观测 + 落库,基准 `tier2/HANDOFF.md`),0 号 spike `feie-005` accept。
- 待办 = **n=5 收敛环验更多款**(并发跑 5、有错追加 5、收敛即 go;批跑底座已就位 · 设 n=5;go/no-go 交 WU-F);阶段 1 工作室 Agent Team(两阶段:阶段 1 Agent Team 星形设计发散 + 阶段 2 单写实现)留 Phase B。
- 两阶段、Agent Service、有界外层 resume、四熔断、M3 Anthropic 接法的细化,以 06-22-003 的 U1–U10 作复杂档子计划保留引用(主体已落),本计划不重排其可跑 runbook。
**试玩/HITL 反馈回路(A11,落 SoT §三 A11)**:首次生成出来不是终点,用户试玩后总要回头调,这条调整回路是产品"对话式调整创作"的工程出口,必须在生成实例侧有承接,否则上线主计划阶段三承诺的对话式创作就成了无入口的孤儿。本单元承接 A11 的迭代反馈回路,起步先落两档(确定性覆写 + 模块重生成),整体重设计档留后期:
- **确定性覆写(deterministic,起步必落)**:用户对已生成游戏提确定性参数级调整(数值、配色、文案、节奏等可被结构化捕获的改动),不重跑生成,直接对源工程做确定性覆写再重新构建。这一档零 LLM 不确定性、最快、可控性最高,是对话式微调的主路。
- **模块重生成(起步必落)**:用户的调整落在某个模块(某个关卡、某条玩法规则、某个场景),只对该模块走一次有界重生成,复用既有外层 resume + 三层校验,不动其余已验证模块,改完仍过九门。
- **整体重设计(后期)**:用户要的改动伤筋动骨(换玩法骨架、换品类),退化为一次新的整体生成,留后期。
- 反馈回路两档都接 A2A 任务状态与 D12 配额(一次调整是一次受计费、受配额的生成任务),验收沿用九门 + 三层校验,确定性覆写额外要求重构建后产物仍过九门。这一面挂阶段二(确定性覆写 + 便宜档模块重生成)/ 阶段三(对齐产品对话式调整创作出口)。
**关键取舍**:两档运行期零耦合,只在公共组件(计费 / 送审 / feed / 验收基线)交汇。tier2 复用 A-model 的引擎无关契约(四插件契约/命名 + `sim-business` 配方 + driver 感知 advisory 分级范式),但渲染 impl 按 Phaser 重做、探针整套重写。源项目契约维持独立 schema,不并进 A-model 的 LittleJS keystone(见 WU-C 5.6)。A11 反馈回路两档(确定性覆写 + 模块重生成)是产品对话式调整创作的工程承接,不是 WU-D 自研清单里那条孤立列名——WU-D 列它为自研项,本单元给它生成实例侧的目标落点与产品出口。
---
### WU-C 八面落地(SoT §五)
**目标**:把 SoT §五的八个 facet 从设计落到可照实现的颗粒度;各面三档共用同一套接缝,生成线只照契约办事。各面"现/建"承接执行现状盘点。
**5.1 运行时形态**:tier2 按 AgentScope 2.0.2 真实对象结构落地(Agent 无状态 ReAct 引擎非常驻 + AgentState 外置 + Workspace 双轴注入 + Middleware 洋葱 + Agent Team 星形)。现状已落并经 feie-005 accept;待 = 每轮 checkpoint 落 Redis 的完整 durable session(起步本地 runner)、阶段 1 Agent Team(Phase B)。
**5.2 控制面与配置热取**(深化交 WU-E):配置注册表是配置唯一事实源(prompt/model/skill/tool/mcp 五类),目标态采 Langfuse 式运行时热取(`id@label` 取、缓存 TTL、回落内置默认)。硬纪律 = 别在裂的地基上盖更大注册表,先补一致性 CI 再推广。现状 = prompt 构建期快照(反模式),tier2 `genconfig` 热配雏形。
**5.3 单写 ReAct 循环**:阶段 2 单写者 ReAct agent(想一步、调一个工具、看结果、再想)。一手教训 = 并行写背景跑成马里奥,故单写防写冲突。**多轮放哪一层的最终答案** = 内部 ReAct 单轮 reason→act + 有界外层 resume 续修(跨 reply 保留 memory),不是"搬进 Agent 内部"——0 号 spike 实测纯内部多轮会过早放弃(M3 看到 fix 就收尾)。四熔断 + 预算闸叠中间件洋葱(步数硬顶 / 预算闸 / 卡死探测 / 双层超时)。**纠 SoT 早稿错(已收口)**:官方 `ReplyBudgetControlMiddleware` 2.0.2 不存在,tier2 用自建 `on_system_prompt` + 硬熔断替代,比"软刹优雅收尾"强。M3 接法 = Anthropic 原生协议 + agentic 工具循环 + thinking 分离(max_tokens > thinking_budget)+ 完整 response 历史保留。
**5.4 三层校验与九门**(吸收 06-19-001 验收闭环):L1 硬约束(编译/启动/运行错误,零 LLM,必须循环逼解)、L2 设计符合(observe→enforce 才赋拒发权)、L3 效果(M3 视觉软检只评分、绝不阻塞、防 Goodhart,好不好玩最终归人工终审)。九门在真浏览器真玩取确定性证据(A_boot/B_uncaught/C_frame/D_render/E_live/F_wiring/G_input/H_progress/I_control);E_live 与 H_progress 是条件门(driven 感知 advisory 分级)。tier2 在九门之上补三道专属门(三联动 / 经济 / latch)。**吸收 06-19-001**:rubric 与九门划界(九门已客观覆盖项不重打,rubric 只补设计完整性层,资产对位一票否决)→ 归 L2/人工终审;广度抽检 + 8 页 CDP 走查 + smoke 5 链路 staging 真绿 → 归 WU-F 的对外开闸放行门。**待**:自产 driver 三层隔离(写者不能写判自己游戏的卷子,spike 第二段);把偏脆的文本契约门(play-scene 工厂结构)做成结构化校验。对外开闸放行 6 门(D12 / GP9 合规先行 / 落库观测三门 / 首局体验门 / G0/G1 前置)是独立 SoT [`验收门.md`](../architecture/架构/生成引擎/验收门.md),本面只引用。
**5.5 能力面:skills 与 MCP 工具**:单写 agent 九工具按角色分三类(核心环六个 write_source/build/headless_check/run_gates/read_verdict/finish + 取证两个 screenshot/query_assets + 起手收尾 scaffold_init/finish)。引擎 = 动态加载的能力包五件套(skill/tool/mcp/rag/scaffold),换引擎 = 换这一套加载的工具集、不动两阶段角色与三层校验主干。这一面落 §二"工具采 MCP-native、playbook 采 SKILL.md 开放标准"。**克制**:只有 Phaser 一个真实现时不抽五件套通用接口,等第二引擎落地有两实现再抽(rule-of-three)。
**5.6 源项目契约与装载**:两引擎装载分流。LittleJS 左支 = engineBundle 装载(A-model 写的真 src/ 构建成 engineBundle 内嵌 manifest,不构建即取即跑)。tier2 右支 = 真 Phaser 工程,新写独立源项目契约七要素四组(身份 / 工程骨架 / 构建可复现 / 落库取回),`finish` 工具交付形状与落库取回形状共用同一份 schema(从源头消除交付与落库漂移)。**必须另立独立 schema**,绝不复用低档同名 ECS-lite 数据壳契约,也不并进 A-model 的 LittleJS keystone(撞名但语义完全不同)。现状 = tier2 已产真 Phaser src/ + finish 门 + 服务态落库已部署;待(交后端)= 正式七要素 schema + feed→play 第二装载分支。
**5.7 观测与成本(OTel)**:统一 trace 契约管多个异构框架 adapter——接口层对称、内容层不对称(对称公共核心子集五字段 traceId/step/cost/verdict/timestamp + 各轨不对称 JSON 扩展段)。采集机制采 OpenTelemetry GenAI semconv,tier2 经 AgentScope 自带 Event System + 官方 TracingMiddleware→OTel,写轨迹的活只是"订阅加映射"。成本钉 new-api quota 权威口径(OTel 无成本属性),M3 Anthropic 路补 `RecordingChatModel(Anthropic)` 录制变体。现状 = tier2 侧全部已落并真跑验证(`Tier2TraceMiddleware` 647 事件 dropped=0、cost_rmb=¥1.29、`contracts/trace/` additive 位已立);待 = 公共核心子集契约定稿 + SAA 适配进来时的 adapter 映射(远期)。
**5.8 四层职责**:把 tier2 运行时拆成 environment/harness/context/prompt 四个职责视角,叠在 AgentScope 真实对象结构上。公共组件 = 自建 ∩ 共享(九门、三层校验、CDP、计费、送审、feed、trace),不是官方现成能力。配置分三类决定改了要不要发版(硬代码机制类随代码走 / 版本化安全构建类审计留痕 / 热配置策略类改配置不重部署),其中影响生产质量安全的重要配置发布走配置发布审批(WU-E)。
**关键取舍**:八面里 5.6/5.7 的 tier2 侧已落、5.1/5.3/5.4/5.5 核心已落(代码就位、feie-005 单跑全门过;稳定收敛性待 n=5 收敛环,见 WU-F/R2),本单元主要把"现/建"对齐到当前真相并补待建段(公共 trace 契约定稿、自产 driver 隔离、结构化契约门);别把已落的当待建重做。
---
### WU-D 采标准 6 ADR 分批落地(SoT §二补三)
**目标**:把 §6.8 双评审收口的 6 条 build-vs-buy ADR 分批落地,按成熟度分层、按依赖排序;每条已带 ≥3 具名候选 + 排除理由(SoT §二补三)。
**落 SoT**:§二(采标准:仓内自研 vs 2025 收敛标准)、§二补二(标准成熟度五列)、§二补三(6 条 ADR 决策矩阵)。
分三批,按依赖与成熟度:
- **第一批 · 观测/治理(可即采)**:ADR-3 trace 采 OTel GenAI + 自研 TraceLedger(钉版本 + 隔离,成本钉 new-api,补 Anthropic 路成本录制)→ ADR-4 配置热取采 Langfuse 式自托管 OSS(read 运行时热取 / write 走 GitOps 或后期 yudao 审批)。这批 tier2 侧 OTel 映射已落,Langfuse 热取待推广(先补一致性 CI)。
- **第二批 · 协议(Tools 即采 / Tasks 隔离)**:ADR-2 工具协议采 MCP-native(Tools 成熟即采,慢门第一版用平台 job handle+poll,MCP Tasks 2025-11 experimental 只进 spike gate)→ ADR-1 任务+状态协议采 A2A(状态机/流式/发现;cancel 仅状态壳 → 自研 cancel contract:取消点 Chrome/子进程/模型中断、费用结算、checkpoint、D12 释放、补偿、幂等)。
- **第三批 · 运行时(future-state · 独立选型)**:ADR-5 水平扩容近期用 agentscope 2.0.2 Agent Service(已落 @8200),跨机 durable-execution future-state(Temporal / DBOS 等 ≥3 候选独立选型,先旁路 tier2、不动在产 SAA K-槽)→ ADR-6 沙箱执行用 agentscope 2.0.2 Workspace(Docker 后端)+ tier2 自家 CDP harness,microVM(E2B/AgentRun)远期。注:ADR-6 的 microVM 整体属 future-state,但其中"DockerWorkspace 能否托管 CDP 九门 harness"这一小验不随 microVM 一起远期——SoT §5.4 把它定为 n=5 收敛环开跑前的前置阻断项,故单独前置出来(见下"前置阻断小验"),与 ADR-6 整体 microVM future-state 区分。
**前置阻断小验(阶段二 · n=5 收敛环前置)**:DockerWorkspace 托管 CDP harness 小验——验 agentscope 2.0.2 DockerWorkspace 能否托管 CDP 九门 harness(对比自建 Docker)。SoT §5.4 把这一项定为 n=5 收敛环开跑前的**前置阻断项**(harness 跑不起来,收敛环无从批量取证),故从 ADR-6 整体 microVM future-state 里单独前置出来,标"阶段二 n=5 收敛环前置、批准后即跑",优先级高于其余运行时选型 spike。
**收口前置的另一项 spike(future-state · SoT §二补⑥ 剩余项)**:durable-execution 选型 spike——验跨机扩容是否真需独立 durable-engine(还是 Agent Service durable session + K8s 够)。这一项随运行时第三批走 future-state,是"通过设计后的执行 plan",不与上面那条收敛环前置小验同期,排在主线稳定后。
**关键取舍**:自研只保留两块护城河(确定性验收门 + 生成专属 checkpoint/续跑),标准都不提供、必自建。可移植性是分层的——协议边界可迁移、业务语义层 net-new,排期按真实自研清单(A3/A4/A4.5/A8/A9/A11/A12 + A13 仍自研或待建),不按"只剩两块"。其中 A11(试玩/HITL 反馈回路)虽在此自研清单列名,其生成实例侧的目标落点与产品对话式调整创作出口在 WU-B 承接(确定性覆写 + 模块重生成两档),本单元只认它为自研协议项、不再让它悬空。
---
### WU-E 控制面/管理面 + 配置发布审批边界
**目标**:把 §5.2 控制面四组件落地——配置注册表、观测/审计仓、D12 运行治理门、管理面 UI;并钉死配置发布的审批边界。这是后期阶段(主线稳定后投)。
**落 SoT**:§5.2(控制面与配置热取)、§5.8(三类配置 / 配置发布审批)、ADR-4 write 路细化。
四组件:
- **配置注册表**:五类节点(prompt/model/skill/tool/mcp),目标态运行时热取;推广前先补一致性 CI(每条配置有对应文件、每个硬编码 id 登记、占位条目补正或标不可上线)。
- **观测/审计仓**:运行轨迹(落统一 trace 契约,见 5.7)+ 配置审计日志(谁、何时、改了哪条、前后 diff——这条线现在完全没有、全新建)。
- **D12 运行治理门**:现行已落(默认关闭,在 SAA Java 后端),只覆盖便宜档;tier2 接进来的入口、预算扣减、并发释放、失败补偿待补。预算三层纵向叠(worker 本地预测闸 / 网关配额闸 D12 / 任务 deadline 闸),任一先到上限即拦。
- **管理面 UI**:配置是真相、UI 是视图。三 phase 诚实命名落地——phase-1 配置管理 + 运行可观测(含纯只读最小切片:看各角色当前用什么模型、回放任意一次生成全轨迹、按 new-api 口径对账成本)、phase-2 限定范围图编辑(节点启停/参数/版本 diff/轨迹回放,拓扑来自运行时自报)、phase-3 完整可视化建图(远期不投)。一条贯穿约束:管理面对拓扑只渲染框架运行时自报的结构,绝不另持一份拓扑模型(反锁死在管理面的落点)。AgentScope Service 原生给 `/agent` 全 CRUD + `GET /agent/schema`,phase-1 配置管理直接建在它上、不自造。
**配置发布审批边界(后期阶段)**:
- **非关键配置**(运营开关、非关键 agent 装配)经 `/agent` CRUD 或热取即时生效,**不重新部署服务代码**。
- **重要配置**(关键 agent、关键玩法模板、质量与安全配置如 prompt 正文与生成门阈值)的发布**走 yudao 配置发布流程审批** = 受治理发版:提交变更 → 审批 → 通过才发布。即便不重部署服务代码,也是一次受治理的「发版」。这道审批发布**复用 game-cloud 现成的 yudao 能力**(`huijing-module-bpm` 工作流 + `huijing-module-infra` 配置管理),不自研(build-vs-buy 现货优先)。GitOps 退为 config-as-code 可选,二者择一或并存留后期定。
**关键取舍**:控制面早建是为 spike 调试和对账当下就用得上,不等于现在铺独立可观测中间件(存储复用已部署 MySQL + 对象存储)。管理面 phase-1 的只读最小切片优先(立刻能给创始人看见),配置编辑落 Git/审批不直接热生效。
---
### WU-F 验收与预算门(横切收口)
**目标**:把全线的验收门与预算门接成机器可校验的收口闸,定 go/no-go。
**落 SoT**:§5.2/§5.7(预算硬闸)、§5.4(三层校验)、§三 A5(验收门元协议)、§二补⑥(收敛环验证)。
四道门:
- **便宜档 ≥80% 达标门**:全 20 款 bake-off + 四模型横比 + Claude-free judge 门(测成功率需统计样本,配方见 [`skills/cheap-model-game-generation.md`](../../.agents/skills/cheap-model-game-generation.md))。这是"AI 生成成功率 ≥80%"(MVP 验收口径,85% 是远期蓝图、勿用 85% 卡 MVP)在便宜档的兑现。**注意**:这是统计批跑、与 tier2 的 n=5 收敛环是两套口径,别混。
- **预算闸 < ¥10 / < ¥50 接线**:便宜档 < ¥10、复杂档 < ¥50 硬闸 fail-closed(图音独立预算线另算);取价通路不可达时显式定策略(直接失败宁停不超支 / 降级纯 token 上限兜底,不留模糊)。三层强制落地前 tier2 只在严格时间盒实验里跑、绝不规模化。
- **tier2 n=5 收敛环 go/no-go**:并发跑 5、有错(>1)读日志分析修复再追加一次 5、收敛即 go;退路树按收敛失败模式分流(装不出→补骨架 R2 / 表现层崩→更模板化 R1 / 便宜档全线不收敛而强档能过→换档 R3 / 收敛需微调→留观 KEEP)。批跑底座已就位(便宜档 client / RunRecord / 退路树判定器 / batch_run+aggregate)、设 n=5,可直接跑。给"A 门后、B 门收敛环前"的前置调参加显式上限(≤K 轮或 ≤¥/≤墙钟,超即按退路树 KEEP/缓行),把"不再调参"前移一个兜底闸。
- **协议层 A1–A13 待创始人拍(人办清单决策 3)**:76KB 接口协议设计已并入 SoT §三 + §二补,原档退役;待创始人拍的是 SoT §三的 A8–A13 平台面接缝"现/建"定级 + §二补三 6 条 ADR 的最终采纳。这是设计批准动作、不是代码门,挂在本单元作收口前置。
**吸收 06-19-001 的对外开闸放行验证**:smoke 5 链路 staging 真绿、8 页 CDP 走查真数据、广度域抽检、创作→生成→feed 真玩纵切 + 资产可见、M0 core 联合验收门——这些是"对外开闸放行"层(独立 SoT [`验收门.md`](../architecture/架构/生成引擎/验收门.md) 的 6 门 + core-done 证据),坐在九门机制地板之上,本单元收口时一并验。
**收口 TODO(doc-sync)**:① `tier2/HANDOFF.md` 的 n≥30 字面改为 n=5 收敛环(2026-06-22 稿过时);② 06-22-003 的 U8–U10 纲要口径已被既成事实推翻,以 HANDOFF + git 重取现/建;③ 总账 `docs/mvp/MVP进度总账.md` 回填三档现状。
**关键取舍**:便宜档统计门(≥80%)与 tier2 收敛环(n=5)是两套验证口径、各自适用,合在一个单元里是为收口集中、不是合并口径。
---
## 吸收退役映射
三份旧 plan 的去向:
| 旧 plan | 处置 | 有效项去向 | 被退役/推翻的 |
|---|---|---|---|
| **06-18-001**(SAA 真结构化生成主线) | **退役 SAA 主线骨架** | 地基产线化(运行时约定迭代不冻早)→ WU-A/WU-C 5.5;策略外置(多模型回退/JSON 容错/重试)作范式 → WU-A Python 重写时移植重实现;oracle 加固(静态扫描/driver 投影/latch)→ WU-C 5.4 | SAA 裸图 16 节点 studio 主线 + gameDefinition 声明式源(被 reframe + A-model 写真 src/ 推翻;SAA 降远期适配验证;Node amodel-gen 作 Python 重写的范式对照源 + 旧路灰度兜底,不再是运行时核心。另两项 contract-first 待办(`source-project.schema.json` 增 `clickable` 枚举、`assertAfterPlay` 字段词汇契约)随 gameDefinition 声明式路废弃而 moot——A-model 写真 `src/` 不经声明式 component 契约) |
| **06-19-001**(core-done 验收闭环) | **整体入验收门** | 三层校验/九门划界/rubric → WU-C 5.4;smoke 5 链路/8 页走查/广度抽检/feed 真玩/M0 core → WU-F 对外开闸放行 | core-done ∧ gen-done 的双线拆分框架(Plan A 的 SAA gen-done 已随 06-18-001 退役) |
| **06-22-003**(tier2 富游戏自治生成线) | **复杂档,整体入 WU-B/C/F** | U1–U7 核心 + 服务化 + 观测 + 落库(主体已落)→ WU-B 复杂档 + WU-C 各面;U1–U10 作复杂档细化子计划**保留引用** | U8–U10「B 门后才投·纲要」字面口径(部分被既成事实推翻,以 HANDOFF 为准);n≥30 字面(改 n=5) |
退役不删档:三份旧 plan 留档(frontmatter 标 supersedes/absorbs 指回本计划),决策史可追。06-22-003 因 U1–U10 仍是复杂档可执行 runbook,作子计划保留引用而非退役。
---
## 排期(挂上线主计划波次轴)
挂 [`docs/mvp/可行性方案16周-波次映射.md`](../mvp/可行性方案16周-波次映射.md) 的波次轴。该映射第 6 条已登记"生成线现行真相(2026-06-25·三档统一框架)",本计划是其执行落点。状态以 `docs/mvp/MVP进度总账.md` 为准。
| 工作单元 | 波次锚点(16 周阶段) | 说明 |
| 切片 / 线 | 波次锚点(16 周) | 说明 |
|---|---|---|
| WU-A 框架收敛 | 阶段一(1-4 周)「极简编辑器+自研游戏流」 | 便宜档 Python 重写迁框架,移植已验范式(A-model 地板)、Node 旧路灰度兜底 |
| WU-B 三档实例就位 | 阶段一(便宜档)+ 阶段二(5-8 周,tier2 富游戏品类) | 便宜档已落地板待迁框架;复杂档 n=5 收敛环 |
| WU-C 八面落地 | 阶段二(5-8 周) | 横切实现,与 WU-B 并行 |
| WU-D 采标准 6 ADR | 第一批阶段二 / 第二批阶段二-三 / 第三批 future-state | 按成熟度分批,运行时批 future-state |
| WU-E 控制面/审批边界 | 后期阶段(阶段三 9-12 周 + 配置发布审批 future) | 主线稳定后投;yudao 审批 future-state |
| WU-F 验收与预算门 | 阶段二收口(≥80% / n=5 go/no-go)+ 阶段三-四(对外开闸放行) | 横切收口,分段验 |
| 切片一 便宜档达标上线 | 阶段一尾(M1)→ 阶段二(M2 / M3) | 阶段一主力,本机可跑起步,无前置 |
| 切片二 tier2 go/no-go | 阶段二(5–8 周) | 前置 = DockerWorkspace harness 小验 + mini-desktop 可达 |
| 切片三 A11 调整回路 | 阶段二尾 → 阶段三(9–12 周) | 接对话式创作出口 |
| 基建线 控制面 / 观测 | 随切片二 / 三长出 | 不预铺;phase-1 只读优先(立刻能给创始人看见) |
| 基线 A1–A13 定级 + 6 ADR | 设计已冻 | 2026-06-24 §6.8 双评审收口;供 WU-D 采标准落地 |
**日历闸门提醒**:16 周的真约束是日历闸门(IP 授权 / 软著 ICP / 渠道审核 / 算法备案),工程波次按 agent 产能并行、不是瓶颈。生成引擎这条线本身无日历闸门,但发布门入 feed 受备案约束(灰测红线 ≤2 万人 + 不接广告 + 报备删档,备案须在外测前完成)。
16 周的真约束是日历闸门(IP 授权 / 软著 / ICP / 备案 / 渠道审核),工程切片按 agent 产能并行、不是瓶颈。生成线本身无日历闸门,但发布门入 feed 受备案约束(灰测红线不超 2 万人、不接广告、报备删档,备案须在外测前完成),这条落在切片一 M3 与切片二上线侧。
---
## 风险与回滚
## §7 设计面对账(WU-A..F → 切片映射)
- **R1 框架收敛迁移风险(WU-A · 头号风险)**:头号风险 = 把 amodel-gen 这条已跑通的便宜档现行主力整条用 Python 重写并重新验证,等于推倒一条在产链路重做,回退风险高。缓解 = 对照验证(Python 新路 vs Node 旧路同输入比产物 / 过门率)+ Node amodel-gen 旧路灰度兜底(活跑到 Python 版 ≥80% 达标)+ ≥80% 达标门(WU-F)把关才切默认。回滚 = 路由 flag 切回 Node amodel-gen 旧路(它与 SAA Java 外层壳保留活跑、代码在,可瞬切回)。迁移走灰度、按比例放量、对照达标才抬比例。这是 reframe 最核心、迁移面最大的执行项,缓解全压在对照验证 + 旧路兜底 + 达标门三道闸上。
- **R2 tier2 收敛环 go/no-go 未定(WU-B/F)**:`feie-005` accept 是首跑 n=1 机制验证、不是结论;便宜/中等模型自治写约 56% 表现层能否稳定收敛是全线 go/no-go 所系。回滚 = 退路树按收敛失败模式分流(不再调参,转退路);收敛强依赖机器门把每类契约违规变成响亮可修反馈,纯放开 ReAct + 软约束 prompt 不行。
- **R3 采标准成熟度参差(WU-D)**:MCP Tasks(experimental)、durable-execution(范式非标准)、microVM/Langfuse 热取须标 maturity gate、不当"已收敛生产底座"。回滚 = 慢门第一版用平台 job handle+poll 不押 MCP Tasks;扩容近期用 Agent Service durable session、跨机 durable-engine future-state 旁路 tier2;沙箱近期 Local/Docker、microVM 远期。两项 spike 分两档:DockerWorkspace 托管 CDP harness 小验是阶段二 n=5 收敛环的前置阻断项(批准后即跑、先于收敛环),durable-engine 选型随运行时第三批 future-state;前者未出结论则 n=5 收敛环不开跑,后者未出结论则跨机扩容不推广。
- **R4 配置发布审批边界(WU-E)**:重要配置走 yudao 审批是后期阶段、复用现货;若 yudao 集成不顺,回滚 = GitOps config-as-code 兜底(write 侧),read 侧热取先补一致性 CI 再推广。别在裂的地基(prompt 构建期快照)上盖更大注册表。
- **R5 文档口径漂移(横切)**:本计划收三摊为一线,但 `tier2/HANDOFF.md` n≥30 字面、06-22-003 U8–U10 纲要口径仍是过时留痕;回滚/缓解 = 以本计划 + SoT + git 为准,WU-F 收口 TODO 做 doc-sync 改词,横切一致性主人(创始人 + 6c6g 文档/设计线)定灰色地带。
- **R6 "过门 ≠ 好玩"(WU-C 5.4)**:九门是机制地板、不是设计完整性;L3 视觉软检防 Goodhart 只评分不阻塞,好不好玩最终归人工终审。回滚 = rubric 补九门测不到的设计完整性层(资产对位一票否决)+ narrative 走评审 agent。
横切的六个工作单元在换轴后不作废,降为这张对账表。它有两个用途:保证纵切切片落地时能按八面下钻设计 SoT、不丢架构一致性;给后续切片细化提供“这个切片碰哪些设计面、对应设计 SoT 哪一节”的索引。WU-ID 在引用与回溯里继续有效。
| WU(设计关注面) | 落到哪个切片 / 线 | 设计 SoT 下钻 |
|---|---|---|
| **WU-A 框架收敛** | 切片一起点(✅ 已坐实:便宜档 Python/AgentScope 对照三品类 equivalent) | §一 / §三 / §5.3 |
| **WU-B 三档实例就位** | 切片一(便宜档)+ 切片二(tier2)+ 切片三(A11 反馈回路) | §四 |
| **WU-C 八面落地** | 切片一(5.4 / 5.6 便宜档装载)+ 切片二(5.1 / 5.4 / 5.6 tier2 源项目契约)+ 基建线(5.2 / 5.5 / 5.7 / 5.8);5.3 单写 ReAct 归 WU-A 行 | §五 |
| **WU-D 采标准 6 ADR** | 已冻定级(基线)→ 基建线(第一批 ADR-3/4)+ 切片二(ADR-6 harness 小验)+ 第三批 future-state | §二补三 |
| **WU-E 控制面 / 审批** | 基建线(phase-1 只读)+ 后期深化(配置发布审批 future) | §5.2 / 5.8 |
| **WU-F 验收与预算门** | 切片一(达标门 / 预算闸 / 灰度 / 退役)+ 切片二(n=5 go/no-go)+ 切片三(配额) | §三 A5 / §二补⑥ |
每个切片细化时,据这张表找到它跨的关注面,再到设计 SoT 对应节取设计、到对应的 WU 历史描述取上下文。横切的一致性(同口径同契约)由设计 SoT 与机器门保证。
---
## Sources & Research
## §8 Key Decisions(reframe 权威口径)
- 设计 SoT(本计划要落它)= [`docs/architecture/架构/生成引擎/agentic运行时架构图说.md`](../architecture/架构/生成引擎/agentic运行时架构图说.md)(§一命题 / §二补三 6 ADR / §三 A1–A13 / §四三档 / §五八面)。相邻 SoT:prompt 治理、验收门(对外开闸放行 6 门)、数据飞轮、OpenGame 对照(同目录)。
- 现状盘点源:`tier2/HANDOFF.md`(复杂档执行现状 + 0 号 spike feie-005)、`docs/plans/2026-06-22-003-feat-tier2-富游戏自治生成线-plan.md`(U1–U10 复杂档子计划)、[`.agents/knowledge/tech-decisions.md`](../../.agents/knowledge/tech-decisions.md) §4(便宜档现状:A-model 写真 src/、已实证地板 W-G1)。
- 吸收/退役的旧 plan:`docs/plans/2026-06-18-001-feat-gen-lifecycle-and-tier1-breadth-plan.md`(SAA 主线骨架退役、有效项吸收)、`docs/plans/2026-06-19-001-feat-coredone-验收闭环执行-plan.md`(验收闭环)。
- 波次轴:`docs/mvp/可行性方案16周-波次映射.md`(第 6 条已登记三档统一框架现行真相)、`docs/mvp/MVP进度总账.md`(状态权威源)。
- 已退役档(不作活档引用):`docs/plans/2026-06-23-接口协议层与可插拔模块-design.md`(76KB,2026-06-25 并入 SoT §三 + §二补)。
- 代码落点(现状核实):便宜档 A-model = `game-runtime/tools/amodel-gen/` + `game-runtime/games/_wg1-gen/`;复杂档 tier2 = `tier2/`(gen-worker / harness / fixtures / contracts / HANDOFF.md);插件库 = `game-runtime/src/plugins/`;九门 harness = `game-runtime/games/_wg1-gen/_shared/play.cdp.cjs`。
reframe 的七条口径(创始人 2026-06-25),换轴不改其一字,逐切片执行据此:
1. **框架收敛 AgentScope,三档彻底同构**。生产编排只押 AgentScope 一套,三档同语言同框架。便宜档的多轮 ReAct 生成核心已从 Node/M3 的 amodel-gen 整条用 Python 重写成 AgentScope agent(切片一 WU-A,已坐实);A1–A13 适配协议骨架不变。SAA / dify / coze 降最低优先级,留作远期适配验证可插拔——它们被适配进来这件事本身,就是对 §一可插拔原则的验证。
2. **三档按 AI 参与深度切分(Tier0/1/2),不是按引擎**。级别越高,AI 写进游戏的内容与代码越多。引擎按表现复杂度选(轻-中档 LittleJS、最高档 Phaser),引擎是实现、不是分档轴。
3. **全模板化、去超休闲**。三档都在玩法模板加工程脚手架上生成,没有一档从零写;最低档也得能商业闭环,无法闭环的超休闲玩具不做。玩法模板退化为可选的品类引导框架(经营 / 剧情 / 解谜 / TRPG / 非遗五品类),不是可执行的游戏壳。
4. **gameDefinition 已废,A-model 写真 src/ 是便宜档现行形态**。无 factory/gamedef 双轨、无 cutover,产物终态都是 `src/` 多文件源工程(改源不改包、重新构建)。
5. **per-gen 预算硬闸按 AI 深度档分级**:便宜档一次生成 < ¥10、复杂档 < ¥50;图像与音乐生成各走独立预算线、不计入这两个上限。这是“拉高、给足探索空间”的口径(对比 tier2 spike 实测仅 ¥1.29)。单位经济或模型单价大变即复审。
6. **tier2 验证走 n=5 收敛环,不是 n≥30**。并发跑 5、有错(超过 1)就读日志修复再追加一次 5、收敛即 go;退路树按收敛失败模式分流。便宜档 ≥80% 达标门是另一回事——测成功率需统计样本,走 bake-off 批跑(切片一),不在 n=5 收敛环口径内。
7. **采标准、自研只留两块护城河**。adapter 退化成三个标准端点(A2A 任务 / MCP 工具 / OTel trace)加两块自研(确定性验收门 + 生成专属 checkpoint/续跑)。采标准把“换框架”从推倒重来降到“重写 B 类实现、A 类协议不动”,不降到零(业务语义层仍 net-new)。修正已收口为 6 条 build-vs-buy ADR(设计 SoT §二补三、定级已冻),基建线与切片二据已冻定级分批落它。
---
## §9 风险与回滚(按切片重挂)
- **R1 便宜档框架收敛迁移(切片一 · 头号)**。把 amodel-gen 这条在产主力整条用 Python 重写并重新验证,等于推倒一条在产链路重做。三道闸:对照验证(已坐实,三品类 equivalent,第一道闸过)+ Node 旧路灰度兜底(活跑到 Python 版 ≥80% 达标)+ ≥80% 达标门把关才切默认(M1/M2)。回滚 = 路由 flag 切回 Node amodel-gen 旧路(它与 SAA Java 外层壳保留活跑、代码在,可瞬切回)。
- **R2 tier2 收敛环 go/no-go 未定(切片二)**。`feie-005` accept 是 n=1 机制验证、不是结论;便宜或中等模型自治写约 56% 表现层能否稳定收敛,是全线 go/no-go 所系。回滚 = 退路树按收敛失败模式分流(不再调参,转退路);收敛强依赖机器门把契约违规变成响亮可修反馈。
- **R3 采标准成熟度参差(基建线 / 切片二)**。MCP Tasks(experimental)、durable-execution(范式非标准)、microVM / Langfuse 热取须标 maturity gate,不当“已收敛生产底座”。DockerWorkspace 托管 CDP harness 小验是切片二的技术前置(设计已冻、直接跑、先于收敛环,不依赖待拍决策),durable-engine 选型随运行时第三批 future-state。
- **R4 配置发布审批边界(基建线后期)**。重要配置走 yudao 审批是后期阶段、复用现货;若集成不顺,回滚 = GitOps config-as-code 兜底,read 侧热取先补一致性 CI 再推广。别在裂的地基(prompt 构建期快照)上盖更大注册表。
- **R5 文档口径漂移 + 换轴双账(横切)**。`tier2/HANDOFF.md` 的 n≥30 字面、06-22-003 的 U8–U10 纲要口径仍是过时留痕,以本文 + 设计 SoT + git 为准。换轴新增一条:执行序列(本文 §4)与设计面对账(§7)是同一批工作的两个视图,切片细化或关注面变更时两侧要同步改,单改一侧即漂移——同步责任在横切一致性主人(创始人 + 6c6g 文档/设计线)。
- **R6 过门不等于好玩(所有切片)**。九门是机制地板、不是设计完整性;L3 视觉软检防 Goodhart,只评分不阻塞,好不好玩最终归人工终审。回滚 = rubric 补九门测不到的设计完整性层(资产对位一票否决)。
---
## §10 吸收退役映射
三份旧 plan 的去向(换轴后归到切片,不再归到 WU):
| 旧 plan | 处置 | 有效项去向 | 被退役 / 推翻的 |
|---|---|---|---|
| **06-18-001**(SAA 真结构化生成主线) | 退役 SAA 主线骨架 | 地基产线化、策略外置(多模型回退 / JSON 容错 / 重试)→ 切片一(随 Python 重写移植);oracle 加固 → 切片一 M1 护栏 | SAA 裸图 16 节点 studio 主线 + gameDefinition 声明式源(被 reframe + A-model 写真 src/ 推翻) |
| **06-19-001**(core-done 验收闭环) | 整体入验收门 | 三层校验 / 九门划界 / rubric → 各切片九门;smoke 5 链路 / 8 页走查 / 广度抽检 / feed 真玩 → 切片一 M3 对外开闸放行 | core-done ∧ gen-done 双线拆分(SAA gen-done 随 06-18-001 退役) |
| **06-22-003**(tier2 富游戏自治生成线) | 复杂档整体入切片二 | U1–U7 核心 + 服务化 + 观测 + 落库(主体已落)→ 切片二;U1–U10 作复杂档子计划保留引用 | U8–U10「B 门后才投·纲要」字面口径(部分被既成事实推翻,以 HANDOFF 为准);n≥30 字面(改 n=5) |
退役不删档:三份旧 plan 留档、frontmatter 标 supersedes/absorbs 指回本文,决策史可追。
---
## §11 Sources、换轴依据与收口 TODO
**设计 SoT(本文要落它)**:[`agentic运行时架构图说.md`](../architecture/架构/生成引擎/agentic运行时架构图说.md)(§一命题 / §二补三 6 ADR / §三 A1–A13 / §四三档 / §五八面)。相邻 SoT:prompt 治理、[`验收门.md`](../architecture/架构/生成引擎/验收门.md)(对外开闸放行 6 门)、数据飞轮、OpenGame 对照(同目录)。
**现状盘点源**:`tier2/HANDOFF.md`(复杂档现状 + feie-005)、[`002 multi-genre`](2026-06-26-002-feat-cheap-worker-multi-genre-plan.md) 与 [`001 spike`](2026-06-26-001-feat-cheap-worker-python-spike-plan.md)(便宜档 WU-A 框架对照坐实)、`cheap-worker/`(Python 重写落点)、`game-runtime/tools/amodel-gen/` 与 `game-runtime/games/_wg1-gen/`(A-model 便宜档现状)。
**换轴依据(2026-06-26)**:本次重构把执行主轴从关注面横切(WU-A..F)换成成果纵切(三切片),依据是 §3 的三个返工点——关注面横切下,一个交付成果的目标与实现手段被切到不同 WU,串行执行必返工。换轴遵守 canonical 唯一性门:不新建第二份同 topic canonical,在 plan① 原地重构,WU-A..F 内容全部保留为 §7 设计面对账,文件名不变(8 个活档引用其路径不死链)。WU 横切作设计落地结构仍有效,只是不再充当执行序列。
**收口 TODO**:① `assets/00-生成引擎执行总览.svg` 待 redraw 成纵切切片序列图(当前是横切 WU 版);② `tier2/HANDOFF.md` 的 n≥30 字面改 n=5(随切片二);③ [`MVP进度总账.md`](../mvp/MVP进度总账.md) 回填执行序列三切片现状;④ 换轴版已过 Codex + Opus 双评审、必修项已在档内修(2026-06-26);⑤ 设计 SoT §269「十一插件」与代码实际 12 个(8 基元 + 4 编排)不符,交横切一致性主人核正。