diff --git a/AGENTS.md b/AGENTS.md index 8aec766a..9c30c4c4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,7 +12,7 @@ ## Engine Version Reference -@design/dev/engine-reference/godot/VERSION.md +@design/engineering/engine-reference/godot/VERSION.md ## 运行与验证（工作目录 = 含 project.godot 的切片目录） @@ -26,7 +26,7 @@ - `design/gdd/` — 现行设计文档树（根索引 `02-系统清单.md`，文档增删必须同步；`gdd/ux/` 战斗画面与交互规格） - `design/art/` — 美术文档（圣经/角色设计/两份清单/路径图/提示词库与生图操作单）；只放 .md 与 `references/` 参考图，审计报告与调研归 `design/research/` -- `design/dev/` — 工程规范（五份规约 + architecture + engine-reference） +- `design/engineering/` — 工程规范（五份规约 + architecture + engine-reference） - `design/research/` — 调研/提案/评估/审计报告/历史验收（中间文档唯一暂存地，入内文件到期即死）；`design/qa/` 已退役，验证截图不进 `design/`（判据见 doc-conventions §11） - `artwork/` — 在途图像素材唯一工作区（文档归文档/在途图归一处/终稿归游戏）；整目录不入 git（.gitignore 强制），收口归档 `archive/` - `game/assets/art/` — 已验收终稿（入包被游戏加载）；`game/` — 游戏工程本体（代码 + smoke/ 冒烟 + tests/ 单元集成） @@ -39,14 +39,14 @@ | 时机 | 权威文档 | |---|---| -| 批次开工 / 流程纪律 | `design/dev/process-conventions.md`——worktree 铁律、五段流水线、批次清单、测试两入口与 MC/闸机细则、像素纪律 | -| 流水线段入口 | 技能对照——doc-design=文档设计（兼任反哺点落文）／asset-ingest=美术录入／req-card=写卡／iter-plan=迭代编排／iter=实现（五者均装于项目 `.zcode/skills/`）；登记不立技能；批后收尾与中间文档退役=batch-closure（同一目录）；格式与状态机权威=`design/dev/doc-conventions.md` §12 | -| 写代码 / 改代码前 | `design/dev/code-conventions.md`——结构/契约/语言/数值/流程五类硬纪律（反例库 = 同目录 code-conventions-cases.md） | -| 写测试 / 改测试前 | `design/dev/test-conventions.md`——探针标配 / 回归断言 / 全量验证 / 验收清单落码 / 变异验证 | -| 写文档 / 改文档前 | `design/dev/doc-conventions.md`——白话写作 / 载体分工 / 用语 / 结构骨架 / 会话记录与生命周期 | -| 概念切分与互链 | `design/dev/concept-conventions.md`——概念封装 / 跨文档引用 / 归档与事实源 | +| 批次开工 / 流程纪律 | `design/engineering/process-conventions.md`——worktree 铁律、五段流水线、批次清单、测试两入口与 MC/闸机细则、像素纪律 | +| 流水线段入口 | 技能对照——doc-design=文档设计（兼任反哺点落文）／asset-ingest=美术录入／req-card=写卡／iter-plan=迭代编排／iter=实现（五者均装于项目 `.zcode/skills/`）；登记不立技能；批后收尾与中间文档退役=batch-closure（同一目录）；格式与状态机权威=`design/engineering/doc-conventions.md` §12 | +| 写代码 / 改代码前 | `design/engineering/code-conventions.md`——结构/契约/语言/数值/流程五类硬纪律（反例库 = 同目录 code-conventions-cases.md） | +| 写测试 / 改测试前 | `design/engineering/test-conventions.md`——探针标配 / 回归断言 / 全量验证 / 验收清单落码 / 变异验证 | +| 写文档 / 改文档前 | `design/engineering/doc-conventions.md`——白话写作 / 载体分工 / 用语 / 结构骨架 / 会话记录与生命周期 | +| 概念切分与互链 | `design/engineering/concept-conventions.md`——概念封装 / 跨文档引用 / 归档与事实源 | | 系统设计 / 增删文档 | `design/gdd/02-系统清单.md`——根索引 + 中文规范名↔英文代号对照 | -| 架构（唯一事实源） | `design/dev/architecture/architecture.md`——历史决策沿革查 git commit log，不另设决策文档 | +| 架构（唯一事实源） | `design/engineering/architecture/architecture.md`——历史决策沿革查 git commit log，不另设决策文档 | | 术语与已锁数值 | 规范名与定义 = `design/gdd/术语表.md`（全库唯一对照表，仅 owner 文档可修订）；现行数值 = `game/data/tables/*.tres`；规则与取值域 = 各系统 owner 文档。冲突须显式提出，禁默默改值 | | 现在做什么 / 待办与待裁 | 根 `roadmap.md` 顶部「当前位」节＋迭代总表六列 · 待办唯一登记处 `design/gdd/06-待办清单.md` · 批次过程与结论查 git 提交信息与 `reports/` | @@ -68,7 +68,7 @@ - 文件头 = `##` 文档注释，介绍本模块，≤8 行两类白名单（①职责摘要 ②使用约束；禁一切文档反向链接；code-conventions §1.4.1，规范权威 = Google pyguide §3.8 + PEP 257；机器闸 tools/audit_file_headers.py） - 数值单一事实源——玩法数值只存 `data/tables/`（.tres）经 ConfigDB 单点读取；禁数值字面量与自建 `load()` 表路径 - RNG 单点——禁 `randomize()`/自建 RandomNumberGenerator，随机只经 `RngService` 统一流 -- 架构事实唯一源——架构事实只认 `design/dev/architecture/architecture.md`；禁立第二架构文档或决策文档体系，历史决策记录只进 git commit log +- 架构事实唯一源——架构事实只认 `design/engineering/architecture/architecture.md`；禁立第二架构文档或决策文档体系，历史决策记录只进 git commit log - Core 层零 UI 依赖——完整战斗必须可 `--headless --script` 跑通；fail-fast——数据校验错误一律致命中止，无软回退 - spec-AC 一致性——规约与验收标准不得在同一输入上给出不同答案；评审隔离——`/design-review` 必须独立会话跑（与 `/design-system` 隔离） - 像素结构件——先抄后造、验收写成像素级判据、±1px 坐标推导（process-conventions 第 7 节） diff --git a/README.md b/README.md index 983b5123..c9ee03ea 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,6 @@ | 想知道 | 去看 | |---|---| | 这个游戏设计成什么样 | [design/gdd/02-系统清单.md](design/gdd/02-系统清单.md)（GDD 根索引） | -| 开发流程怎么走（五段流水线/批次纪律/验收闸） | [design/dev/process-conventions.md](design/dev/process-conventions.md)＋[AGENTS.md](AGENTS.md) 规范导航表（每段一个技能入口） | +| 开发流程怎么走（五段流水线/批次纪律/验收闸） | [design/engineering/process-conventions.md](design/engineering/process-conventions.md)＋[AGENTS.md](AGENTS.md) 规范导航表（每段一个技能入口） | | 现在做什么 | [roadmap.md](roadmap.md) 顶部「当前位」节 | | 待办与待裁 | [design/gdd/06-待办清单.md](design/gdd/06-待办清单.md) | diff --git a/design/dev/architecture/architecture.md b/design/engineering/architecture/architecture.md similarity index 98% rename from design/dev/architecture/architecture.md rename to design/engineering/architecture/architecture.md index df929af7..bf279d9c 100644 --- a/design/dev/architecture/architecture.md +++ b/design/engineering/architecture/architecture.md @@ -16,9 +16,9 @@ ## 引擎知识缺口摘要 -- **风险等级：MEDIUM**（2026-09-12 `/setup-engine refresh` 后由 HIGH 降级）。4.5→4.7 官方迁移指南已逐条核实并入 `design/dev/engine-reference/godot/breaking-changes.md` 与 `deprecated-apis.md`；**结论：无一条破坏 GDD 已锁架构契约**（autoload 体系 / .tres 单一事实源 / Callable 信号 / int64 二补数 / headless SceneTree 协议均不受影响）。 +- **风险等级：MEDIUM**（2026-09-12 `/setup-engine refresh` 后由 HIGH 降级）。4.5→4.7 官方迁移指南已逐条核实并入 `design/engineering/engine-reference/godot/breaking-changes.md` 与 `deprecated-apis.md`；**结论：无一条破坏 GDD 已锁架构契约**（autoload 体系 / .tres 单一事实源 / Callable 信号 / int64 二补数 / headless SceneTree 协议均不受影响）。 - 写码纪律不变：不确定的 API 一律查 `docs.godotengine.org/en/4.7/` 核实后再用；4.8（dev 阶段）稳定版发布后跑 `/setup-engine refresh`。 -- 三类必须入编码纪律的引擎事实（详见 `design/dev/engine-reference/godot/current-best-practices.md`）： +- 三类必须入编码纪律的引擎事实（详见 `design/engineering/engine-reference/godot/current-best-practices.md`）： 1. **GDScript 4.7 两条语义变化**：打包数组元素赋值不再触发属性 setter；类型化返回的方法覆盖必须显式 `return`。 2. **新项目默认值已变**：stretch mode `canvas_items` / aspect `expand`（4.7）；Windows 渲染驱动 D3D12（4.6，仅 Forward+ 线）——创建 project.godot 后逐项核对。 3. `Resource.duplicate(true)` 深复制不再覆盖外部子资源——D2 表资源复制语义注意。 @@ -84,7 +84,7 @@ ## 模块归属 -> 命名遵循 `design/dev/code-conventions.md`：领域命名、禁 ID 前缀（文件头注不写文档链接——「实现 GDD：xxx」一类已废止，代码↔设计追溯由 GDD 文档承担）。切片已按此规范完成领域命名批。 +> 命名遵循 `design/engineering/code-conventions.md`：领域命名、禁 ID 前缀（文件头注不写文档链接——「实现 GDD：xxx」一类已废止，代码↔设计追溯由 GDD 文档承担）。切片已按此规范完成领域命名批。 ### 基础层 diff --git a/design/dev/architecture/code-architecture.html b/design/engineering/architecture/code-architecture.html similarity index 100% rename from design/dev/architecture/code-architecture.html rename to design/engineering/architecture/code-architecture.html diff --git a/design/dev/architecture/code-architecture.json b/design/engineering/architecture/code-architecture.json similarity index 100% rename from design/dev/architecture/code-architecture.json rename to design/engineering/architecture/code-architecture.json diff --git a/design/dev/architecture/gdd-architecture.html b/design/engineering/architecture/gdd-architecture.html similarity index 100% rename from design/dev/architecture/gdd-architecture.html rename to design/engineering/architecture/gdd-architecture.html diff --git a/design/dev/architecture/gdd-architecture.json b/design/engineering/architecture/gdd-architecture.json similarity index 98% rename from design/dev/architecture/gdd-architecture.json rename to design/engineering/architecture/gdd-architecture.json index cc6af465..dabec8f7 100644 --- a/design/dev/architecture/gdd-architecture.json +++ b/design/engineering/architecture/gdd-architecture.json @@ -3,7 +3,7 @@ "diagram_type": "architecture", "meta": { "title": "Dungeon Sweeper 系统架构总图", - "output": "design/dev/architecture/gdd-architecture.html", + "output": "design/engineering/architecture/gdd-architecture.html", "quality_profile": "showcase", "locale": "zh-CN" }, diff --git a/design/dev/code-conventions-cases.md b/design/engineering/code-conventions-cases.md similarity index 100% rename from design/dev/code-conventions-cases.md rename to design/engineering/code-conventions-cases.md diff --git a/design/dev/code-conventions.md b/design/engineering/code-conventions.md similarity index 96% rename from design/dev/code-conventions.md rename to design/engineering/code-conventions.md index 7d128114..528abb7c 100644 --- a/design/dev/code-conventions.md +++ b/design/engineering/code-conventions.md @@ -1,7 +1,7 @@ # 代码规范（Dungeon Sweeper） > 约束范围：`game/` 代码同尺度；与 AGENTS.md「硬性红线」节硬约束（数值表单点 / RNG 封闭流 / Core 零 UI / fail-fast / spec-AC 一致性）并行生效，冲突以用户裁决为准。 -> 分工：本文管结构 / 契约 / 语言 / 数值 / 流程五类；测试的编写与验收见 `design/dev/test-conventions.md`；真实反例库见同目录 `code-conventions-cases.md`（不常驻加载，对规则适用有疑义时查）。 +> 分工：本文管结构 / 契约 / 语言 / 数值 / 流程五类；测试的编写与验收见 `design/engineering/test-conventions.md`；真实反例库见同目录 `code-conventions-cases.md`（不常驻加载，对规则适用有疑义时查）。 **写任何代码前必须通读本文件。** @@ -56,7 +56,7 @@ ## 3. 测试纪律 -已独立成文：`design/dev/test-conventions.md`（探针标配 / 回归断言 / 提交前全量验证 / 验收清单落码规范 / 变异验证）。 +已独立成文：`design/engineering/test-conventions.md`（探针标配 / 回归断言 / 提交前全量验证 / 验收清单落码规范 / 变异验证）。 --- diff --git a/design/dev/concept-conventions.md b/design/engineering/concept-conventions.md similarity index 98% rename from design/dev/concept-conventions.md rename to design/engineering/concept-conventions.md index 31730389..0cceadac 100644 --- a/design/dev/concept-conventions.md +++ b/design/engineering/concept-conventions.md @@ -1,6 +1,6 @@ # 概念与引用规范（Dungeon Sweeper） -> 约束范围：设计文档的概念建模与跨文档引用。写作层（句子、结构、骨架）归 `design/dev/doc-conventions.md`；本文管概念怎么切、文档怎么互链。 +> 约束范围：设计文档的概念建模与跨文档引用。写作层（句子、结构、骨架）归 `design/engineering/doc-conventions.md`；本文管概念怎么切、文档怎么互链。 > 概念只在 owner 文档里定义一次；跨系统术语的规范名、定义与互斥关系登记在 `design/gdd/术语表.md`。某概念被谁引用，靠全仓搜索它的规范名得出，不设第二处登记表。 **写设计文档前必须通读本文。** diff --git a/design/dev/doc-conventions.md b/design/engineering/doc-conventions.md similarity index 91% rename from design/dev/doc-conventions.md rename to design/engineering/doc-conventions.md index 0fd316a1..53c6d7c8 100644 --- a/design/dev/doc-conventions.md +++ b/design/engineering/doc-conventions.md @@ -1,7 +1,7 @@ # 文档写作规范（写文档前必读） -> **地位**：本文是文档写作的规范权威，与 `design/dev/code-conventions.md`（代码规范）对等；AGENTS.md 只留导航指针，细则以本文为准。 -> **适用范围**：`design/` 下一切现行文档与根目录 `roadmap.md`；概念建模与跨文档引用见 `design/dev/concept-conventions.md`。 +> **地位**：本文是文档写作的规范权威，与 `design/engineering/code-conventions.md`（代码规范）对等；AGENTS.md 只留导航指针，细则以本文为准。 +> **适用范围**：`design/` 下一切现行文档与根目录 `roadmap.md`；概念建模与跨文档引用见 `design/engineering/concept-conventions.md`。 ## 0. 总纲 @@ -61,7 +61,7 @@ | 规则 | 内容 | |---|---| | 树形文档体系 | 全部设计文档构成一棵树；文档增删必须同步根索引 `design/gdd/02-系统清单.md` | -| 架构事实唯一源 | `design/dev/architecture/architecture.md` 是架构事实的唯一权威（分层/模块归属/数据流/API 边界/测试与质量域）；禁建第二份架构文档；历史决策记录只进 git commit log | +| 架构事实唯一源 | `design/engineering/architecture/architecture.md` 是架构事实的唯一权威（分层/模块归属/数据流/API 边界/测试与质量域）；禁建第二份架构文档；历史决策记录只进 git commit log | | 一页纸节点 | 一节、一条规则 ≤一页纸（约 ≤80 行）；装不下就拆节 | | 一系统一文档 | 不建 analysis 推演件；两三句能说清的"为什么"直接写进设计目的或规则正文 | | 正文只写现行规则 | 禁删除线、"（作废）"、"（日期+拍板）"式注记；审计信息入对应文档附录 | @@ -97,7 +97,7 @@ **命名**：中文、见名知意；禁 a1_/b1_ 编号前缀；不留纯空目录。正文指代子系统一律用中文规范名；英文代号对照表见 `02-系统清单.md`，旧代号（a1–d6）仅限解读归档。 -## 7–9. 概念封装 / 引用纪律 / 归档与事实源——已独立成文 `design/dev/concept-conventions.md` +## 7–9. 概念封装 / 引用纪律 / 归档与事实源——已独立成文 `design/engineering/concept-conventions.md` ## 10. 会话状态——仓库根不设状态文件 @@ -107,7 +107,7 @@ ## 11. 文档生命周期：吸收即死 -**活文档**=唯一事实源长期维护：GDD 树、art-bible 等定稿规范、术语表、架构文档（`design/dev/architecture/architecture.md`）、本规范、06-待办清单、roadmap。**中间文档**=脚手架，寿命=迭代寿命：批需求卡片、机检/验收过程报告、调研/审计报告、模拟读数、迭代计划书、目检清单。为什么：了解游戏看 GDD，了解变更看 git；增量中间文档让版本管理失去意义，原始数据 dump 是化石不是证据。 +**活文档**=唯一事实源长期维护：GDD 树、art-bible 等定稿规范、术语表、架构文档（`design/engineering/architecture/architecture.md`）、本规范、06-待办清单、roadmap。**中间文档**=脚手架，寿命=迭代寿命：批需求卡片、机检/验收过程报告、调研/审计报告、模拟读数、迭代计划书、目检清单。为什么：了解游戏看 GDD，了解变更看 git；增量中间文档让版本管理失去意义，原始数据 dump 是化石不是证据。 | 规则 | 内容 | |---|---| @@ -123,11 +123,11 @@ | 迭代实现报告 | 实现批收口的迭代级报告（各卡状态/代拍板追认单/GDD 反哺点清单），属中间文档，**落 `reports/` 不落 `design/`**（2026-10-17 用户裁：实现批禁写 `design/`，`reports/` 是其唯一可写目录）：反哺点裁决落文吸收后按「证据只留最新」退役 | | 证据只留最新 | 测试证据只保留最新一次迭代或最新一轮同类审计版本；新证据落位后同批删上一份；待人清单过人闸后同规退役 | -**删除方式**：按 `design/dev/concept-conventions.md` 第 2 节删除概念 SOP 口径——先查引用面（grep 文件名于阻塞域），改写或删除指路句，再删文件，收尾跑死链检查全绿。执行入口=项目技能 batch-closure（批后收尾与中间文档退役）。 +**删除方式**：按 `design/engineering/concept-conventions.md` 第 2 节删除概念 SOP 口径——先查引用面（grep 文件名于阻塞域），改写或删除指路句，再删文件，收尾跑死链检查全绿。执行入口=项目技能 batch-closure（批后收尾与中间文档退役）。 ## 12. 流程文档格式 -五段流水线（登记 → 文档设计／美术设计 → 写卡 → 迭代编排 → 实现，流程纪律见 `design/dev/process-conventions.md` §2）靠流程文档运转：06-待办清单登记要做的事，roadmap 记录迭代编排结果，artwork 目录承载美术在途素材。本节是这些流程文档的格式与状态机权威，也是流水线闸（`tools/pipeline_gate.py`，自动检查 06 与 roadmap 两文件格式及互相引用的机检闸）的判据依据。 +五段流水线（登记 → 文档设计／美术设计 → 写卡 → 迭代编排 → 实现，流程纪律见 `design/engineering/process-conventions.md` §2）靠流程文档运转：06-待办清单登记要做的事，roadmap 记录迭代编排结果，artwork 目录承载美术在途素材。本节是这些流程文档的格式与状态机权威，也是流水线闸（`tools/pipeline_gate.py`，自动检查 06 与 roadmap 两文件格式及互相引用的机检闸）的判据依据。 ### 12.1 06-待办清单条目格式与状态机 diff --git a/design/dev/engine-reference/godot/VERSION.md b/design/engineering/engine-reference/godot/VERSION.md similarity index 100% rename from design/dev/engine-reference/godot/VERSION.md rename to design/engineering/engine-reference/godot/VERSION.md diff --git a/design/dev/engine-reference/godot/breaking-changes.md b/design/engineering/engine-reference/godot/breaking-changes.md similarity index 100% rename from design/dev/engine-reference/godot/breaking-changes.md rename to design/engineering/engine-reference/godot/breaking-changes.md diff --git a/design/dev/engine-reference/godot/current-best-practices.md b/design/engineering/engine-reference/godot/current-best-practices.md similarity index 100% rename from design/dev/engine-reference/godot/current-best-practices.md rename to design/engineering/engine-reference/godot/current-best-practices.md diff --git a/design/dev/engine-reference/godot/deprecated-apis.md b/design/engineering/engine-reference/godot/deprecated-apis.md similarity index 100% rename from design/dev/engine-reference/godot/deprecated-apis.md rename to design/engineering/engine-reference/godot/deprecated-apis.md diff --git a/design/dev/process-conventions.md b/design/engineering/process-conventions.md similarity index 100% rename from design/dev/process-conventions.md rename to design/engineering/process-conventions.md diff --git a/design/dev/test-conventions.md b/design/engineering/test-conventions.md similarity index 100% rename from design/dev/test-conventions.md rename to design/engineering/test-conventions.md diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index 79cf0a8f..7a94ff26 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -1,6 +1,6 @@ # 06-待办清单 -本清单是流水线的唯一登记处：要做的事先在此登记一条，随流水线段推进改状态，做完整条删除；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据，正文＝现状/缺口/归属/状态四属性）与状态机以 [doc-conventions §12.1](../dev/doc-conventions.md) 为权威。 +本清单是流水线的唯一登记处：要做的事先在此登记一条，随流水线段推进改状态，做完整条删除；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据，正文＝现状/缺口/归属/状态四属性）与状态机以 [doc-conventions §12.1](../engineering/doc-conventions.md) 为权威。 #### UI 贴图重构批——营地与元进度件仍是程序化占位（2026-10-13 登记，来源=审计发现，设计面=美术轨） @@ -562,7 +562,7 @@ **现状**：2026-10-16 迭代 29 编入批（提交 `21c83f5`）认定「需求卡片写进了 roadmap 却没在 06 登记」属流程漏洞，需要补一条卡片入库纪律。该条至今在 06 清单内查无（2026-10-17 与 2026-10-18 两次全文检索零命中）。唯一记过它的地方是根目录状态文件未决面第 31 行，该文件已于 2026-10-18 用户裁废除，故改记本条防遗忘。 -**归属**：design/dev/process-conventions.md 五段流水线的登记段 +**归属**：design/engineering/process-conventions.md 五段流水线的登记段 **状态**：待裁决（这条纪律要不要立；立则写进 process-conventions） diff --git a/design/gdd/术语表.md b/design/gdd/术语表.md index 0f372877..71736b20 100644 --- a/design/gdd/术语表.md +++ b/design/gdd/术语表.md @@ -85,7 +85,7 @@ | 术语 | 定义 | |---|---| -| 逐需求点验收清单 | 需求卡片验证闸的必备清单：每个需求点列明测什么（具体断言或行为）/怎么测（测试落点与注入方式）/谁验（自动闸或用户目检）；查不出验收条目的需求点=卡片不成立（规矩见 req-card 技能，测试落码写法见 [code-conventions](../dev/code-conventions.md) §3.5） | +| 逐需求点验收清单 | 需求卡片验证闸的必备清单：每个需求点列明测什么（具体断言或行为）/怎么测（测试落点与注入方式）/谁验（自动闸或用户目检）；查不出验收条目的需求点=卡片不成立（规矩见 req-card 技能，测试落码写法见 [code-conventions](../engineering/code-conventions.md) §3.5） | | 测试方式两分法 | 能力验证与体验验证分开走（2026-10-11 用户定）：能力验证=通过调试接口直接修改游戏数据（改钥石/槽位/解锁状态等，不走正常资源积累流程）；体验验证=用户目检完整流程，登记 07-体验验证清单观测项 | ## 用语规范（2026-10-15 用户令立） diff --git a/tools/doc_term_audit.py b/tools/doc_term_audit.py index af8c2c91..371a2294 100644 --- a/tools/doc_term_audit.py +++ b/tools/doc_term_audit.py @@ -24,7 +24,7 @@ from pathlib import Path # 退役词表：(正则词, 退役日期, 继任词/口径, 备注)。新增退役批时在此追加一行。 RETIRED_TERMS = [ - (r"registry|entities\.yaml|architecture\.yaml", "2026-10-19", "术语规范名→design/gdd/术语表.md；现行值→data/tables/*.tres；取值域与字段契约→data/schemas/*.gd；架构立场→design/dev/architecture/architecture.md", "跨系统事实登记处注销批（2026-10-19 用户裁）"), + (r"registry|entities\.yaml|architecture\.yaml", "2026-10-19", "术语规范名→design/gdd/术语表.md；现行值→data/tables/*.tres；取值域与字段契约→data/schemas/*.gd；架构立场→design/engineering/architecture/architecture.md", "跨系统事实登记处注销批（2026-10-19 用户裁）"), ("伏击", "2026-09-20", "警觉（blast 负向）", "伏击机制整体退役"), ("ambush_double|ambush_layers|flat_attach", "2026-09-20", "enemy_alert / effects 投影", "伏击数据键退役"), ("advantage_per_round_cap", "2026-09-20", "（已删字段——行动点天然封顶）", "单轮授予上限删除批"), diff --git a/tools/gdd_lint.py b/tools/gdd_lint.py index da65e6e6..041b744a 100644 --- a/tools/gdd_lint.py +++ b/tools/gdd_lint.py @@ -6,7 +6,7 @@ r"""gdd_lint.py — GDD lean 格式门禁 python tools/gdd_lint.py ... # 检查指定文件 python tools/gdd_lint.py --json # 机器可读输出（供 gate/CI 使用） -规则（口径权威 = design/dev/doc-conventions.md 第 5–6 节文档骨架与结构纪律）: +规则（口径权威 = design/engineering/doc-conventions.md 第 5–6 节文档骨架与结构纪律）: R1 散文段落 ≤ 240 字（代码块/表格/列表/引用不计） R2 表格字符占比（词条表分域豁免，见 R2_EXEMPT 注） R3 正文禁止修订注记：~~删除线~~、"作废"、括号内"日期+评审/修订/拍板/裁决/核销"（版本历史节豁免； diff --git a/tools/pipeline_gate.py b/tools/pipeline_gate.py index 84ef32aa..676a2fbc 100644 --- a/tools/pipeline_gate.py +++ b/tools/pipeline_gate.py @@ -46,7 +46,7 @@ SOURCE_RULE_DATE = (2026, 10, 18) # req-card §2：设计事实源必填 SOURCE_MARKS = ("设计事实源", "唯一事实源") # 两种合格写法，与库内既有卡片实际形态对齐 SYNC_HEADING_RE = re.compile(r"^#{2,3}\s*\d*\.?\s*关联文档同步面") BANNED_DOC_MARKS = ("design/", "../gdd/", "../registry/", "../research/", "../qa/", - "../dev/", "../ux/", "../art/", "roadmap.md", "AGENTS.md") + "../engineering/", "../ux/", "../art/", "roadmap.md", "AGENTS.md") DATE_RE = re.compile(r"\d{4}-\d{2}-\d{2}") VER_RE = re.compile(r"[vV]\d+(?:\.\d+)*") diff --git a/tools/repo_structure_audit.py b/tools/repo_structure_audit.py index 26e5f9f7..63dbbc96 100644 --- a/tools/repo_structure_audit.py +++ b/tools/repo_structure_audit.py @@ -8,7 +8,7 @@ 六查： 1. 顶层目录白名单（新增顶层目录 = FAIL，须同批改 AGENTS.md + 本脚本白名单） 2. 根目录文件白名单（根上只许运行文件与规则文件） - 3. 图像白名单（图只许在 artwork/ game/assets/ design/art/references/ design/dev/architecture/ game/tests/golden/） + 3. 图像白名单（图只许在 artwork/ game/assets/ design/art/references/ design/engineering/architecture/ game/tests/golden/） 4. 退役路径守卫（production/ docs/ tests/ qa-data/ design/registry/ design/qa/ 旧路径再现 = FAIL） 5. design/ 一级子目录白名单（防临时新目录） 6. design/art/ 内容白名单（只许 .md 与 references/；审计报告属中间文档归 design/research/） @@ -33,14 +33,14 @@ ROOT_FILES = {"AGENTS.md", "README.md", "roadmap.md", "stage.txt", "review-mode. # game/tests/golden/ 收编（迭代 19 卡① T2/T6 2026-10-08——棋盘 golden 基线=机检测试资产非美术素材， # 素材齐盘态生成入库【基线换代权限 Q6】；T1 落库时漏改本白名单致熵增闸红，同批修订 commit 留痕） IMAGE_EXTS = {".png", ".jpg", ".jpeg", ".webp", ".gif", ".svg", ".pxo", ".psd", ".bmp"} -IMAGE_PREFIXES = ("artwork/", "game/assets/", "design/art/references/", "design/dev/architecture/", +IMAGE_PREFIXES = ("artwork/", "game/assets/", "design/art/references/", "design/engineering/architecture/", "game/tests/golden/") # 4) 退役路径（目录或文件任一再现即 FAIL） RETIRED = ["production", "docs", "tests", "qa-data", "design/registry", "design/art/candidates", "production/mockups", "design/ux", "game/tools", "design/qa"] # 5) design/ 一级子目录白名单（防 ad-hoc 新目录） -DESIGN_SUBDIRS = {"art", "dev", "gdd", "research"} +DESIGN_SUBDIRS = {"art", "engineering", "gdd", "research"} # 6) design/art/ 内容白名单——美术只放 .md 文档与 references/ 参考图； # 审计报告属中间文档，按 doc-conventions §11 落 design/research/，禁驻 art/ ART_EXTS = {".md"}