# 协作复盘 · VoIP 话筒图标 UX 交付说明加到 Figma

> 内部分享向。记录 AI-用户协作过程的 process gap，供 UX/PM 提需求 + AI 协作流程改进参考。
> 日期：2026-07-06 ｜ 目标文件：Touch Screen v7.7–8.0（fileKey `0054ib0nLmt27bC3QlGDl7`）｜ 作者：Nancy Zeng + Claude

---

## 1. TL;DR

- **总轮次**：约 8 轮用户 feedback（含 1 次 /clear 后任务重述）。
- **最终交付**：Figma 两张 navy UX 交付说明卡 `9266:2`(RPS One 行) / `9271:1028`(V3 行),各贴自身流程右端的 Mute/Unmute 屏;来源行带 Slack 超链接;规则回流 M23.8.1 第 5 款「出处即链接」。
- **核心 process gap 数**：4（任务性质误读、坐标系 bug、漏 V3、漏出处超链接）。
- **关键 insight**:大 Figma 文件(原生 17142px)的读/写/坐标全放 subagent 跑、主线只接收结论;**append 到 SECTION 的节点 `.x/.y` 是相对 section 原点的局部坐标,不是绝对画布坐标**——这是本轮最大技术坑。

## 2. Session 概览

- **起点**：分析 Slack thread（CSC0M4V34）里 Nancy 的话筒图标(VoIP)结论 3 点,加到对应 Figma。
- **最终落地**：两张符合 M23.12 的 navy 说明卡（#2B2D42 / 圆角8 / padding20 / cyan#33A4FD 段名 / Noto Sans SC 中文正文 / 英文段名 label / 来源行 setRangeHyperlink+下划线），分别贴 RPS/V3 两条流程右端的 Mute/Unmute 屏。
- **Process artifacts**：4 个留档脚本（probe/write/fix/reposition，在 TVU Pack 目录）、mockup-conventions.md 规则回流、本复盘。

## 3. 主要迭代

| # | 阶段 | 用户 feedback 触发 | 改动量 |
|---|---|---|---|
| 1 | 读 Slack + 探测 | — | 读 thread、写只读 probe 脚本 |
| 2 | /clear 后误判 | "我没说要改页面,就是加说明文字" | 纠回"加说明"方向 |
| 3 | 建卡 | 确认语言/补充说明/位置 | 建 navy 卡 9266:2 |
| 4 | 补链接+V3 | "标了出处没带超链接,以后默认加" + "为啥只在 V4 加,V3 没加" | 来源行挂 Slack 链接 + 克隆到 V3 |
| 5 | 坐标 bug | (subagent 回报绝对坐标暴露偏移) | 修局部/绝对换算,回到左空档 |
| 6 | 关联区域 | "位置不对,都放一起了,没放关联区域" | 两卡移到各自流程右端贴 Mute/Unmute 屏 |

## 4. Top process gap（按返工成本排序）

1. **任务性质误读（改图标 vs 加说明）** — /clear 后把"加说明文字"误判为"改矛盾图标",问了改成 on/off 的方向。**返工成本**:2 轮澄清。**回流落点**:提需求时一句话锁死 deliverable 动词("加说明"≠"改设计")。
2. **use_figma 坐标系 bug（局部 vs 绝对）** — 卡 append 到 section 后,`.x/.y` 是相对 section 原点(4619,-676)的局部坐标;我按绝对 10846 设 → 实际落到绝对 15465,压住预览。**返工成本**:1 轮重定位 + 截图复验。**回流落点**:tvu-design-system `figma-technical-reference.md` 候选补一条「append 到 SECTION/FRAME 后设 .x/.y 用局部坐标,先读 parent.absoluteBoundingBox 换算」(待 owner 拍板)。
3. **漏 V3 行** — 卡放 section 顶部只贴上排(V4/RPS),漏了下排 V3;而说明对两设备都适用。**返工成本**:1 轮克隆。**回流落点**:多设备/多行流程,交付说明按行覆盖,起手先数清楚有几行。
4. **漏出处超链接** — 标了"来源:Slack 讨论"却只写文字。**返工成本**:1 轮补链接。**回流落点**:已回流 M23.8.1 第 5 款「出处即链接(默认)」。

## 5. 高效对话建议（按 ROI）

- **提需求方(UX/PM)**:一句话给全三要素——①deliverable 动词(加说明/改设计/画新页)②目标节点或截图 ③关联到哪个元素/哪几行。本轮"加说明 vs 改图标"来回,根因是动词没锁死。
- **AI 协作流程**:大 Figma 文件的读图/探测/写入一律 subagent 化(主线 context 已因大截图接近饱和);写坐标前**必读 parent.absoluteBoundingBox 做局部换算**,不假设 .x/.y 是绝对;每次写入后 bbox+截图双验再报。
- **Review 方**:验位置时直接说"贴哪个元素/哪一行",比"位置不对"更快收敛(本轮第 6 轮才明确"贴 Mute/Unmute 屏")。

## 6. 已回流 / 待回流规则

| 规则 | 真源文件 | 简述 | 状态 |
|---|---|---|---|
| M23.8.1 第 5 款「出处即链接(默认)」 | tvu-design-system `mockup-conventions.md` | 任何 UX 卡/annotation 标了来源/出处,该出处必须 setRangeHyperlink 可点 | ✅ 已回流 |
| SECTION 子节点局部坐标换算 | tvu-design-system `figma-technical-reference.md` | append 到 section 后 .x/.y 相对 section 原点,写前读 parent.absoluteBoundingBox 换算 | 🟡 候选,待 owner 拍板 |

## 7. Model 选型

- 主线编排 + 视觉判读 + 规则回流:Opus(本 session)——多轮上下文、大截图判读、坐标推理均胜任。
- Figma 读/写执行:交给 subagent(同 Opus,复用 figma-use 已加载上下文,SendMessage 续跑省 token)。

## 8. Action items

- [ ] （owner）拍板是否把「SECTION 子节点局部坐标换算」回流到 figma-technical-reference.md。
- [ ] （可选）若需通知相关方,草拟 Slack 回复贴回原 thread(本轮用户明确不用)。
- [ ] 保留 TVU Pack 目录 4 个脚本供同类"加 UX 说明卡"复用(probe→write→fix→reposition 模式)。

**附录 · use_figma 改动统计**:1 次建卡(3 段+补充+来源) + 1 次补链接 + 1 次克隆到 V3 + 2 次重定位 = 5 次写入;探测只读 2 次。全部经 subagent 执行、bbox+截图复验。