From 3f74b315911a252db57da708fafa20a31c1081bb Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Thu, 8 Oct 2026 17:43:23 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D:=20=E5=8D=A1=E2=91=A0T5?= =?UTF-8?q?=E2=80=94=E2=80=94CLAUDE.md=20=E5=88=86=E7=BA=A7=E5=91=A8?= =?UTF-8?q?=E6=9C=9F=E5=8F=A3=E5=BE=84=E9=87=8D=E9=97=B8=E5=AE=9A=E4=B9=89?= =?UTF-8?q?=E6=AD=A3=E5=BC=8F=E6=89=A9=E5=AE=B9=EF=BC=88=E4=BB=BB=E5=8A=A1?= =?UTF-8?q?=E4=B9=A6=20Q1=20=E8=A3=81=E5=86=B3=E2=80=94=E2=80=94=E4=B8=8D?= =?UTF-8?q?=E5=86=99=E5=85=A5=E8=A7=84=E8=8C=83=3D=E6=96=B0=E9=97=B8?= =?UTF-8?q?=E7=BB=A7=E7=BB=AD=E6=B8=B8=E7=A6=BB=EF=BC=89=EF=BC=9A=E8=87=AA?= =?UTF-8?q?=E6=AD=A4=E6=89=B9=E6=9C=AB=E9=87=8D=E9=97=B8=3D=E8=BD=BB?= =?UTF-8?q?=E9=97=B8+probe=5Fgate=20--click+probe=5Fgate=20--full=EF=BC=88?= =?UTF-8?q?=E5=9B=9B=E6=8E=A2=E9=92=88=EF=BC=89+render=5Fgate=EF=BC=88?= =?UTF-8?q?=E4=B8=83=E5=B1=8F=E6=A0=B7=E5=BC=A0=20A-D+fx/board=20=E5=8F=96?= =?UTF-8?q?=E8=AF=81+=E6=A3=8B=E7=9B=98=20golden=EF=BC=89+run=5Fall=20?= =?UTF-8?q?=E5=8D=95=E5=85=83=E5=85=A8=E5=A5=97+doc=20=E4=B8=89=E9=97=B8?= =?UTF-8?q?=EF=BC=88gdd=5Flint/doc=5Flink=5Faudit/doc=5Fterm=5Faudit?= =?UTF-8?q?=EF=BC=89+=E7=86=B5=E5=A2=9E=E9=97=B8=EF=BC=88repo=5Fstructure?= =?UTF-8?q?=5Faudit=EF=BC=89=EF=BC=8C=E5=91=A8=E6=9C=9F=E6=89=A7=E8=A1=8C?= =?UTF-8?q?=E4=B8=8D=E8=BF=9B=E6=AF=8F=E6=AC=A1=E5=8F=98=E6=9B=B4=EF=BC=9B?= =?UTF-8?q?=E7=9C=9F=E4=BA=BA=E5=AE=9E=E6=9C=BA=E7=9B=AE=E6=A3=80=E4=BB=8D?= =?UTF-8?q?=E5=BD=92=E7=94=A8=E6=88=B7=E4=B8=8D=E8=BF=9B=E8=87=AA=E5=8A=A8?= =?UTF-8?q?=E9=97=B8=EF=BC=8807=E2=91=AE=20=E7=9B=AE=E6=A3=80=E5=8D=8A?= =?UTF-8?q?=E4=B8=8D=E9=94=80=E5=8F=B7=EF=BC=89=EF=BC=9BMC=20=E5=A4=A7?= =?UTF-8?q?=E6=89=AB=E6=8F=8F=E4=BB=8D=E6=8C=89=20MC=20=E8=A7=A6=E5=8F=91?= =?UTF-8?q?=E7=BB=86=E5=88=99=EF=BC=88=E6=97=A0=E6=95=B0=E5=80=BC=E6=94=B9?= =?UTF-8?q?=E5=8A=A8=E9=9B=B6=E8=B7=91=EF=BC=89=E3=80=82=E8=90=BD=E7=82=B9?= =?UTF-8?q?=3DCLAUDE.md=20=E7=A1=AC=E6=80=A7=E7=BA=A2=E7=BA=BF=C2=B7?= =?UTF-8?q?=E5=88=86=E7=BA=A7=E5=91=A8=E6=9C=9F=E5=8F=A3=E5=BE=84=E5=8F=A5?= =?UTF-8?q?=EF=BC=88=E9=87=8D=E9=97=B8=E5=AE=9A=E4=B9=89=E5=9C=A8=20CLAUDE?= =?UTF-8?q?.md=20=E7=9A=84=E5=94=AF=E4=B8=80=E5=9C=A8=E5=86=8C=E5=A4=84?= =?UTF-8?q?=E2=80=94=E2=80=94=E4=BB=BB=E5=8A=A1=E4=B9=A6=E6=89=80=E7=A7=B0?= =?UTF-8?q?=20loop=20=C2=A75=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 5fae15db..f00cbd70 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -92,7 +92,7 @@ ## 硬性红线（勿违反） - **worktree 铁律**：主工作区禁止直接改动与提交（细则见上节；并行会话各占 worktree 互不踩踏） -- **测试执行两入口铁规（2026-10-02 用户立规）**：测试类执行——冒烟测试、单元测试（tests/run_all）、模拟验证（MC/verifier/调参批量工具）、场景探针等一切跑游戏的验证调用——只有两个触发入口：①**迭代 loop 开发**（冒烟挂迭代开发完成后的出口/落籍闸，loop 内过程性验证属开发工作本身）；②**用户主动点名**。除此之外（问答/调研/文档/审查/零散小改等短小会话）一律零测试，不得擅自调用任何测试；确需测试支撑结论时先请示，以静态阅读/推理作答并注明未跑测。**MC/模拟验证触发细则（2026-10-02 用户确认，2026-10-03 补落文——出处：迭代 9 出口批 81000 锚误跑质询）**：MC/verifier 仅在**数值验证场景**触发（改数值前后取证）；normal 档为主、perfect 按需；**无数值改动的会话禁跑 MC**——结构位移类「存档锚」须先向用户请示定性再跑；任务书预设步骤的前提消失时（如「带值裁定后重锚」实际未投值）停问勿照字面执行。**分级周期口径（2026-09-26 用户裁定，2026-10-03 自 06-待办清单收编）**：轻闸（run_smoke 全量+ui_input_probe；触碰 presentation 加跑 ui_click_probe+ui_layout_probe）可随变更执行；重闸（B 档视口截图像素断言〔game/smoke/shot_probe.gd〕、C 档黄金图对比〔tools/golden_compare.py〕、真人实机目检、MC 大扫描）属**周期执行**——统一在表现批收口或固定周检跑，不进每次变更 +- **测试执行两入口铁规（2026-10-02 用户立规）**：测试类执行——冒烟测试、单元测试（tests/run_all）、模拟验证（MC/verifier/调参批量工具）、场景探针等一切跑游戏的验证调用——只有两个触发入口：①**迭代 loop 开发**（冒烟挂迭代开发完成后的出口/落籍闸，loop 内过程性验证属开发工作本身）；②**用户主动点名**。除此之外（问答/调研/文档/审查/零散小改等短小会话）一律零测试，不得擅自调用任何测试；确需测试支撑结论时先请示，以静态阅读/推理作答并注明未跑测。**MC/模拟验证触发细则（2026-10-02 用户确认，2026-10-03 补落文——出处：迭代 9 出口批 81000 锚误跑质询）**：MC/verifier 仅在**数值验证场景**触发（改数值前后取证）；normal 档为主、perfect 按需；**无数值改动的会话禁跑 MC**——结构位移类「存档锚」须先向用户请示定性再跑；任务书预设步骤的前提消失时（如「带值裁定后重锚」实际未投值）停问勿照字面执行。**分级周期口径（2026-09-26 用户裁定，2026-10-03 自 06-待办清单收编；重闸定义随迭代 19 卡①任务书 Q1 裁决扩容 2026-10-08）**：轻闸（run_smoke 全量+ui_input_probe；触碰 presentation 加跑 ui_click_probe+ui_layout_probe）可随变更执行；**重闸自此批末=轻闸+probe_gate --click+probe_gate --full（ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四探针）+render_gate（窗口化渲染闸：shot_probe 七屏样张 A-D 断言+fx_shot/board_shot 取证+棋盘 golden 逐像素）+run_all 单元全套+doc 三闸（gdd_lint/doc_link_audit/doc_term_audit）+熵增闸（repo_structure_audit）**，属**周期执行**——统一在批次收口或固定周检跑，不进每次变更；真人实机目检仍归用户不进自动闸（07⑮ 目检半不销号）；MC 大扫描仍按上方 MC 触发细则（无数值改动零跑） - **MC 采集档位细则（2026-10-03 用户四档立规，承接 MC 触发细则）**：MC 局数按用途四档硬闸（表见 `sim-data/README.md`「MC 采集档位表」）：**一档·调研**=总量 >40（100+ 为常用锚量级；60/档=结构回归、100=95% CI ±9.8pp、170=±7.5pp=15pp 带半宽、400 满档=±4.9pp 贴边裁决；normal 独立满档 ~8 分钟同属一档）**只能由用户发起**——任务书/计划书/agent 均无权发起，非用户发起一律不构成一档授权；**二档·数值修改验证**=总量 ≤40、每档 ≤20（仅 ≥~40pp 结构位移可判，同种子配对下 ~30pp）；**三档·小调**=总量 ≤20、每档 ≤10（只测不判）；**四档·微量**=总量 ≤5（sanity 门，零统计判读）。四档仅承接 MC 触发细则的数值验证场景，两入口铁规不变；超档=停机呈报，禁在二/三/四档下带值结论（窗口不足如实挂起）。改前/改后锚同 seed0 配对、改前锚留盘禁补跑；对拍断言零新跑（复验用锚内子集 ≤20）；读数缺陷（零 gameplay/RNG 触碰）禁整套重跑、走事件流重构补算；≥60 局采集先 N=5 pilot 校验字段；二/三/四档会话累计 ≤20 分钟；零数值改动=零 MC - **中间产物吸收即死（2026-10-01 立规）**：中间文档（批任务书/机检报告/调研审计报告/模拟读数/迭代计划书/目检清单）寿命=迭代寿命——结论先吸收进正主文档、未决项先迁 `design/gdd/06-待办清单.md` 或 roadmap，然后文件即删，且永不提交 git；活文档=唯一事实源，git=变更记录。细则见 `design/dev/doc-conventions.md` 第 11 节 - **用语红线（2026-10-04 用户立规，黑话审计后落文）**：面向用户的一切输出——文档、工作日志（active.md）、报告、清单、对话——禁止自造黑话与代号式命名；判据 = 业内读者没读过项目历史也能一遍看懂，需要作者解释才能懂的词必须展开成完整白话句（三种固定形态、本仓反例全表与正确写法见 `design/dev/doc-conventions.md` 第 4 节）