From d3a616cf9e93237f6ca03d0e2f40485d1d1786ce Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sat, 17 Oct 2026 00:56:58 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E5=8F=A3=E5=BE=84):=20roadmap=20=E4=B8=8E?= =?UTF-8?q?=20tests/README=20=E7=9A=84=E9=97=B8=E5=8F=A3=E5=BE=84=E9=9A=8F?= =?UTF-8?q?=E5=88=86=E5=9F=9F=E6=94=B9=E9=80=A0=E5=90=8C=E6=AD=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 漏改即成第二份互相矛盾的清单（本批正是要消灭这种漂移）： - roadmap.md 迭代循环骨架第 5 步「重闸＝全量档全绿」→ 按改动域选档；第 8 步收口五步③ 「里程碑移动更新本文件」加注：实现批禁写 roadmap，该步归文档批，实现批在 reports/ 反哺点 列明该改哪一行。 - game/tests/README.md 门禁行与「本地闸」节的「（全量）唯一入口」→ 按域选档 + 回执含 domain + 合回闸按 diff 推域校验。 连带（仓库外本地配置，同批已改）：~/.zcode/skills/req-card/SKILL.md 六处——description 版本注、 §5 关联文档同步面（实现批禁写 design/、产出只落 reports/、07 入册转反哺点）、§6 末卡改「产出物 落位卡」、§7 闸口径改按域并禁卡内写死闸件名单、目检两分法落点、变异验证记录表落点。 --- game/tests/README.md | 8 ++++---- roadmap.md | 4 ++-- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/game/tests/README.md b/game/tests/README.md index 8e63de73..322629b6 100644 --- a/game/tests/README.md +++ b/game/tests/README.md @@ -2,7 +2,7 @@ **Engine**: Godot 4.7.2-stable（GDScript 单语言） **Test Framework**: 双载体——`--headless --script` 单元套件 + headless 场景探针；gdUnit4 **deferred**（D2 OQ1 关闭形态——本仓库不引第三方测试框架，需求见下「门禁」节） -**门禁**: 本地闸——`tools/run_all_gates.sh`（全量，收口唯一验收入口）/`--quick`（中段自检）。本仓库**无远端、无 CI**（`.github/workflows/` 已删除，不建不留不参考）；闸清单只在本脚本定义，文档不另列 +**门禁**: 本地闸——`tools/run_all_gates.sh`（收口唯一验收入口，按改动域选档 `--code`／`--docs`，跨两域或改闸件本身不带参数＝全量；`--quick` 为中段自检）。本仓库**无远端、无 CI**（`.github/workflows/` 已删除，不建不留不参考）；闸清单与域划分只在本脚本定义，文档不另列 **Setup date**: 2026-09-12（2026-09-27 `7f24b640` 三层收敛：根 tests/ 并入 `game/tests/`、docs 并入 `design/dev/`、production 解散） **参考实现**: `game/smoke/`（冒烟断言 + 场景探针族——正式工程的活样板；断言计数双口径见下节） @@ -114,9 +114,9 @@ timeout 120s godot --headless --script tests/run_all.gd ## 本地闸（唯一验收门禁） -本仓库无远端、无 CI——**验收只在本地发生**，跑 `tools/run_all_gates.sh`（全量）是收口唯一入口， -跑完写回执 `game/tests/.gates/receipt.json`，合回 master 由 worktree-guard 校验回执。 -闸清单的唯一定义处就是那个脚本，本文档不另列清单（清单散落多份文档正是历史漏跑闸的成因）。 +本仓库无远端、无 CI——**验收只在本地发生**，跑 `tools/run_all_gates.sh` 是收口唯一入口，按本批改动域选档（`--code`／`--docs`／跨两域或改闸件本身＝不带参数全量）， +跑完写回执 `game/tests/.gates/receipt.json`（含 `domain` 字段），合回 master 由 worktree-guard 按 diff 推域校验回执。 +闸清单与域划分的唯一定义处就是那个脚本，本文档不另列清单（清单散落多份文档正是历史漏跑闸的成因）。 **判定三硬闸**（各闸一律适用，缺一即判定有洞）： ①**退出码为唯一权威判据**——日志里的 PASS 串只是日志，不作判据； diff --git a/roadmap.md b/roadmap.md index 2a6d0c84..dd5ce8cd 100644 --- a/roadmap.md +++ b/roadmap.md @@ -105,10 +105,10 @@ 2. **T0 开工**：建 worktree + 基线复读记档（冒烟/探针/三闸/MC 对拍基准）+ `git status` 归属核对（并行遗留只标旗不碰）。 3. **循环骨架**：一轮 = 一个任务卡——读卡 → 对事实源 → 实装 → 轻闸全绿 → 提交（代拍板随 commit 记录）→ 状态记录追加（查撞号）→ 下一轮。单 worktree 多点提交一次合并；轮内禁开第二个 worktree；基线每轮开工时点重测；断点续跑 = `git log` 对任务卡定轮次 + 重跑当轮轻闸。 4. **轻闸**（每轮必跑，headless）：`tools/run_all_gates.sh --quick`（迭代中段自检档）。 -5. **重闸**（批末 Tn）：`tools/run_all_gates.sh` 全量档全绿——闸件清单与顺序只在该脚本里定义，本文件与 CLAUDE.md/规约均不另列；MC 逐位对拍（涉核心）+ 素材批加机检断言另行。 +5. **重闸**（批末 Tn）：`tools/run_all_gates.sh` **按本批改动域跑**（只碰 `game/`、`tools/`、`artwork/` → `--code`；只碰 `design/` 与根规则文件 → `--docs`；跨两域或改闸件本身 → 不带参数全量），所选域全绿——闸件清单、顺序与域划分只在该脚本里定义，本文件与 CLAUDE.md/规约均不另列；MC 逐位对拍（涉核心）+ 素材批加机检断言另行。 6. **人闸**（停机交付）：真人目检清单 + 代拍板追认清单 + 异步终审触点（样张类）——本循环内唯一必经人审。 7. **异常分级**：L1 自救（一次重试）→ L2 记录继续（连续 3 次同红灯升级）→ L3 停机写报告等用户。 -8. **收口五步**：①active.md 快照 ②状态记录条目 ③里程碑移动更新本文件 ④阶段变更改 stage.txt ⑤批末闸序列全绿留痕（loop_dashboard 已随目录收敛退役，透视职责由 06+状态记录承接）。 +8. **收口五步**：①active.md 快照 ②状态记录条目 ③里程碑移动更新本文件——**实现批禁写本文件**（2026-10-17 用户裁：代码实现批只准写 `reports/`），该步归文档批做，实现批在 `reports/iter-反哺点-<日期>.md` 列明该改哪一行 ④阶段变更改 stage.txt ⑤批末闸序列**按本批改动域**全绿留痕（loop_dashboard 已随目录收敛退役，透视职责由 06+状态记录承接）。 ## 维护纪律