# 设计与评审清单

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

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

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

每条写“通过／需修改／未验证”，附行为和证据。自评帮助发现问题，但不能作为唯一接受条件。核心来源：[状态与副作用](<../sources.html#ref-72f281c09c26be>)、[接口先行](<../sources.html#ref-efc8159becfd03>)、[评审 AI 产出](<../sources.html#ref-a210afd4a8dc45>)。

## 已填写的评审示例

现象：Aipcg 图片中心直接换算后与 World 坐标不同。证据：23 条 CSV 及真实 BoundsCenter。判断：核对方法遗漏旋转中心偏移；修正公式后最大误差为 0。结论：离线数据一致；真实地图视觉和本次 UE 执行未验证。见 [PCG-02](<../学习成果/Aipcg/PCG-02_Agent辅助TA开发案例.md>)。