配套资料

设计与评审清单

基于本地设计指南,结合 V2.0 的资产检查器、Aipcg 与 Cindy 案例重新整理。下面是整理者的可迁移建议,不是通用强制规范。

判断对象 具体问题 需要的证据
需求 修改是否满足明确触发与输出? 样例输入、接受条件、实际结果
范围 新依赖或抽象是否有当前用途? 调用方、变化需求、朴素替代方式
职责 计算、编排和写入是否能分别解释? 函数入口、数据流、副作用
接口 字段、单位、错误、完成状态是否清楚? schema、调用点、失败样例
状态 谁拥有并修改状态,生命周期是什么? 状态转换、事件与持久化顺序
正确性 检查能否发现原问题? 修复前失败、修复后通过的相同样本
环境 替身与真实执行有什么差别? 模型/引擎/服务的实际运行范围
维护 文档与代码是否仍一致? 当前版本、哈希、差异和修订原因

同样输入能否重复,取决于接口是否包含时间、随机数和外部状态;不能给所有网络系统要求固定输出。纯计算适合独立检查,文件读取与保存仍然有副作用。一次性小脚本不必为抽象增加复杂层次。

每条写“通过/需修改/未验证”,附行为和证据。自评帮助发现问题,但不能作为唯一接受条件。核心来源:状态与副作用、接口先行、评审 AI 产出。

已填写的评审示例

现象:Aipcg 图片中心直接换算后与 World 坐标不同。证据:23 条 CSV 及真实 BoundsCenter。判断:核对方法遗漏旋转中心偏移;修正公式后最大误差为 0。结论:离线数据一致;真实地图视觉和本次 UE 执行未验证。见 PCG-02。