From f230bde1c373c932738e5e084aaeb7a245260bc9 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Tue, 20 Oct 2026 20:02:20 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E5=8D=A1=E2=91=A0=E5=A4=B1=E6=95=88?= =?UTF-8?q?=E9=81=BF=E8=AE=A9=E9=99=88=E8=BF=B0=E6=B8=85=E8=B4=A6):=2006?= =?UTF-8?q?=20=E5=BD=92=E5=B1=9E=E6=AE=B5=E4=B8=8E=E5=8D=A1=E7=89=87?= =?UTF-8?q?=E4=B8=89=E5=A4=84=EF=BC=88=E5=A5=91=E7=BA=A6=2010=EF=BC=8F?= =?UTF-8?q?=E4=B8=8D=E5=81=9A=E8=A1=A8=E8=A1=8C=EF=BC=8F=E5=81=9C=E6=9C=BA?= =?UTF-8?q?=E6=9D=A1=E4=BB=B6=205=EF=BC=89=E5=88=A0=E5=8E=BB=E3=80=8Cchang?= =?UTF-8?q?elog-retire-20261019=20=E5=9C=A8=E7=9B=98=E6=9C=AA=E5=90=88?= =?UTF-8?q?=E5=9B=9E=E3=80=8D=E9=81=BF=E8=AE=A9=E5=89=8D=E6=8F=90=EF=BC=88?= =?UTF-8?q?=E8=AF=A5=E6=89=B9=E5=B7=B2=E4=BA=8E=20c5200b6b=20=E5=85=A5=20m?= =?UTF-8?q?aster=EF=BC=8C=E5=89=8D=E6=8F=90=E5=A4=B1=E6=95=88=EF=BC=89?= =?UTF-8?q?=EF=BC=8C=E7=BA=A6=E6=9D=9F=E6=9C=AC=E4=BD=93=E4=BF=9D=E7=95=99?= =?UTF-8?q?=E5=B9=B6=E6=94=B9=E6=8C=82=E6=B5=81=E6=B0=B4=E7=BA=BF=E7=BA=A2?= =?UTF-8?q?=E7=BA=BF=E4=BE=9D=E6=8D=AE=EF=BC=88=E8=BF=AD=E4=BB=A3=E6=89=B9?= =?UTF-8?q?=E7=A6=81=E5=86=99=20design/=20=E4=B8=8E=E6=A0=B9=E8=A7=84?= =?UTF-8?q?=E5=88=99=E6=96=87=E4=BB=B6=EF=BC=89=EF=BC=9B=E9=A1=BA=E5=B8=A6?= =?UTF-8?q?=E6=8A=8A=E6=97=A7=E7=9B=AE=E5=BD=95=20design/dev/=20=E4=B8=89?= =?UTF-8?q?=E5=A4=84=E5=86=99=E6=B3=95=E6=94=B9=E4=B8=BA=20design/engineer?= =?UTF-8?q?ing/?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/06-待办清单.md | 2 +- reports/需求卡片-代码注释禁用词清扫批-2026-10-20.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index d2201e80..3e17ea2d 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -685,7 +685,7 @@ **不做（待用户另裁）**：术语表 A 表词一族、doc-conventions 第 4 节流程动词一族、简明技术中文（STC）通用禁用词一族——三族的逐词计数与清单见卡片 §4「不做」表（本行不复制词面：06 正文引述禁词会自指引爆 doc_term 补充通道，判红）。 -**归属**：game/ 代码与数据表（代码域，走独立 worktree 批；并行避让——`changelog-retire-20261019` 在盘未合回且正在改 `AGENTS.md` 与 `design/engineering/code-conventions.md`，本批禁碰这两个文件，S11 规则说明自持于 `game/tests/static_scan.sh` 头注与 `game/tests/README.md`） +**归属**：game/ 代码与数据表（代码域，走独立 worktree 批；`AGENTS.md` 与 `design/` 依流水线红线本批禁碰，S11 规则说明自持于 `game/tests/static_scan.sh` 头注与 `game/tests/README.md`） **状态**：已写卡（reports/需求卡片-代码注释禁用词清扫批-2026-10-20.md，**v1.3**）＋已编迭代 32 diff --git a/reports/需求卡片-代码注释禁用词清扫批-2026-10-20.md b/reports/需求卡片-代码注释禁用词清扫批-2026-10-20.md index 483b9b68..0795f2b9 100644 --- a/reports/需求卡片-代码注释禁用词清扫批-2026-10-20.md +++ b/reports/需求卡片-代码注释禁用词清扫批-2026-10-20.md @@ -163,7 +163,7 @@ **明确不收**：①术语表「用语规范」A 表词面（`不得`／`报错`／`对标`／`若干`／`buff` 等）——§4 已列「不做」，收进来批末必然红；②单字「雷」——会误伤 64 处 / 26 个文件的保留词「排雷玩法／排雷规则」（内部机制名，§10 明定不扩大禁词面）。**禁止在脚本里另抄一份词表**（单一事实源红线，ADR 漂移教训同类）。A 表词／巢穴／旗将来若被裁决纳入，另行扩词表并单独立批清扫。 8. 🔴 **S11 必须带两道零命中自检**——①扫描面文件数为零即判红；②从术语表解析出的词面数为零即判红（沿 S3 教训：路径写歪或表格结构变了时，自检一起歪、一起红，不会静默恒绿）。 9. 🔴 **S11 闸门自指豁免**——命中行若属「检查禁用词本身」的闸门形态（行内含 `contains(`／`find(`／`grep`／`has_char(`／`禁「`／`禁『`/`零「`/`零『` 等检查或禁令表述），或含 `doc_term_audit.py` 同源的对照/历史信号，一律豁免、不判红。现存受此豁免的 5 处：`game/smoke/smoke_all.gd:1319`（禁字面检查逻辑）／`:1321`（零「雷/旗」断言描述）、`game/tests/unit/presentation/ui_font_asset_test.gd:18`／`:19`（字形覆盖夹具）、`game/data/tables/feats.tres:10`（desc 禁令引举）。**S11 规则说明自身与登记行一律用禁令引举句式**（如「禁「板级」「门票」……」）——既落 B2 对照性文本豁免，又天然触发本条自指豁免（否则闸本体的头注会被自己判红）。 -10. 🔴 **禁碰并行会话在改的文件**——`AGENTS.md` 与 `design/dev/code-conventions.md`（分支 `changelog-retire-20261019` 在盘未合回）。S11 规则说明自持于 `game/tests/static_scan.sh` 头注与 `game/tests/README.md`。 +10. 🔴 **本批禁碰这两个文件**——`AGENTS.md`（根规则文件）与 `design/engineering/code-conventions.md`（在 `design/` 目录内）：依据＝迭代批禁写 `design/` 与根规则文件这条流水线红线（process-conventions §2），本批无例外。S11 规则说明自持于 `game/tests/static_scan.sh` 头注与 `game/tests/README.md`。 11. 🔴 **对照性文本豁免**——含退役/更名/禁令等信号的行不改写（术语表用语规范 B 类豁免条款）；本批的 B 类落点已全部显式枚举进 §2 豁免单，不再用行内子串现场判定。 12. 🔴 **parity 闸本批不发起、漂移记档、合回后另立重锚批**——N7 的 `_emit_row` 后移＋`hl` 两态化会互换 `seal_miss`／`insurance_used` 两行的日志顺序并改写豁免态 `highlight`（`playtest_logger._on_step_row` 逐行落盘、七公共字段含 `highlight`），而 11 号闸对 JSONL 按 sha256 逐位比对——批准实跑必红，且闸令明载「不得借机重锚」。故本批 **不发起 parity**（回执落 NEED-APPROVAL：该态指纹记 skip、入 not_run，`all_green` 不受影响）；预期漂移（豁免态／未豁免态各一例）写进实现报告「已记档差异」节；合回后另立**用户批准**的 parity 重锚批并登记 06，不得借任何批「顺手」重锚。N7 的行为正确性验收走 A10／A11／A12 正向断言（测试三层分工纪律①主力）。 @@ -190,7 +190,7 @@ | `design/` 全部文档（术语表／战斗结算／地图战斗资源／难度曲线与Boss／art-bible／ux 各件／07 清单） | **反哺点**——落 `reports/iter32-反哺点-<日期>.md`，由用户在会话裁决后归文档轨批（迭代批禁写 `design/`） | | `门票` 标识符与数据键（`feat_ticket_*`／`SHELF_KINDS`／存档键） | 上游卡 §4 明列不碰；若将来要改，另立独立批并连带处理存档兼容 | | `shop.tres:86`「奇物门票」与 `curio_interact_controller.gd:165-166` 玩家文案 | 属 奇物／专长 归类表述，与 06「冒记案遗留待裁两项」第①项同源 → 交文档侧定性后另走传导批 | -| `AGENTS.md`／`design/dev/code-conventions.md` | 并行会话 `changelog-retire-20261019` 在盘未合回，本批禁碰 | +| `AGENTS.md`／`design/engineering/code-conventions.md` | 本批禁碰——迭代批禁写 `design/` 与根规则文件（流水线既有红线，见契约 10） | | 术语表 A 表词（不得 14／报错 18／对标 1／若干 1／buff 22） | 待用户另裁；裁入则新立 06 条目与卡片 | | 「巢穴（机制表述）」换代与单字「旗」清理 | S11 显式排除单已收理由（巢穴＝玩家专名 B3＋风味层除外注；旗＝doc_term_audit 既有判例＋6 处全豁免）；两项清理均需用户裁后另立批（06 登记） | | doc-conventions 第 4 节流程动词（收口 128／随批 20／台账 17／对拍 16／在飞 10／落文 2） | 同上 | @@ -396,7 +396,7 @@ 2. `.tres` 加载失败或 schema 不同步； 3. 改前改后同种子读数不一致； 4. S11 注入后不变红（判据无效）； - 5. 触碰并行会话在改文件（`AGENTS.md`／`design/dev/code-conventions.md`）； + 5. 触碰 `AGENTS.md` 或 `design/` 目录下任何文件（迭代批越界——流水线红线）； 6. **N7 后移 `_emit_row` 后，奖励兑付结果与改前不一致**（说明改到了兑付行为，而非只改文案判据）。 ---