From 3dbbbf43bc02ffac263b7e4fae3131c56cb9a856 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Thu, 29 Oct 2026 02:55:52 +0800 Subject: [PATCH] =?UTF-8?q?=E7=99=BB=E8=AE=B0(=E9=AA=8C=E8=AF=81=E4=B8=8E?= =?UTF-8?q?=E6=B8=85=E5=8D=95=E4=BD=93=E7=B3=BB=C2=B7=E9=98=B6=E6=AE=B51?= =?UTF-8?q?=E6=94=B6=E5=8F=A3):=20=E4=BA=94=E6=89=B9=E8=90=BD=E5=9C=B0?= =?UTF-8?q?=E5=87=AD=E6=8D=AE=E5=85=A5=E5=AE=9E=E5=86=B5=E2=80=94=E2=80=94?= =?UTF-8?q?03=20=E8=83=BD=E5=8A=9B=E5=AE=A1=E8=AE=A1=E6=8E=A5=E9=97=B8?= =?UTF-8?q?=E4=B8=8A=E7=94=B5=EF=BC=88915222fa=EF=BC=89=E3=80=8105=20GDD?= =?UTF-8?q?=20=E6=B8=85=E7=90=86=20124=20=E5=A4=84=E5=AE=9E=E7=8E=B0?= =?UTF-8?q?=E6=8C=87=E8=AF=81=E5=BD=92=E9=9B=B6=EF=BC=9B=E8=BF=AD=E4=BB=A3?= =?UTF-8?q?41=E6=B5=8B=E8=AF=95=E5=80=BA=E6=9D=A1=E7=9B=AE=E6=A0=87?= =?UTF-8?q?=E6=98=8E=E5=B8=A6=E7=BA=A2=E5=90=88=E5=B9=B6=E8=A3=81=EF=BC=88?= =?UTF-8?q?=E4=BB=A3=E7=A0=81=E5=9F=9F=E7=BA=A2=E7=94=B1=E8=AF=A5=E6=9D=A1?= =?UTF-8?q?=E6=89=BF=E6=8E=A5=EF=BC=8C=E6=9C=AC=E6=89=B9=E9=9B=B6=E6=96=B0?= =?UTF-8?q?=E5=A2=9E=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 待办清单.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/待办清单.md b/待办清单.md index 4de346f5..7ed7d641 100644 --- a/待办清单.md +++ b/待办清单.md @@ -4,7 +4,7 @@ #### 验证与清单体系整改——四方向分阶段推进（2026-10-28 登记，来源=会话提及） -**实况**：用户裁「验证及清单不合理」，经调研定四方向全做、分阶段推进：A 粒度整改（清单从断言级升到能力/行为级，逐断言账本退役）→ B 精简裁断（在新粒度上规则驱动删并）→ C 流程风险分级（P0/P1/P2 验收强度、审计抽样）→ D 文档减肥（待办条目限长、历史归 git）；测试有效性度量暂不处理。阶段 0 盘点已毕：验证集清单零机器闸依赖（run_all_gates／hooks／五技能均不引用，仅 test-conventions §8.3 维护锚＋2 份过程报告引用），退役无闸改动；但测试名尾缀仅覆盖 28/47 个有断言文件（19 个零尾缀，含 seal_polarity 69 条、variant_placement 42 条、roll_multiplier 35 条），故能力清单只能按「能力→代表用例」建，不要求逐断言尾缀。对照表列改动触 pipeline_gate＋req-card／iter 两技能；待办正文压缩不触机检（无长度判据）。盘点明细见 reports/盘点-验证与清单体系-2026-10-28.md。**阶段 1 设计已闭合（2026-10-28 用户四裁点）**：能力清单 v1 落 `game/tests/README.md`——按系统归属与玩家旅程排序，首期核心四域（存档与随机、冒险循环、战斗结算、奖励与经济）29 行＋跨域条件闸 1 行，共 30 行，每行真实入口＋2–3 个代表用例（`文件:函数`），维护规则为每批收口核对本批受影响行并刷新「最后验证批次」；`design/engineering/test-conventions.md` §8.3 维护锚改写为「验证集清单整册冻结、能力清单承接覆盖索引、阶段 2 精简后删除」；`game/tests/验证集清单.md` 头注同步冻结声明，冻结快照（基点 `b9260138`／1587 条）留作阶段 2 对账基准；`tools/extract_checks.py` 保留为审计工具，不再承担常态同步。**阶段 2 已执行闭合（2026-10-28 C 档合回）**：存量断言精简 C 档 6 组手写断言族并为 7 个表驱动站点（33→7），冻结清单对账 1587→1561，验证集清单随阶段 2 完成退役（覆盖索引归能力清单，维护锚 test-conventions §8.3），删并申报与件核见 reports/工程改动报告-存量断言精简C档-2026-10-28.md；阶段 3–4 待各自设计推进：风险分级与审计抽样规则、条目限长是否入 pipeline_gate 均未定。**2026-10-29 阶段 1 落地定稿（用户三裁）**：①能力清单与覆盖域表落 `game/tests/README.md`，独立成表、不与 GDD 验收标准合并；②GDD 纯度判红——系统与概念文档全文禁写实现细节（代码路径／测试文件名／断言名），唯一例外＝配置文件索引（`game/data/tables/*.tres` 表路径与表名）；③能力清单维护归写卡段——写需求卡片时增删能力行并刷新「最后验证批次」，实现批禁写该文件（清单按规则滞后一个迭代，属设计后果）。三层模型（验收意图／覆盖索引／执行证据）与四法则落 test-conventions §8.9；落地分五批：①三份规约＋AGENTS.md 红线＋本条实况（本批）；②README 覆盖域表＋三域能力行补齐；③`tools/capability_audit.py` 文档域新闸（3a 普通工具入库／3b 接闸＋基线，worktree）；④pipeline_gate 对照表加「能力行」列＋req-card／iter 两技能同步；⑤GDD 存量实现细节清理（28 篇约 98 处，逐处去向表过用户目后落笔）。 +**实况**：用户裁「验证及清单不合理」，经调研定四方向全做、分阶段推进：A 粒度整改（清单从断言级升到能力/行为级，逐断言账本退役）→ B 精简裁断（在新粒度上规则驱动删并）→ C 流程风险分级（P0/P1/P2 验收强度、审计抽样）→ D 文档减肥（待办条目限长、历史归 git）；测试有效性度量暂不处理。阶段 0 盘点已毕：验证集清单零机器闸依赖（run_all_gates／hooks／五技能均不引用，仅 test-conventions §8.3 维护锚＋2 份过程报告引用），退役无闸改动；但测试名尾缀仅覆盖 28/47 个有断言文件（19 个零尾缀，含 seal_polarity 69 条、variant_placement 42 条、roll_multiplier 35 条），故能力清单只能按「能力→代表用例」建，不要求逐断言尾缀。对照表列改动触 pipeline_gate＋req-card／iter 两技能；待办正文压缩不触机检（无长度判据）。盘点明细见 reports/盘点-验证与清单体系-2026-10-28.md。**阶段 1 设计已闭合（2026-10-28 用户四裁点）**：能力清单 v1 落 `game/tests/README.md`——按系统归属与玩家旅程排序，首期核心四域（存档与随机、冒险循环、战斗结算、奖励与经济）29 行＋跨域条件闸 1 行，共 30 行，每行真实入口＋2–3 个代表用例（`文件:函数`），维护规则为每批收口核对本批受影响行并刷新「最后验证批次」；`design/engineering/test-conventions.md` §8.3 维护锚改写为「验证集清单整册冻结、能力清单承接覆盖索引、阶段 2 精简后删除」；`game/tests/验证集清单.md` 头注同步冻结声明，冻结快照（基点 `b9260138`／1587 条）留作阶段 2 对账基准；`tools/extract_checks.py` 保留为审计工具，不再承担常态同步。**阶段 2 已执行闭合（2026-10-28 C 档合回）**：存量断言精简 C 档 6 组手写断言族并为 7 个表驱动站点（33→7），冻结清单对账 1587→1561，验证集清单随阶段 2 完成退役（覆盖索引归能力清单，维护锚 test-conventions §8.3），删并申报与件核见 reports/工程改动报告-存量断言精简C档-2026-10-28.md；阶段 3–4 待各自设计推进：风险分级与审计抽样规则、条目限长是否入 pipeline_gate 均未定。**2026-10-29 阶段 1 落地定稿（用户三裁）**：①能力清单与覆盖域表落 `game/tests/README.md`，独立成表、不与 GDD 验收标准合并；②GDD 纯度判红——系统与概念文档全文禁写实现细节（代码路径／测试文件名／断言名），唯一例外＝配置文件索引（`game/data/tables/*.tres` 表路径与表名）；③能力清单维护归写卡段——写需求卡片时增删能力行并刷新「最后验证批次」，实现批禁写该文件（清单按规则滞后一个迭代，属设计后果）。三层模型（验收意图／覆盖索引／执行证据）与四法则落 test-conventions §8.9；落地分五批：①三份规约＋AGENTS.md 红线＋本条实况（本批）；②README 覆盖域表＋三域能力行补齐；③`tools/capability_audit.py` 文档域新闸（3a 普通工具入库／3b 接闸＋基线，worktree）；④pipeline_gate 对照表加「能力行」列＋req-card／iter 两技能同步；⑤GDD 存量实现细节清理（28 篇约 98 处，逐处去向表过用户目后落笔）。**2026-10-29 阶段 1 五批全部落地**：①032d923c；②5377b2ce；③`tools/capability_audit.py` 入库 ae3c99e3＋接闸上电 915222fa（文档域闸 08e 能力审计，纯度红清零后才上电）；④f3263444；⑤GDD 清理 00312e12（30 篇去 124 处实现指证，纯度红 124→0）。阶段 1 收口；阶段 3–4 待各自设计推进。 **改动面**：文档＋游戏代码＋工具代码 @@ -44,7 +44,7 @@ #### 迭代 41 测试债修复——9 个套件失败与静态扫描三项红（2026-10-29 登记，来源=批次移交） -**实况**：证据＝能力审计上电批（worktree 分支 `capgate-20261029`，提交 48e6e551）全量闸复跑，首次实测迭代 41 两卡合回（合并提交 eb9bb537，测试特许移交＋直接合回，见 roadmap 收口注脚）后的代码面真实状态：①02 单元与集成测试 9 套件失败——`config_db_test`（`if` 块内声明的变量在块外引用，解析错误）、`config_db_fatal_oob_test`（退出码 2≠期望 1）、`table_structure_guard_test`（`_TreeSaveMock` 缺 `meta_state`）、`treasure_items_test`（`StubDB` 缺 `crossrun`）、`standee_fx_sweep_test`（`set_trans` 空引用）、`forge_workbench_test`（120 秒超时挂死）、`tree_requires_level_test`（`row_by_id` 在空基址）、`save_manager_domain_test`（缺 `_migrate_legacy_save`）、`theme_projection_test`（`CampOverlay` 缺 `_recent_list`）；②09 静态扫描红项清单与基线不一致——S9 类型闸 24 处（迭代 41 拆出的新件缺 `# type-hint: ignore` 注解与参数类型）、S10 文件头 4 处（`config_db` 与三个域容器头注日期）、S11 注释禁用词 1 处（`adventure_table.gd:55`），而 gdstyle 与 S13 已随迭代 41 还清（基线两条存量红已过期，须随修复实测重生成）。本条目只修测试与注解债、不改游戏行为。 +**实况**：证据＝能力审计上电批（worktree 分支 `capgate-20261029`，提交 48e6e551）全量闸复跑，首次实测迭代 41 两卡合回（合并提交 eb9bb537，测试特许移交＋直接合回，见 roadmap 收口注脚）后的代码面真实状态：①02 单元与集成测试 9 套件失败——`config_db_test`（`if` 块内声明的变量在块外引用，解析错误）、`config_db_fatal_oob_test`（退出码 2≠期望 1）、`table_structure_guard_test`（`_TreeSaveMock` 缺 `meta_state`）、`treasure_items_test`（`StubDB` 缺 `crossrun`）、`standee_fx_sweep_test`（`set_trans` 空引用）、`forge_workbench_test`（120 秒超时挂死）、`tree_requires_level_test`（`row_by_id` 在空基址）、`save_manager_domain_test`（缺 `_migrate_legacy_save`）、`theme_projection_test`（`CampOverlay` 缺 `_recent_list`）；②09 静态扫描红项清单与基线不一致——S9 类型闸 24 处（迭代 41 拆出的新件缺 `# type-hint: ignore` 注解与参数类型）、S10 文件头 4 处（`config_db` 与三个域容器头注日期）、S11 注释禁用词 1 处（`adventure_table.gd:55`），而 gdstyle 与 S13 已随迭代 41 还清（基线两条存量红已过期，须随修复实测重生成）。本条目只修测试与注解债、不改游戏行为。本批合入经用户 2026-10-29 裁带红合并：能力审计上电批只动闸件与规约（代码域零新增红），代码域现存红全部由本条目承接。 **改动面**：游戏代码