变更说明不是"写给审计看的"
产品做变更（AI 改提示词、换模型、调默认值 ✔）时，往往只在内部记一笔 ✗：
"更新了提示词" ✔ —— 三个月后没人知道当时为什么改 ✔，用户也完全不知道行为变了 ✔。
变更说明有两个读者 ✗→✔：未来的同事与现在的用户 ✔。写给这两类人，要求不同 ✔。
一、给未来同事的（内部变更记录）
六项，缺一项都会让后来者困惑 ✔：
① 动机：要解决什么问题（附证据/事故编号 ✔）
② 改了什么（具体到文件/配置项 ✔）
③ 影响面（哪些功能、哪些用户 ✔）
④ 验证方式与结果（评测集、指标前后 ✔）
⑤ 回滚方式（怎么退回上一版 ✔）
⑥ 未解决的部分（如实写 ✔）
第 ④ 与 ⑥ 最常被省略 ✗：没有验证结果，后人无法判断这次改动的价值 ✔；
不写未解决部分，后人会以为"已经做完" ✔。
二、给用户的（对外变更说明）
用户只关心三件事 ✔：我的用法要不要变、结果会有什么变化、出问题怎么退 ✔。
一句话说明变化（"回答会先给结论，更短" ✔）
要不要做什么（"无需操作"或"请重新确认默认设置" ✔）
如何回退（"可在设置里切回详细模式" ✔）
要点：不要写技术细节 ✗（"升级了模型版本" ✔ 对用户没意义 ✔）；
要写他们能感知的差异 ✔（"更长/更短""更保守/更果断" ✔）。
三、什么时候必须对外说明
- 行为显著变化（语气、长度、默认值、是否自动执行 ✔）；
- 能力收窄（原来能做，现在不能 ✔ —— 这是最重要的 ✔）；
- 数据使用变化（是否外发、保留多久 ✔ —— 合规要求 ✔）；
- 价格或额度变化 ✔。
能力收窄不通知 ✗ 是最伤信任的一类 ✔。
四、三个反模式
- "优化了体验" ✗（等于没说 ✔）；
- 只发内部邮件 ✗（用户不知道 ✔）；
- 变更说完不留档 ✗（后人无从追溯 ✔）。
一条判据
半年后有人问"为什么这个行为是这样" ✔，你能否在10 分钟内从变更记录里找到动机与证据 ✔？
不能，说明变更只"发生"过，没有被记录 ✗。