设计与评审清单
基于本地设计指南,结合 V2.0 的资产检查器、Aipcg 与 Cindy 案例重新整理。下面是整理者的可迁移建议,不是通用强制规范。
| 判断对象 | 具体问题 | 需要的证据 |
|---|---|---|
| 需求 | 修改是否满足明确触发与输出? | 样例输入、接受条件、实际结果 |
| 范围 | 新依赖或抽象是否有当前用途? | 调用方、变化需求、朴素替代方式 |
| 职责 | 计算、编排和写入是否能分别解释? | 函数入口、数据流、副作用 |
| 接口 | 字段、单位、错误、完成状态是否清楚? | schema、调用点、失败样例 |
| 状态 | 谁拥有并修改状态,生命周期是什么? | 状态转换、事件与持久化顺序 |
| 正确性 | 检查能否发现原问题? | 修复前失败、修复后通过的相同样本 |
| 环境 | 替身与真实执行有什么差别? | 模型/引擎/服务的实际运行范围 |
| 维护 | 文档与代码是否仍一致? | 当前版本、哈希、差异和修订原因 |
同样输入能否重复,取决于接口是否包含时间、随机数和外部状态;不能给所有网络系统要求固定输出。纯计算适合独立检查,文件读取与保存仍然有副作用。一次性小脚本不必为抽象增加复杂层次。
每条写“通过/需修改/未验证”,附行为和证据。自评帮助发现问题,但不能作为唯一接受条件。核心来源:状态与副作用、接口先行、评审 AI 产出。
已填写的评审示例
现象:Aipcg 图片中心直接换算后与 World 坐标不同。证据:23 条 CSV 及真实 BoundsCenter。判断:核对方法遗漏旋转中心偏移;修正公式后最大误差为 0。结论:离线数据一致;真实地图视觉和本次 UE 执行未验证。见 PCG-02。