game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

merge: roadmap 粒度对齐敏捷迭代——里程碑=Release/迭代=多任务增量交付单元(3-8任务);B1-B6 重组为迭代1-4

Browse Source
This commit is contained in:
DKChan committed 2026-09-27 18:26:00 +08:00
2 parents d163160075 3abb3bd2e9
commit 213d61d5b2
1 file changed
+22 -22
Download Patch File Download Diff File Expand all files Collapse all files
roadmap.md
+22 -22
View File
@@ -1,7 +1,7 @@
# 工程路线图（批次执行制：里程碑 + 批次序列 + loop 规范）
> 一句话：项目级进度视图——走到哪了、接下来按什么顺序走、每个批怎么跑。**实时状态以仓库根 [active.md](active.md) 顶部「当前状态快照」节为准**（会话级、高频更新）；待办事项明细以 [06-待办清单](design/gdd/06-待办清单.md) 为唯一登记处（条目级）；本文件只管批级序列与门，里程碑移动才更新。
> 成文 2026-09-17；**2026-09-27 重整为批次执行制**（用户立规：任务一律按本路线图批次统一执行、零散并行会话退场——冲突源与介入成本；详见「执行纪律」节）。
> 成文 2026-09-17；**2026-09-27 重整为批次执行制**（用户立规：任务一律按本路线图批次统一执行、零散并行会话退场——冲突源与介入成本；同日二次修订：粒度对齐敏捷流程——里程碑=发布级目标、迭代=多任务增量交付单元，详见「执行纪律」与「迭代粒度界定」）。
## 里程碑时间线
@@ -25,43 +25,43 @@
- **挂起待用户输入（批次解锁点）**：① 样张 v1 否决原因（解锁样张 v2 → 换皮/演出/数字终稿）② ADR-0007 三方案裁决（甲分栏/乙并流/丙并流+日志——解锁关卡节点图生成特性批或 rng 架构批）③ 真人试玩批次（解锁曲线调参读数）
- **已知挂账**：曲线调参批（基线读数重测+杠杆扫描，段界结账口径）；魔法道具内容批（node-reward spec 随批出生）；反制批 Alpha
## 主线路线（批次序列与门）
## 主线路线（里程碑 × 迭代序列）
> **提案序，开工逐批点名**；每批 = 一个 loop（规范见下节）。批次内任务清单的事实源 = 06-待办清单对应条目 + 各 UX spec 的 AC。
> **提案序，开工逐迭代点名**；每个迭代 = 一个 loop（规范与粒度界定见下节）。迭代内任务卡的事实源 = 06-待办清单对应条目 + 各 UX spec 的 AC。
### M-1 切片表现收口（现行里程碑）
### M-1 切片表现收口（Release 1，现行里程碑）
**完成定义**：表现层与测试兜底全部落籍，切片期不再产生零散表现批。出口闸 = 真人目检清单全绿 + 冒烟/探针全绿 + doc 三闸 + 熵增闸 + MC 逐位对拍零漂移。
**完成定义**：表现层与测试兜底全部落籍，切片期不再产生零散表现改动。出口闸 = 真人目检清单全绿 + 冒烟/探针全绿 + doc 三闸 + 熵增闸 + MC 逐位对拍零漂移。
| # | 批次 | 门（前置） | 内容概要 |
| # | 迭代 | 门（进入条件） | 更改任务 |
|---|---|---|---|
| B1 | 测试基建批（**P0**，2026-09-27 用户裁定先于表现批） | 无——可立即开工 | 单元测试与接口契约层补建（`game/tests/unit` 挂载：ConfigDB/伤害单据/池乘区纯函数覆盖 + 系统间接口契约测试）；06「单元测试与接口契约层补建」承载 |
| B2 | 样张 v2 批 | **用户输入闸**：v1 否决原因（剩 2 roll 预算） | 按 §1.4 清单重出样张；过 = 四冻结（砖面形态/色板/动画方案/数字形制）——M-1 内换皮、演出、数字三项的解锁闸 |
| B3 | 表现收口循环 2（计划书批） | 换皮/演出/数字部分 = 样张 v2 冻结；其余（关卡画面/接线）不等样张可先行 | ①换皮：界面环境与框材组 8 件（♻ 复用件审阅接线/✦ 背景横幅生图）②演出密度终稿（死亡碎裂/胜利纹章/失败掸灰/意图与结算动画）③棋盘数字呈现终稿 ④高墙感挑档落码（B 轮廓/C 立面/D 投影，推荐 D）⑤CJK 字体随包挑定（Fusion Pixel OFL / Kenney CC0）⑥C 区本关强化列表接线 ⑦关卡画面实装（[level-map](design/gdd/ux/level-map.md) 三拍板落地+停点标题+顶栏 GP 徽章+图上命中探针改造）⑧战斗胜利结算 GP 总量+增量接线；06「战斗画面表现收口（循环 2 输入清单）」承载 |
| 迭代 1 | 测试兜底与表现先行 | 无硬门——可立即点名；测试卡按用户 P0 裁定排最前 | ①单元测试与契约层（ConfigDB/伤害单据/池乘区纯函数 + 系统间接口契约，`game/tests/unit` 挂载）②高墙感挑档落码（开工时用户快挑 B 轮廓/C 立面/D 投影，推荐 D）③CJK 字体随包挑定（Fusion Pixel OFL / Kenney CC0）④关卡画面实装（[level-map](design/gdd/ux/level-map.md) 三拍板落地+停点标题+顶栏 GP 徽章+图上命中探针改造）⑤战斗胜利结算 GP 总量+增量接线 ⑥underdark/deep_underdark 瓦片换色 |
| 迭代 2 | 样张冻结与表现定稿 | **用户输入闸**：样张 v1 否决原因（剩 2 roll 预算） | ①样张 v2 重出+机检+终审（过 = 四冻结：砖面形态/色板/动画方案/数字形制）②界面环境与框材组 8 件换皮接线（♻ 复用件审阅+✦ 背景横幅生图）③演出密度终稿（死亡碎裂/胜利纹章/失败掸灰/意图与结算动画）④棋盘数字呈现终稿；06「战斗画面表现收口（循环 2 输入清单）」承载 |
### M-2 切片数值标定与 Alpha 验收
### M-2 切片数值标定与 Alpha 验收（Release 2）
| # | 批次 | 门 | 内容概要 |
| # | 迭代 | 门（进入条件） | 更改任务 |
|---|---|---|---|
| B4 | 验收读数重测批 | M-1 出口（表现定稿后读数才不被呈现改动扰动） | 段界结账口径基线重测（MC/verifier 全段）+ 真人 3–5 局并入；06「刷新经济性监控」阈值随批 |
| B5 | 曲线调参批 | B4 读数 | 四级阶梯落档+三杠杆扫描+AC 行值投值+L2 池验证；**关卡节点图生成台阶一实施批同窗或随后**（前置 = ADR-0007 裁决） |
| B6 | Alpha 验收批 | B5 | draw calls 真机测量（270→<200）+ 真人目检清单总清 + 07-体验验证清单总对账 + 真人通关率标定 |
| 迭代 3 | 读数重测与调参 | M-1 出口闸（表现定稿后读数不被呈现改动扰动）；⑤号卡另需 ADR-0007 裁决 | ①MC/verifier 基线重测（段界结账口径全段）②真人 3–5 局并入 ③四级阶梯落档+三杠杆扫描 ④AC 行值投值+L2 池验证 ⑤关卡节点图生成特性批（若 ADR-0007 走乙/丙则 rng 架构批任务先行入卡） |
| 迭代 4 | Alpha 验收 | 迭代 3 出口 | ①draw calls 真机测量（270→<200）②真人目检清单总清 ③07-体验验证清单总对账 ④真人通关率标定 |
### M-3 内容与元进度深化（后置轨并轨）
### M-3 内容与元进度深化（Release 3，排序在 M-2 出口后按读数定）
魔法道具内容批（node-reward spec 随批出生+C 区道具槽接线）· 元进度数值标定（换算率/柜台定价）· 反制批 Alpha · 关卡内容扩展。排序在 M-2 出口后按当时读数定。
魔法道具内容迭代（node-reward spec 随批出生+C 区道具槽接线）· 元进度数值标定（换算率/柜台定价）· 反制批 Alpha · 关卡内容扩展。立项时按「迭代粒度界定」拆任务卡。
## 执行纪律（2026-09-27 用户立规）
1. **一批一 loop**：所有任务（功能/文档/数值/素材接线）一律走本路线图批次，每批先立计划书再开工——**零散并行会话退场**（多会话并行 = 冲突源+介入成本；2026-09-27 起单批串行执行）。
2. **例外 = 零碎 bug**：单独会话 mini-loop 修复（修→轻闸→台账登记），不立计划书、不占批次位；同屏同类 bug 攒够一笔可并入下一批次。
3. **用户输入闸显式化**：批次门里所有需要用户表态的点（否决原因/裁决/试玩）在「当前位置」挂起清单可见，解一个开一个。
1. **一迭代一 loop**：所有更改任务（功能/文档/数值/素材接线）一律进本路线图的迭代，每迭代先立计划书再开工，一个迭代一次合并登记——**零散并行会话退场**（多会话并行 = 冲突源+介入成本；2026-09-27 起单迭代串行执行）。台账记「批」= 本文件记「迭代」，同物异名。
2. **例外 = 零碎 bug**：单独会话 mini-loop 修复（修→轻闸→台账登记），不立计划书、不占迭代位；同屏同类 bug 攒够一笔可并入下一个迭代当任务卡。
3. **用户输入闸显式化**：迭代门里所有需要用户表态的点（否决原因/裁决/试玩）在「当前位置」挂起清单可见，解一个开一个。
## 批次 loop 规范（loop engineering）
> 模板先例 = 循环 1 计划书（`.zcode/plans/battle-stage-node2d-loop-plan-2026-09-26.md`，已完整跑通收口）。每批照此八件成文，缺件不开工：
1. **计划书**（`.zcode/plans/<批名>-loop-plan-<日期>.md`）：批次目标与完成定义 / 现状事实（代码级，开工自行复核）/ 设计契约（违反即返工，标 🔴 触碰=L3 停机）/ 范围边界 / 任务卡 T0..Tn（逐卡估时）/ 验证闸 / 异常分级 / 代拍板白名单。
> 模板先例 = 循环 1 计划书（`.zcode/plans/battle-stage-node2d-loop-plan-2026-09-26.md`，已完整跑通收口）。每迭代照此八件成文，缺件不开工。
>
> **迭代粒度界定（对齐敏捷迭代/Sprint）**：一个迭代 = 一句迭代目标 + **3–8 个更改任务** + 一份计划书 loop + 一次合并登记，交付一个可验证增量（≈一次迭代交付）。单交付物不成迭代——并入相邻迭代当任务卡；用户输入闸未解的任务不进迭代（留 06 当 backlog，解闸后编入下一个迭代）；软时间盒 ≤3 个工作日，超限即切迭代（L3 汇报）。**里程碑 = 2–4 个迭代的发布级目标 + 出口验收闸（≈Release）**。
>
1. **计划书**（`.zcode/plans/<迭代名>-loop-plan-<日期>.md`）：迭代目标与完成定义 / 现状事实（代码级，开工自行复核）/ 设计契约（违反即返工，标 🔴 触碰=L3 停机）/ 范围边界 / 任务卡 T0..Tn（逐卡估时）/ 验证闸 / 异常分级 / 代拍板白名单。
2. **T0 开工**：建 worktree + 基线复读记档（冒烟/探针/三闸/MC 对拍基准）+ `git status` 归属核对（并行遗留只标旗不碰）。
3. **循环骨架**：一轮 = 一个任务卡——读卡 → 对事实源 → 实装 → 轻闸全绿 → 提交（代拍板随 commit 记录）→ 台账追加（查撞号）→ 下一轮。单 worktree 多点提交一次合并；轮内禁开第二个 worktree；基线每轮开工时点重测；断点续跑 = `git log` 对任务卡定轮次 + 重跑当轮轻闸。
4. **轻闸**（每轮必跑，headless）：run_smoke 全量 + ui_input_probe（十一断言）；触碰 presentation 加跑 ui_click_probe + ui_layout_probe。