游戏策划与系统设计 / 系统课时

整理可继续开发的设计文档

整理可继续开发的设计文档

这一节把已经验证过的战斗规则、数值、技能、敌人行为与测试结论收拢成一份可交接文档。目标不是把所有过程都写进去,而是让下一位策划或程序能快速判断当前版本“按什么规则运行、数据在哪里、哪些结论可信、下一步该改什么”。

学习目标

  • 建立一套能定位规则、数据、行为和测试证据的战斗文档结构
  • 区分稳定结论、待验证假设与版本历史,避免交接时混淆
  • 用明确的索引和验收入口,让后续开发者可以继续迭代而不是重新考古

先整理成可维护的文档边界

可继续开发的文档不等于“把所有笔记合并成一个大文件”。真正需要交接的是五类信息:核心规则、数值来源、技能定义、敌人行为、测试结论。它们更新频率不同,最好保留独立来源,再由总览页建立索引。

内容 应写清什么 不应混入什么
核心规则 伤害、资源、硬直、无敌、死亡等判定顺序 某次测试的临时参数
数值表 字段含义、单位、上下限、当前基准值 只存在于聊天记录里的口头修改
技能说明 前摇、命中、消耗、效果、取消规则 与实现无关的表现描述堆砌
敌人行为 感知、决策、攻击条件、退出条件 未验证的“感觉应该这样”
测试结论 场景、版本、数据、结论与后续动作 没有复现条件的主观评价

战斗设计文档的交接关系

这张关系图的重点是“总览负责导航,源文件负责事实”。只要某个数据还存在第二份可编辑副本,后续就容易出现版本分叉。

给每条规则补足可执行条件

交接时最危险的不是缺少描述,而是描述没有边界。例如“受击后有无敌”并不能支持实现,至少要写清触发条件、持续时间来源、期间禁止哪些事件,以及与霸体、闪避等规则的优先级。

规则条目可以统一记录以下信息:规则名称、触发条件、输入数据、执行顺序、输出结果、例外情况、对应实现或表格位置。这样程序可以定位实现,测试也能据此编写用例。

下面是设计文档中的片段示例,需要与项目实际的数值表、技能表和测试记录一起使用。

yaml
rule:
  name: 受击无敌
  trigger: 普通受击结算完成
  durationSource: combat_params.hit_invincible_ms
  blocks:
    - 普通伤害
    - 普通硬直
  exceptions:
    - 处决伤害
references:
  values: tables/combat_params
  tests: tests/hit_invincible

这里的路径只是文档索引格式,不代表真实项目目录。验证时,应从索引进入实际数据源,确认字段存在,并用对应测试场景核对规则描述与当前版本行为是否一致。

把测试结论写成可追溯证据

“手感偏快”“Boss 太难”不能直接作为交付结论。测试记录至少要能回答:测试的是哪个版本、用了什么角色与敌人配置、观察到什么数据、因此做了什么判断。

一条可交接的测试结论可以写成“版本 + 场景 + 指标 + 观察 + 决策”。例如:某版本中,基础敌人连续三次攻击的平均留给玩家反应时间低于设计目标,因此下一轮只调整第二、第三击的前摇,不修改伤害。这样后续人员能继续验证,而不是重新猜测问题来源。

明确版本状态与下一步动作

文档交付前,把所有内容分成三种状态:已确认、待验证、已废弃。已确认内容可以直接作为开发依据;待验证内容必须附带验证方法;已废弃内容保留简短原因和替代项,但不能继续出现在主流程说明中。

总览页最后应列出当前版本、最后验证日期、关键改动、已知问题、下一步实验,以及每个源文件的负责人或维护入口。重点不是追求人名完整,而是保证任何关键结论都有“谁来维护”和“去哪里改”两个答案。

用交接演练检查文档是否真的可用

最有效的验收方式是让一名没有参与本轮设计的人完成一次小改动。给他一个明确任务,例如“将某技能消耗降低并验证对连招循环的影响”,然后观察他是否能独立找到规则、数据、测试场景和验证标准。

如果他必须不断询问“这个值在哪”“这个规则还生效吗”“改完看什么指标”,说明文档仍然依赖口头知识。反过来,如果他能从总览进入唯一数据源,完成修改并按测试记录复核结果,这份文档才真正具备继续开发的条件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

整理可继续开发的设计文档

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通