diff --git a/.claude/docs/templates/game-design-document.md b/.claude/docs/templates/game-design-document.md deleted file mode 100644 index f072c7d3..00000000 --- a/.claude/docs/templates/game-design-document.md +++ /dev/null @@ -1,152 +0,0 @@ - - -# [系统名称] - -> **状态**:In Design · **版本**:v1 · [日期] -> **一句话**:[这个系统做什么,一句话,≤30 字] -> **推演件**:`design/gdd/analysis/[system-name].md`(本文件只收结论,理由在那里) - -## 设计目的 - - - -[一段定位:这个系统为什么存在,游戏少了它会失去什么。] - -1. [玩家视角体验承诺] -2. [体验承诺] -3. [体验承诺] - -## 系统范围 - - - -负责: - -- [能力/数据/规则] - -不负责: - -- [明确不做/划给谁的内容——括注归属系统] - -## 核心循环 - - - -```mermaid -flowchart TD - A["起点"] --> B["..."] -``` - -| 结局 | 触发 | 结果 | -|---|---|---| -| | | | - -## [领域章节](按系统自定义 2–6 节) - - - -### [小节名] - -| 状态 | 含义 | 玩家/系统可做 | -|---|---|---| -| | | | - -规则: - -1. [谁]在[什么情况]下[做什么];[边界:不做 X]。 -2. [规则二]。 - -设计意图:[一行;为什么是这条而不是别的——超过一行去 analysis。] - -## 依赖与输出 - - - -| 方向 | 系统 | 性质 | 接口要点 | -|---|---|---|---| -| 上游 | | | | -| 下游 | | | | - -## P0 最小闭环 - - - -1. [玩家/系统动作] -2. [……] -3. [结果回流到循环起点] - -## P1 / P2 后置 - - - -| 优先级 | 内容 | 后置原因 | -|---|---|---| -| P1 | [内容] | [为什么现在不做——通常是要先验证 P0 的某个前提] | -| P2 | [内容] | [理由] | - -## 调参表(无独立数值的系统可省) - - - -| 字段 | 域 | 默认 | owner | 说明 | -|---|---|---|---|---| -| | | | | | - -## 验收标准 - - - -| 目标 | 验证问题 | -|---|---| -| [P0 闭环成立] | [玩家能否……/当……时系统是否……] | -| | | - -## 版本历史 - -| 版本 | 日期 | 改动 | -|---|---|---| -| v1 | [日期] | 初始版本 | - - diff --git a/design/dev/doc-conventions.md b/design/dev/doc-conventions.md index ba2afcf7..6701df0d 100644 --- a/design/dev/doc-conventions.md +++ b/design/dev/doc-conventions.md @@ -11,7 +11,7 @@ **读者测试是每个小节的验收标准**:只读这一节,回答三个问题——这节管的是谁/什么?在什么情况下?会发生什么?答不出来,就重写这一节,而不是给看不懂的地方补注释。 -旧体系 lean 格式六条硬规则已停用,仅用于解读 `design/archive/` 旧文档(其表格占比口径为 30%)。`tools/gdd_lint.py` 现为现行文档机检三闸之一(gdd_lint / doc_link_audit / doc_term_audit,分级周期口径见 AGENTS.md);可读性仍是第一内容质量门,lint 是格式机检面,两者并行。旧模板留档 `.claude/docs/templates/`。 +旧体系 lean 格式六条硬规则已停用(其解读对象 `design/archive/` 旧档已删除,现无适用文档;原表格占比 30% 口径随之作废)。`tools/gdd_lint.py` 现为现行文档机检三闸之一(gdd_lint / doc_link_audit / doc_term_audit,分级周期口径见 AGENTS.md);可读性仍是第一内容质量门,lint 是格式机检面,两者并行。 ## 2. 白话写作规则 diff --git a/tools/gdd_lint.py b/tools/gdd_lint.py index 989bab1c..da65e6e6 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 使用) -规则(与 .claude/docs/templates/game-design-document.md 纪律一一对应): +规则(口径权威 = design/dev/doc-conventions.md 第 5–6 节文档骨架与结构纪律): R1 散文段落 ≤ 240 字(代码块/表格/列表/引用不计) R2 表格字符占比(词条表分域豁免,见 R2_EXEMPT 注) R3 正文禁止修订注记:~~删除线~~、"作废"、括号内"日期+评审/修订/拍板/裁决/核销"(版本历史节豁免;