变更说明怎么写：给未来同事与现在用户的两份

变更说明有两类读者。本文给出给未来同事的六项记录（重点：验证结果与未解决部分）、给用户的三句话（要不要变、什么变化、如何回退）、必须对外说明的四种情形与三个反模式。

变更说明不是"写给审计看的"

产品做变更（AI 改提示词、换模型、调默认值 ✔）时，往往只在内部**记一笔** ✗：

"更新了提示词" ✔ —— 三个月后没人知道当时为什么改 ✔，用户也完全不知道行为变了 ✔。

**变更说明有两个读者** ✗→✔：**未来的同事**与**现在的用户** ✔。写给这两类人，要求不同 ✔。

六项，缺一项都会让后来者困惑 ✔：

```

① 动机：要解决什么问题（附证据/事故编号 ✔）

② 改了什么（具体到文件/配置项 ✔）

③ 影响面（哪些功能、哪些用户 ✔）

④ 验证方式与结果（评测集、指标前后 ✔）

⑤ 回滚方式（怎么退回上一版 ✔）

⑥ 未解决的部分（如实写 ✔）

```

**第 ④ 与 ⑥ 最常被省略** ✗：没有验证结果，后人无法判断这次改动的价值 ✔；

不写未解决部分，后人会以为"已经做完" ✔。

用户只关心三件事 ✔：**我的用法要不要变、结果会有什么变化、出问题怎么退** ✔。

```

一句话说明变化（"回答会先给结论，更短" ✔）

要不要做什么（"无需操作"或"请重新确认默认设置" ✔）

如何回退（"可在设置里切回详细模式" ✔）

```

**要点**：**不要**写技术细节 ✗（"升级了模型版本" ✔ 对用户没意义 ✔）；

**要写**他们能感知的差异 ✔（"更长/更短""更保守/更果断" ✔）。

**行为显著变化**（语气、长度、默认值、是否自动执行 ✔）；

**能力收窄**（原来能做，现在不能 ✔ —— 这是最重要的 ✔）；

**数据使用变化**（是否外发、保留多久 ✔ —— 合规要求 ✔）；

**价格或额度变化** ✔。

**能力收窄不通知** ✗ 是最伤信任的一类 ✔。

**"优化了体验"** ✗（等于没说 ✔）；

**只发内部邮件** ✗（用户不知道 ✔）；

**变更说完不留档** ✗（后人无从追溯 ✔）。

> 半年后有人问"为什么这个行为是这样" ✔，你能否在**10 分钟内**从变更记录里找到动机与证据 ✔？

> 不能，说明变更只"发生"过，没有被记录 ✗。