diff --git a/.zcode/hooks/stop-active-md-guard.sh b/.zcode/hooks/stop-active-md-guard.sh index a6c2aa48..e83c693b 100644 --- a/.zcode/hooks/stop-active-md-guard.sh +++ b/.zcode/hooks/stop-active-md-guard.sh @@ -18,6 +18,6 @@ now_mtime=$(stat -c %Y "$active_md" 2>/dev/null || echo 0) [ "$now_mtime" -gt "$start_mtime" ] && exit 0 touch "$state/$sid.reminded" cat >&2 <<'MSG' -[会话收口检查] 本会话产生了工作区改动,但 production/session-state/active.md 未在本会话内更新。若本会话包含实质工作(代码/文档/数值/设计拍板/缺陷修复),请先在 active.md 末尾追加一条编号批次条目(做了什么·拍板了什么·验证结果·遗留与下一步),再行结束;若本次确无可登记事项(纯问答、只读核查),忽略本提醒直接结束。另:待拍板事项登记 design/gdd/06-待拍板清单.md(裁决后改状态列留痕),不要写进 active.md 条目表。 +[会话收口检查] 本会话产生了工作区改动,但 production/session-state/active.md 未在本会话内更新。若本会话包含实质工作(代码/文档/数值/设计拍板/缺陷修复),请:① 先更新 active.md 顶部「当前状态快照」节(在飞/可做/阻塞/锚点/下一步——先改快照再记账);② 再在 active.md 末尾追加一条编号批次条目(做了什么·拍板了什么·验证结果·遗留与下一步)。完成后结束;若本次确无可登记事项(纯问答、只读核查),忽略本提醒直接结束。另:待办事项登记 design/gdd/06-待办清单.md(裁决后改状态列留痕),不要写进 active.md 条目表。 MSG exit 2 diff --git a/CLAUDE.md b/CLAUDE.md index 4500ddb3..8ee2cbb9 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -28,7 +28,7 @@ - `design/gdd/` — 现行设计文档树(根索引 `02-系统清单.md`;文档增删必须同步它) - `design/archive/gdd-2026-09-14/` — 旧版 GDD 归档(只读参考,不作事实引用) - `design/registry/` — 跨系统事实登记(术语规范名、已锁数值) -- `production/` — stage、session-state、gate-checks、qa +- `production/` — stage、session-state、roadmap、gate-checks、qa - `prototypes/dungeon-sweeper-vertical-slice/` — 垂直切片(概念 demo 已删,验证报告留档 `docs/prototype-report-minesweeper-battle-concept.md`) - `docs/` — 规范与参考文档(权威清单见下方导航) @@ -42,7 +42,8 @@ | 架构与决策记录 | `docs/architecture/architecture.md` + 同目录 `adr-*.md` | | 引擎版本与参考 | `docs/engine-reference/godot/`(版本表已在上方 @ 引入) | | 术语、已锁数值 | `design/registry/entities.yaml`——仅 owner 文档可修订,冲突须显式提出 | -| 会话进度记录 | `production/session-state/active.md`——每条 ≤3 行,详情外链 | +| 会话进度记录 | `production/session-state/active.md`——顶部「当前状态快照」节 + 批次台账;收口先改快照再记账,每条 ≤3 行,详情外链 | +| 工程路线图 | `production/roadmap.md`——里程碑时间线与下一步顺序(批级视图;实时状态看快照节) | ## 硬性红线(勿违反) diff --git a/production/roadmap.md b/production/roadmap.md new file mode 100644 index 00000000..deac0554 --- /dev/null +++ b/production/roadmap.md @@ -0,0 +1,30 @@ +# 工程路线图(里程碑时间线 + 下一步顺序) + +> 一句话:项目级进度视图——走到哪了、接下来按什么顺序走。**实时状态以 `production/session-state/active.md` 顶部「当前状态快照」节为准**(会话级、高频更新);本文件是批级视图,里程碑移动才更新。 +> 成文:2026-09-17。 + +## 里程碑时间线 + +| 时间 | 里程碑 | +|---|---| +| 2026-09-07 | 阶段锚定 Systems Design;数据配置、行动经济 GDD 收口 | +| 2026-09-08 ~ 09 | 地形变异、增益状态、棋盘生成、排雷玩法、敌人系统、地图战斗资源 GDD 收口 | +| 2026-09-10 | 战斗结算 GDD 收口 | +| 2026-09-12 | 概念原型 v3 终验 PROCEED(垂直切片承接);DND 敌种更名;试玩批次 1(基线满通关 → 数值上调批) | +| 2026-09-13 | 切片封装收口批 + P2 收口批;art-bible §1–4 定稿;HUD框架 GDD 定稿(MVP 设计收口前夜) | +| 2026-09-14 | GDD 体系重构(旧树封存、新骨架重建);魔法道具、冒险结构 GDD 定稿;完美策略档测量批(100% 通关暴露完美档失真) | +| 2026-09-15 | 命名清偿批;格面资源批(五段结算/极性路由/可选类删除);攻击类型与奖励抽象分离;护甲等级登记批;伤害量值区间批 | +| 2026-09-16 | 行动点压速批 8→6;护甲等级掷点批落地(smoke 233 全绿);AP6+AC 验收判读口径 v1.0;06-待办清单建账改版;系统更名批;敌人技能池提案对答启动 | +| 2026-09-17 | 敌人技能池提案定稿(1c63830);技能池实施批落地(smoke 263 全绿,待收编);魔法道具切片期空内容拍板;关卡节点地图定稿批解锁;跨会话状态持久化批(快照节 + 本文件 + 守卫文案升级) | + +## 路线图(主线路线与门) + +1. **技能池实施批(已落地,smoke 263 全绿;待一笔收编提交)**:批 1 核心机制 + 批 2 呈现替代 + 批 3 文档与 registry 已完成;收编提交后本站闭合。设计权威 = `docs/proposal-skill-pool.md`。 +2. **验收批**(门 = 技能池批收编 + 工作区净 + smoke 全绿):按 `docs/acceptance-ap6-ac.md` v1.0 跑三数据源(蒙特卡洛双档 / 真人 3–5 局 / 日志分析器),无道具基线;产出判读结论与选档建议。 +3. **难度曲线阶段二调参批**(门 = 验收读数):四级阶梯落档 + 三杠杆扫描(血量锚走廊 / 群战上探 / 注入衰减)+ 挖掘风险不等式与清图支配性两对账重跑 + AC 行值投值。 +4. **第二关内容批**(门 = 调参行值):深度轴行值 D1–D4 填充 + 新内容投放(技能池定稿后 = 既有池新技能);填齐后两关序列生效。 +5. **并行 / 后置轨道**:关卡节点地图 GDD 定稿批(已解锁,与在飞批零文件冲突);魔法道具内容批(排切片收尾后);真人通关率标定(挂 playtest 批);元进度定稿(Alpha 前必须裁——代币 vs 钥石资源关系为最重缺口)。 + +## 维护纪律(收口批四步) + +① 改 active.md 顶部快照节 → ② 追加台账条目 → ③ 里程碑移动才更新本文件时间线 → ④ 阶段变更才改 production/stage.txt。Stop 守卫钩子强制 ①②(拦截 + 提醒,不代笔);快照节 ≤10 行,装不下的细节进台账。 diff --git a/production/stage.txt b/production/stage.txt index 7218f9ad..82c21ac8 100644 --- a/production/stage.txt +++ b/production/stage.txt @@ -1 +1 @@ -Systems Design \ No newline at end of file +Vertical Slice Implementation \ No newline at end of file