From 79edb63bc0a2e457c3dee74a85d706c27e6f88ba Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 26 Oct 2026 02:38:22 +0800 Subject: [PATCH 1/3] =?UTF-8?q?docs(=E7=99=BB=E8=AE=B0):=20code/test=20?= =?UTF-8?q?=E8=A7=84=E7=BA=A6=E6=96=87=E9=A6=96=E8=AF=BB=E8=A7=A6=E5=8F=91?= =?UTF-8?q?=E5=89=8D=E7=A7=BB=E6=9D=A1=E7=9B=AE=EF=BC=88=E5=BE=85=E6=89=A7?= =?UTF-8?q?=E8=A1=8C=EF=BC=89=E2=80=94=E2=80=94=E4=B8=8E=E5=AF=BC=E8=88=AA?= =?UTF-8?q?=E8=A1=8C=E5=8F=A3=E5=BE=84=E5=AF=B9=E9=BD=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 待办清单.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/待办清单.md b/待办清单.md index 1ef6728f..11a18bc8 100644 --- a/待办清单.md +++ b/待办清单.md @@ -2,6 +2,15 @@ 本清单是流水线的唯一登记处：要做的事先在此登记一条，随流水线段推进改状态，做完整条删除；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据含可选优先级，正文＝实况/缺口/改动面/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。 +#### code/test 规约文首读触发前移——与导航行口径对齐（2026-10-25 登记，来源=会话提及） + +**实况**：证据＝2026-10-25 触发时机排查（承接导航前移批 d121d653 与 concept-conventions 批 79d8ee95）：code-conventions.md 文首「写任何代码前必须通读本文件」与 test-conventions.md 文首「写任何测试前必须通读本文」仍是旧触发词，与 AGENTS.md 导航行已前移的「定代码方案／定测试方案」口径不一；测试侧实际时点更早（验收断言在写卡期设计）。用户裁：两处一起改；process-conventions 经呈报维持不改（细则主体为开工期内容，开工前知识在红线摘要常驻注入）。 +- 相关文档 design/engineering/code-conventions.md 文首；design/engineering/test-conventions.md 文首；AGENTS.md「规范导航」 + +**改动面**：文档 + +**状态**：待执行 + #### AdventureRunner 职责真拆分——三宿主共 25 条转发属性属 S13 计数迎合装置，须按变化原因重立协作件（2026-10-25 登记，来源=批次移交，优先级＝P0） **实况**： From ab79a71eb72daeae14dc2c8e039345d386b04539 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 26 Oct 2026 02:38:22 +0800 Subject: [PATCH 2/3] =?UTF-8?q?docs(=E8=A7=84=E5=88=99=E4=BF=AE=E8=AE=A2):?= =?UTF-8?q?=20code-conventions/test-conventions=20=E6=96=87=E9=A6=96?= =?UTF-8?q?=E8=AF=BB=E8=A7=A6=E5=8F=91=E5=89=8D=E7=A7=BB=E2=80=94=E2=80=94?= =?UTF-8?q?=E3=80=8C=E5=86=99=E4=BB=BB=E4=BD=95=E4=BB=A3=E7=A0=81=E5=89=8D?= =?UTF-8?q?=E5=BF=85=E9=A1=BB=E9=80=9A=E8=AF=BB=E6=9C=AC=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E3=80=8D=E6=94=B9=E3=80=8C=E5=AE=9A=E4=BB=A3=E7=A0=81=E6=96=B9?= =?UTF-8?q?=E6=A1=88=E5=89=8D=E5=BF=85=E9=A1=BB=E9=80=9A=E8=AF=BB=E6=9C=AC?= =?UTF-8?q?=E6=96=87=E4=BB=B6=E3=80=8D=E3=80=81=E3=80=8C=E5=86=99=E4=BB=BB?= =?UTF-8?q?=E4=BD=95=E6=B5=8B=E8=AF=95=E5=89=8D=E5=BF=85=E9=A1=BB=E9=80=9A?= =?UTF-8?q?=E8=AF=BB=E6=9C=AC=E6=96=87=E3=80=8D=E6=94=B9=E3=80=8C=E5=AE=9A?= =?UTF-8?q?=E6=B5=8B=E8=AF=95=E6=96=B9=E6=A1=88=E5=89=8D=E5=BF=85=E9=A1=BB?= =?UTF-8?q?=E9=80=9A=E8=AF=BB=E6=9C=AC=E6=96=87=E3=80=8D=EF=BC=882026-10-2?= =?UTF-8?q?5=20=E7=94=A8=E6=88=B7=E8=A3=81=E4=B8=A4=E5=A4=84=E4=B8=80?= =?UTF-8?q?=E8=B5=B7=E6=94=B9=EF=BC=9B=E4=B8=8E=20d121d653=20=E5=AF=BC?= =?UTF-8?q?=E8=88=AA=E8=A1=8C=E5=89=8D=E7=A7=BB=E5=8F=A3=E5=BE=84=E5=AF=B9?= =?UTF-8?q?=E9=BD=90=EF=BC=8C=E6=B5=8B=E8=AF=95=E4=BE=A7=E5=AE=9E=E9=99=85?= =?UTF-8?q?=E6=97=B6=E7=82=B9=E6=9B=B4=E6=97=A9=E2=80=94=E2=80=94=E9=AA=8C?= =?UTF-8?q?=E6=94=B6=E6=96=AD=E8=A8=80=E5=9C=A8=E5=86=99=E5=8D=A1=E6=9C=9F?= =?UTF-8?q?=E8=AE=BE=E8=AE=A1=EF=BC=9Bprocess-conventions=20=E7=BB=8F?= =?UTF-8?q?=E5=91=88=E6=8A=A5=E7=BB=B4=E6=8C=81=E4=B8=8D=E6=94=B9=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/engineering/code-conventions.md | 2 +- design/engineering/test-conventions.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/design/engineering/code-conventions.md b/design/engineering/code-conventions.md index b23d020a..9d422761 100644 --- a/design/engineering/code-conventions.md +++ b/design/engineering/code-conventions.md @@ -3,7 +3,7 @@ > 约束范围：`game/` 代码同尺度；与 AGENTS.md「硬性红线」节硬约束（数值表单点 / RNG 封闭流 / Core 零 UI / fail-fast / spec-AC 一致性）并行生效，冲突以用户裁决为准。 > 分工：本文管结构 / 契约 / 语言 / 数值 / 流程五类；测试的编写与验收见 `design/engineering/test-conventions.md`；真实反例库见同目录 `code-conventions-cases.md`（不常驻加载，对规则适用有疑义时查）。 -**写任何代码前必须通读本文件。** +**定代码方案前必须通读本文件。** --- diff --git a/design/engineering/test-conventions.md b/design/engineering/test-conventions.md index 6bcfdda3..dbc955f7 100644 --- a/design/engineering/test-conventions.md +++ b/design/engineering/test-conventions.md @@ -4,7 +4,7 @@ > 分工：测试**执行许可**（什么时候允许跑测试）归 AGENTS.md「硬性红线·测试执行两入口铁规」；**跑什么闸、什么顺序**归 `tools/run_all_gates.sh`（脚本即清单，本文与 AGENTS.md 均不另列）；本文管测试怎么写、怎么算合格。每件测试工具**是什么、判什么、怎么单独跑、什么时候适合单独用**——见 `game/tests/README.md`（测试工具手册），本文不重复工具介绍。 > 归属：随游戏逻辑写/改的测试＝需求改动的一部分（随需求卡片同批落地）；不伴随逻辑改动的纯测试维护＝工程改动（不写卡，用户发令直改）。 -**写任何测试前必须通读本文。** +**定测试方案前必须通读本文。** --- From 6309b829b1be4433d9238a7eed901049f7b1fe5f Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 26 Oct 2026 02:38:53 +0800 Subject: [PATCH 3/3] =?UTF-8?q?docs(=E5=87=BA=E8=B4=A6):=20code/test=20?= =?UTF-8?q?=E8=A7=84=E7=BA=A6=E6=96=87=E9=A6=96=E8=AF=BB=E8=A7=A6=E5=8F=91?= =?UTF-8?q?=E5=89=8D=E7=A7=BB=E6=9D=A1=E7=9B=AE=E5=AE=8C=E6=88=90=E5=8D=B3?= =?UTF-8?q?=E5=88=A0=E2=80=94=E2=80=94=E6=94=B9=E5=8A=A8=E5=B7=B2=E9=9A=8F?= =?UTF-8?q?=E6=9C=AC=E6=89=B9=E8=90=BD=E6=96=87=EF=BC=88ab79a71e=EF=BC=89?= =?UTF-8?q?=EF=BC=8C--docs=20=E5=9F=9F=E9=97=B8=E5=85=A8=E7=BB=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 待办清单.md | 9 --------- 1 file changed, 9 deletions(-) diff --git a/待办清单.md b/待办清单.md index 11a18bc8..1ef6728f 100644 --- a/待办清单.md +++ b/待办清单.md @@ -2,15 +2,6 @@ 本清单是流水线的唯一登记处：要做的事先在此登记一条，随流水线段推进改状态，做完整条删除；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据含可选优先级，正文＝实况/缺口/改动面/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。 -#### code/test 规约文首读触发前移——与导航行口径对齐（2026-10-25 登记，来源=会话提及） - -**实况**：证据＝2026-10-25 触发时机排查（承接导航前移批 d121d653 与 concept-conventions 批 79d8ee95）：code-conventions.md 文首「写任何代码前必须通读本文件」与 test-conventions.md 文首「写任何测试前必须通读本文」仍是旧触发词，与 AGENTS.md 导航行已前移的「定代码方案／定测试方案」口径不一；测试侧实际时点更早（验收断言在写卡期设计）。用户裁：两处一起改；process-conventions 经呈报维持不改（细则主体为开工期内容，开工前知识在红线摘要常驻注入）。 -- 相关文档 design/engineering/code-conventions.md 文首；design/engineering/test-conventions.md 文首；AGENTS.md「规范导航」 - -**改动面**：文档 - -**状态**：待执行 - #### AdventureRunner 职责真拆分——三宿主共 25 条转发属性属 S13 计数迎合装置，须按变化原因重立协作件（2026-10-25 登记，来源=批次移交，优先级＝P0） **实况**：