弱化系统文档固定骨架要求
将十二节同构结构调整为常见内容参考 降低边界与字段交接的必填口径
This commit is contained in:
@@ -456,7 +456,7 @@ description: 写游戏策划案（GDD）系统架构时使用。在顶层设计
|
||||
→ 没有变更记录的架构文档，第二轮迭代就会变成黑箱。
|
||||
|
||||
### 2. 系统地图
|
||||
Sxx 编号清单（核心系统 2~12 个）+ 支撑层（存档/UI，不拥有核心规则）。
|
||||
Sxx 编号清单（核心系统通常 1-5 个，有明确要求可超出 5 个）+ 支撑层（存档/UI，不拥有核心规则）。
|
||||
P0 段五列表：
|
||||
| 系统 | 目的 | 输入 | 输出 | P0 原因 |
|
||||
→ 每行 P0 原因必须答"删了它，__ 塌"；答不出的降级或合并。
|
||||
@@ -544,7 +544,7 @@ P1/P2 可用能力表（能力/说明）控制颗粒度。
|
||||
|
||||
---
|
||||
name: game-gdd-system-doc
|
||||
description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二节同构骨架、
|
||||
description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二类常见内容、
|
||||
红线与分析文档格式。每类系统的专属写法与模板在 01~12 各文件夹的 SKILL.md
|
||||
与 模板.md 里，按需取用。
|
||||
---
|
||||
@@ -594,7 +594,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪
|
||||
咬合：**对上**服从架构三条合同（编号/职责/依赖）；**对内**状态与接口不越
|
||||
职责边界；**对下**第 7 节交接喂 TDD。
|
||||
|
||||
## 四、十二节通用写法
|
||||
## 四、常见内容的参考写法
|
||||
（各系统类型的特殊写法见对应文件夹 SKILL.md；纯净模板在其 模板.md）
|
||||
|
||||
1 系统目的：若删除它，__ 会塌——一句话说不出 = 该系统不该存在。
|
||||
@@ -607,7 +607,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪
|
||||
8 反馈：每种关键结果给独立反馈形态；失败必须说明原因和恢复路径。
|
||||
9 内部循环：动词链；可拆单次/区域/长期三层。
|
||||
10 输入输出与依赖：引用具名系统与具名数据，禁泛称"资源"。
|
||||
11 边界与非目标：照该类型 skill 的"三不"写全；必含"字段数值归 TDD"一条。
|
||||
11 边界与非目标：参考该类型 skill 的“三不”说明边界；建议说明字段与数值的交接边界。
|
||||
12 开放问题：结构级才留；手感数值类标"待原型验证"。
|
||||
|
||||
## 五、分析文档（全局一份，按层分节）
|
||||
@@ -1190,7 +1190,7 @@ description: 写游戏策划案（GDD）系统架构时使用。在顶层设计
|
||||
→ 没有变更记录的架构文档，第二轮迭代就会变成黑箱。
|
||||
|
||||
### 2. 系统地图
|
||||
Sxx 编号清单（核心系统 2~12 个）+ 支撑层（存档/UI，不拥有核心规则）。
|
||||
Sxx 编号清单（核心系统通常 1-5 个，有明确要求可超出 5 个）+ 支撑层（存档/UI，不拥有核心规则）。
|
||||
P0 段五列表：
|
||||
| 系统 | 目的 | 输入 | 输出 | P0 原因 |
|
||||
→ 每行 P0 原因必须答"删了它，__ 塌"；答不出的降级或合并。
|
||||
@@ -1280,7 +1280,7 @@ P1/P2 可用能力表（能力/说明）控制颗粒度。
|
||||
|
||||
---
|
||||
name: game-gdd-system-doc
|
||||
description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二节同构骨架、
|
||||
description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二类常见内容、
|
||||
红线与分析文档格式。每类系统的专属写法与模板在 01~12 各文件夹的 SKILL.md
|
||||
与 模板.md 里，按需取用。
|
||||
---
|
||||
@@ -1330,7 +1330,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪
|
||||
咬合：**对上**服从架构三条合同（编号/职责/依赖）；**对内**状态与接口不越
|
||||
职责边界；**对下**第 7 节交接喂 TDD。
|
||||
|
||||
## 四、十二节通用写法
|
||||
## 四、常见内容的参考写法
|
||||
（各系统类型的特殊写法见对应文件夹 SKILL.md；纯净模板在其 模板.md）
|
||||
|
||||
1 系统目的：若删除它，__ 会塌——一句话说不出 = 该系统不该存在。
|
||||
@@ -1343,7 +1343,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪
|
||||
8 反馈：每种关键结果给独立反馈形态；失败必须说明原因和恢复路径。
|
||||
9 内部循环：动词链；可拆单次/区域/长期三层。
|
||||
10 输入输出与依赖：引用具名系统与具名数据，禁泛称"资源"。
|
||||
11 边界与非目标：照该类型 skill 的"三不"写全；必含"字段数值归 TDD"一条。
|
||||
11 边界与非目标：参考该类型 skill 的“三不”说明边界；建议说明字段与数值的交接边界。
|
||||
12 开放问题：结构级才留；手感数值类标"待原型验证"。
|
||||
|
||||
## 五、分析文档（全局一份，按层分节）
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
---
|
||||
name: game-gdd-system-doc
|
||||
description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二节同构骨架、
|
||||
description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二类常见内容、
|
||||
红线与分析文档格式。每类系统的专属写法与模板在 modules/system-types/ 下对应目录的 SKILL.md
|
||||
与对应模块的模板.md 里，按需取用。
|
||||
---
|
||||
@@ -28,7 +28,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪
|
||||
的判定部分），读取对应的 `SKILL.md` 与 `模板.md`。
|
||||
3. 该文件夹标注"参考例子"的，可先读例子了解写法。
|
||||
|
||||
## 三、十二节总览：写什么、为什么、怎么咬合
|
||||
## 三、常见内容总览：写什么、为什么、怎么咬合
|
||||
|
||||
系统文档回答四个问题：
|
||||
**这个系统为什么存在（1~2）→ 玩家怎么用它（3~5）→ 它怎么运转（6~8）→
|
||||
@@ -52,7 +52,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪
|
||||
咬合：**对上**服从架构三条合同（编号/职责/依赖）；**对内**状态与接口不越
|
||||
职责边界；**对下**第 7 节交接喂 TDD。
|
||||
|
||||
## 四、十二节通用写法
|
||||
## 四、常见内容的参考写法
|
||||
（各系统类型的特殊写法见对应文件夹 SKILL.md；纯净模板在其 模板.md）
|
||||
|
||||
1 系统目的：若删除它，__ 会塌——一句话说不出 = 该系统不该存在。
|
||||
@@ -65,7 +65,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪
|
||||
8 反馈：每种关键结果给独立反馈形态；失败必须说明原因和恢复路径。
|
||||
9 内部循环：动词链；可拆单次/区域/长期三层。
|
||||
10 输入输出与依赖：引用具名系统与具名数据，禁泛称"资源"。
|
||||
11 边界与非目标：照该类型 skill 的"三不"写全；必含"字段数值归 TDD"一条。
|
||||
11 边界与非目标：参考该类型 skill 的“三不”说明边界；建议说明字段与数值的交接边界。
|
||||
12 开放问题：结构级才留；手感数值类标"待原型验证"。
|
||||
|
||||
## 五、分析文档（全局一份，按层分节）
|
||||
|
||||
Reference in New Issue
Block a user