# V4-2333 移动测试图卡 — 协作复盘（内部分享）

> 记录我（AI 助手）和 Nancy 一起做 V4-2333 这个设计任务时，出了哪些问题、为什么、后来怎么解决的。给团队内部参考。2026-07-10。

## 一句话总结

这次任务的设计判断其实很顺——"测试图卡该怎么动起来"这类问题基本一次就聊清楚了。真正耽误时间的是执行环节我自己犯的几个错，尤其是把一份文档写坏、还有一版给 PM 的回复写得太啰嗦。下面把踩过的坑一个个讲清楚，方便以后少走弯路。

## 这次在做什么（背景）

V4-2333 是给 RPS One 背包的 LCD 屏加一个"传输测试"功能：没有真实信号输入时，操作员能一键推一张标准彩条测试图卡到接收端，验证"背包 → 机房"这条链路通不通。

这一轮的新需求是让测试图卡"动起来"——彩条朝右上角循环滚动，画面正中央放一个精确到毫秒的倒计时。我把这个效果画进了效果图，同步更新了需求文档（PRD）和 UX 交付说明，还应 owner 要求补了演示视频链接、去掉了文档里"v1/版本"这类说法。

## 出了什么问题 / 为什么 / 怎么解决

### 问题 1：我把设计记录文档写坏了（这次最大的坑）

- **现象**：更新设计记录时，一份 100 多行的文档突然膨胀到近 11000 行，多出来的上万行全是空行，文档基本废了。
- **原因**：我图省事想一次性把好几段内容拼进去，用错了编辑方式，相当于往文件里硬塞了一坨格式错乱的东西。更糟的是，之后我读这个坏文件，读出来的内容也是乱的，一度以为原文都丢了、白紧张一场。
- **解决**：把整份文档重新完整写了一遍，救回来了。**以后往文档里加大段内容，老老实实整篇重写，别用"精准插入"硬拼——省的那点事，翻车起来加倍还。**

### 问题 2：派出去干活的"分身"报错了位置

- **现象**：我让一个子任务去把视频链接贴进需求文档，它回报说贴在了某个位置，但那个位置根本不存在。
- **原因**：子任务自己汇报的位置编号不靠谱。
- **解决**：我没照单全收，自己用工具查了一遍真实结构，发现内容其实贴对了，只是它报的编号错了。**派出去的活儿，回报的关键信息要自己核一遍。**

### 问题 3：第一版给 PM 的回复太长

- **现象**：我第一版拟的 Jira 交付评论塞了一大堆——需求范围、交付清单、四个待确认问题，又臭又长。
- **原因**：团队其实早有约定"交付通知要精简"，我没照做。
- **解决**：owner 提醒后砍成一句话（设计已更新、请 PM 查看）+ 效果图链接 + @相关的人。技术待确认的问题另外走 Slack 问开发，不塞进交付通知。

### 问题 4：起手卡在"倒计时到底长什么样"

- **现象**：动手前卡了一阵，不知道倒计时该做成什么样（数字？圆环？带不带台标？），来回问了两轮才定。
- **原因**：owner 之前说"如图"的那张参考截图一直没传到（截图容易撑爆对话，owner 用文字描述代替了）。
- **解决**：用文字把形态（居中数字 + 背景色块）和格式（时:分:秒.毫秒）敲定后才动手。**关键视觉决策，起手用一句清楚的文字定下来，能省好几轮往返。**

### 问题 5：工具偶尔"抽风"

- 这次读文件、截图偶尔读出错乱内容或找不到位置。应对很简单：**改完任何文件立刻回读验证一遍，不轻信单次结果。**

## 几条让协作更顺的建议

- **给需求方**：关键效果的参考素材能给链接就给链接（这次视频链接一给，马上就贴进去了）；关键视觉决策起手用文字讲清。
- **给我自己**：大段内容整篇重写别硬拼、改完就回读、派出去的活自己核关键信息。
- **给 review 方**：owner 坚持"没看到效果图先不发 Jira"是对的，能避免发出去的东西已经过时。

## 还没做完的

- 给 PM 的精简 Jira 交付评论——等 owner 看过效果图再发。
- 四个技术问题走 Slack 问开发（"机房"缩写指什么、链路失败怎么显示、倒计时是倒数还是计时等）。
- 核实一下"交付通知要精简"这条是不是已经写进规范了。

（具体改了哪些节点、纯技术细节，都在 design-record 的 Revision Log 里，这里不堆了。）