游戏策划与系统设计 / 系统课时
整理可继续开发的设计文档
整理可继续开发的设计文档
这一节把已经验证过的战斗规则、数值、技能、敌人行为与测试结论收拢成一份可交接文档。目标不是把所有过程都写进去,而是让下一位策划或程序能快速判断当前版本“按什么规则运行、数据在哪里、哪些结论可信、下一步该改什么”。
学习目标
- 建立一套能定位规则、数据、行为和测试证据的战斗文档结构
- 区分稳定结论、待验证假设与版本历史,避免交接时混淆
- 用明确的索引和验收入口,让后续开发者可以继续迭代而不是重新考古
先整理成可维护的文档边界
可继续开发的文档不等于“把所有笔记合并成一个大文件”。真正需要交接的是五类信息:核心规则、数值来源、技能定义、敌人行为、测试结论。它们更新频率不同,最好保留独立来源,再由总览页建立索引。
| 内容 | 应写清什么 | 不应混入什么 |
|---|---|---|
| 核心规则 | 伤害、资源、硬直、无敌、死亡等判定顺序 | 某次测试的临时参数 |
| 数值表 | 字段含义、单位、上下限、当前基准值 | 只存在于聊天记录里的口头修改 |
| 技能说明 | 前摇、命中、消耗、效果、取消规则 | 与实现无关的表现描述堆砌 |
| 敌人行为 | 感知、决策、攻击条件、退出条件 | 未验证的“感觉应该这样” |
| 测试结论 | 场景、版本、数据、结论与后续动作 | 没有复现条件的主观评价 |

这张关系图的重点是“总览负责导航,源文件负责事实”。只要某个数据还存在第二份可编辑副本,后续就容易出现版本分叉。
给每条规则补足可执行条件
交接时最危险的不是缺少描述,而是描述没有边界。例如“受击后有无敌”并不能支持实现,至少要写清触发条件、持续时间来源、期间禁止哪些事件,以及与霸体、闪避等规则的优先级。
规则条目可以统一记录以下信息:规则名称、触发条件、输入数据、执行顺序、输出结果、例外情况、对应实现或表格位置。这样程序可以定位实现,测试也能据此编写用例。
下面是设计文档中的片段示例,需要与项目实际的数值表、技能表和测试记录一起使用。
rule:
name: 受击无敌
trigger: 普通受击结算完成
durationSource: combat_params.hit_invincible_ms
blocks:
- 普通伤害
- 普通硬直
exceptions:
- 处决伤害
references:
values: tables/combat_params
tests: tests/hit_invincible这里的路径只是文档索引格式,不代表真实项目目录。验证时,应从索引进入实际数据源,确认字段存在,并用对应测试场景核对规则描述与当前版本行为是否一致。
把测试结论写成可追溯证据
“手感偏快”“Boss 太难”不能直接作为交付结论。测试记录至少要能回答:测试的是哪个版本、用了什么角色与敌人配置、观察到什么数据、因此做了什么判断。
一条可交接的测试结论可以写成“版本 + 场景 + 指标 + 观察 + 决策”。例如:某版本中,基础敌人连续三次攻击的平均留给玩家反应时间低于设计目标,因此下一轮只调整第二、第三击的前摇,不修改伤害。这样后续人员能继续验证,而不是重新猜测问题来源。
明确版本状态与下一步动作
文档交付前,把所有内容分成三种状态:已确认、待验证、已废弃。已确认内容可以直接作为开发依据;待验证内容必须附带验证方法;已废弃内容保留简短原因和替代项,但不能继续出现在主流程说明中。
总览页最后应列出当前版本、最后验证日期、关键改动、已知问题、下一步实验,以及每个源文件的负责人或维护入口。重点不是追求人名完整,而是保证任何关键结论都有“谁来维护”和“去哪里改”两个答案。
用交接演练检查文档是否真的可用
最有效的验收方式是让一名没有参与本轮设计的人完成一次小改动。给他一个明确任务,例如“将某技能消耗降低并验证对连招循环的影响”,然后观察他是否能独立找到规则、数据、测试场景和验证标准。
如果他必须不断询问“这个值在哪”“这个规则还生效吗”“改完看什么指标”,说明文档仍然依赖口头知识。反过来,如果他能从总览进入唯一数据源,完成修改并按测试记录复核结果,这份文档才真正具备继续开发的条件。