设计交付变更说明应让研发在一分钟内回答三件事:哪个版本是新的、改了哪些对象、怎样验收。标题写“订单详情 v2:地址入口、点击热区与可修改状态”,正文再列影响页面和动作。借助Pixso 的设计协作与交付能力把版本、标注和评论放到同一份文件,接收者能直接定位差异。

变更说明写三段
第一段是版本与时间,第二段是影响范围,第三段是验收动作。影响范围写页面、组件和状态,不只写“优化体验”;验收动作写输入条件和期望结果,例如“订单已发货时,地址区不显示修改入口”。
| 字段 | 示例 | 避免写法 |
|---|---|---|
| 版本 | 订单详情 v2,10 月 8 日 | 最新版 |
| 影响范围 | 地址入口、热区、发货状态三处 | 页面优化 |
| 验收动作 | 已发货时检查只读地址 | 请关注细节 |
用一个具体改动贯穿说明:订单详情的收货地址原来整行可点击,现在只有“修改地址”入口可点击,并且已发货订单不再显示该入口。这不是简单的按钮样式变化,它同时涉及热区、订单状态和键盘焦点。只写“优化地址模块”会漏掉后两项。
变更条目可以这样记录:“D-17,订单详情/地址模块;未发货订单显示修改入口;已发货订单仅展示地址;旧的整行点击热区移除。”再关联设计画板、业务需求编号和计划进入的开发批次。编号便于讨论,但不要把纯编号当成读者能理解的标题。
差异要连接到具体对象
截图或标注框只负责定位,旁边要写改变了什么以及为什么。多个状态有同一改动时列出全部状态,避免研发只改默认态。组件变更要说明是否影响实例、变量或响应式规则,不能只贴一张漂亮的对比图。
新版稿应保留稳定的画板名称,开发能从工单链接直接找到对应对象。旧版作为对照或命名版本留存,不用删除旧对象后创建一个全新文件,让原有评论与链接失效。若确需拆文件,变更说明中提供新的对应关系,而不是只丢一个首页链接。
对于 D-17,可把差异分成三行:视觉上新增文字入口;交互上取消整行热区;业务上仅未发货订单可修改。验收时每行都有不同动作:查看视觉、点击空白区域、切换订单状态。拆开后,研发和测试不必从一张截图推理全部规则。
把未决事项和已决定事项分开
仍在讨论的文案、等待业务确认的字段和已通过评审的修改使用不同标签。变更说明不要混入个人建议,否则接收者会把未决项当成开发要求。评论里引用对应画板和节点名称,避免出现“这里”“上面”等失去上下文的说法。
“待确认:已出库未发货是否允许修改”应单独放在未决区,写负责人和确认日期。若这个结论影响本次实现,就把条目标为受阻;若可以先实现其他确定部分,明确它们的范围。不能在标题写已定稿,下面却夹着会改变逻辑的开放问题。
开发已经实现旧交互时,变更说明还要记录迁移次序:是否先关掉旧热区,再增加新按钮;灰度期间两种入口是否共存。发布批次与设计版本是两条信息,设计 v2 可能分两次上线,不能用一个“v2”代替实际交付范围。
交付前做一轮差异验收
- 按页面清单检查默认态和异常态。
- 按组件清单确认实例是否继承新规则。
- 按交互清单运行入口、返回和错误路径。
- 在同一文件记录已处理和待确认项。
这些内容在 Pixso 文件中保持链接关系,研发可以从说明跳到画板,产品也能看出每一项变更对应的用户任务。
评审结束后,把已确认的变更条目冻结在命名版本里,后续新增修改继续使用新的编号。Pixso 的原型协作能力支持用页面路径讨论操作结果;本例可分别演示未发货可修改、已发货只读和返回订单详情三个状态。评论负责沟通,变更条目负责记录结论,两者各有用途。
文字可以参考Carbon 的内容原则保持清晰和可操作,但真正有用的是写出本次对象、差异和影响,而不是给每份交付套上同一段“规范说明”。