# 协作复盘 · Embedded Audio 分页方案 + FB-9586 回复 + 规范回流（2026-06-24）

> 给 UX 团队 / PM 内部分享。承接 [2026-06-22 Embedded Audio X/Y 矩阵 retrospect] 的续作 session。

## 1. TL;DR

- **总轮次**：~10 轮（5 轮建分页板 + 5 轮打磨 FB-9586 回复文案）。
- **最终交付**：① Figma 分页对比板（方案 A 单页 vs 方案 B 拆 VoIP/IFB + Audio 两页，给 PM 选）；② PRD 链接修复（需求来源补全 5 个 Jira + 全部可点击）；③ FB-9586 Jira 回复（comment 249176，@Trevor PM 确认 + FYI 开发）；④ 规范回流 commit `86b8047c`（M23.8.1 + Q15 路由治本，push origin+github）。
- **核心 process gap 数**：3（Section 坐标坑复发 / 并发仓库自动 commit 竞态 / Jira 回复多轮打磨）。
- **关键 insight**：**M23.8.1（PRD 需求来源须列全 Jira 关联链 + 可点击）由本日两个独立 session 同时收敛提出**——本 session 从 FB-9586 缺链触发、09:30 V4-2259 session 从 R1 候选触发。同一规则被多源验证 = 强信号该回流，且已 commit 落地。

## 2. Session 概览

- **起点**：续跑 handoff —「VoIP/IFB 与其他 Audio 分 2 page 的效果图，给 PM 选」。
- **落地**：分页对比板 Section `7503:1027`（B-Page1 `7503:1028` / B-Page2 `7503:1188` / 决策 header / A/B 摘要卡 / 跨页依赖 callout）；FB-9586 comment 249176；DS repo commit `86b8047c`。
- **Process artifacts**：本复盘 + work-log 2 条 + memory 增量 + STATUS-CHANGELOG 回流条。

## 3. 主要迭代时间线

| # | 阶段 | 触发 | 改动量 |
|---|---|---|---|
| 1 | 建分页板（clone ×2 → 裁剪 → nav 加 Audio tab → A/B 标注） | handoff 既定 | 大（~12 次 use_figma） |
| 2 | **Section 坐标坑修复** | 自查 absoluteBoundingBox 发现内容飘出压 Jira | 中（重设 6 子节点相对坐标） |
| 3 | **Tx mixing 移回 VoIP/IFB** | 用户：「这块在 Audio 页没上下文」→ 核实 FB-4898=4 路 VoIP | 中（改可见性 + 同步标注/callout） |
| 4 | FB-9586 回复 5 轮打磨 | 用户逐句纠：删「good news」「As PM」「your call」→ confirm；前 2 点定性为开发建议、第 3 点 PM 拍板；技术措辞（连续声道 / 一对 Audio Device 声道） | 小（纯文案） |
| 5 | PRD 链接修复 + 规范回流 + commit/push | 用户：「需求缺 FB JIRA + 链接为什么不可点击 + 要回流」 | 中（Figma + 3 conventions 文件 + commit） |

## 4. Top 3 Process Gap（按返工成本排序）

### G1 — Section 偏移子节点坐标（最高返工，且**已是规则却复发**）
- **实证**：分页板 6 个子节点设成「画布绝对坐标」，但 Section 子节点是 **section-relative**（`child_abs = section.x + child.x`），内容整体飘到 abs(-2144,-12310)，正压在 Jira 组件上。靠 `absoluteBoundingBox` 自查 + 审计 I3 overflow 才发现。
- **返工成本**：1 次诊断 + 1 次重设坐标 + 重新截图验证。
- **根因**：规则 figma-technical-reference **Q15** 早在 2026-06-04 就立（且标「高频复发坑」），但**不在 mockup-conventions 路由表里 → scoped-load 起手扫不到 → 反复被漏读**（本 session 是第 3、4 次重踩，含同日 TPC popover）。
- **回流落点**：✅ 已治本——把「往 Section 内 create/move/定位节点」加进路由表强制 load Q15（commit 86b8047c）。

### G2 — 往有并发活动的 repo 自动 commit → git 竞态
- **实证**：DS repo 当时有另一 session 在并发提交字体统一工作（staging plan/backlog + 写 COMMIT_EDITMSG）。我自动 commit 回流时撞竞态：第一次误把 plan/backlog 捆进我的 commit，第二次 commit message 被错套成「字体统一」。
- **返工成本**：2 次撤销 commit（reset --soft）+ 诊断 + 等并发完成后重提。
- **根因**：未先探测 repo 是否有并发活动就自动 commit/push。
- **回流落点**：流程经验（非 TVU 规范）——**repo 有并发 commit 活动时，回流内容写好后交用户/等并发完成再提，AI 不自动 commit**；commit 后必 `git show --stat` 验范围 + 消息。

### G3 — Jira 回复文案 5 轮打磨（沟通规范）
- **实证**：初稿对 PM 用了「good news」「As PM」「your call」等口语/预设措辞，技术点也有误（「USB audio limited to 2/4/8ch」实为「嵌入只选连续声道」；「source pair」实为「一对 Audio Device 声道」）。
- **返工成本**：5 轮逐句改（纯文案，单轮低，但累计轮次多）。
- **回流落点**：沟通经验——**对 PM 的 Jira 回复：① 中性专业口吻（忌口语/预设身份）；② 明确区分「开发建议同步知会」vs「需 PM 拍板」；③ 技术措辞先和用户核准语义再下笔**。

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

**给提需求方（UX/PM）**
1. 续跑 handoff 里若有「已确认决策」，最好附**决策依据**（本轮分法是确认的，但 Tx mixing 归属靠用户后来用 FB-4898 才纠正——依据若前置可省 1 轮）。

**给 AI 协作流程**
2. **起手必把命中规则接进 scoped-load**——Q15 这种「有规则但不在路由表」是复发根源；治本 = 路由表覆盖，不是再背一遍。
3. **写操作前探测环境并发性**——多 session 同仓时，git 自动 commit 高危；Figma 写也要 get_metadata 验真。
4. **面向外部（Jira/PM）的文案，先给用户审定再发**（本轮纪律执行良好，未擅自发）。

**给 PM / Review 方**
5. FB-9586 回复已把「需 PM 拍板项」（A 单页 / B 分页）单列 + 附 A/B 对比智能链接，PM 可一处决策。

## 6. 回流规则清单

| 规则 | 真源文件 | 状态 | 简述 |
|---|---|---|---|
| **M23.8.1** | mockup-conventions.md | ✅ commit 86b8047c | PRD 需求来源须列全 Jira 关联链（SEC/FB/V4，按 issuelinks 核全）+ 每个 ID·Slack 外链 setRangeHyperlink 可点击 + cyan 高亮；create/update 都遵守。**= 09:30 session 的 R1 候选，双源收敛已落地** |
| **Q15 路由治本** | mockup-conventions.md（路由表）+ figma-technical-reference.md | ✅ commit 86b8047c | 「往 Section 放节点」触发强制 load Q15（Section 子节点 section-relative），根治复发 |
| G2 并发仓库 commit 纪律 | （流程经验，未进 TVU 规范） | 待 owner 拍是否成文 | repo 有并发活动时不自动 commit |
| G3 PM Jira 回复文案纪律 | （沟通经验，未进 TVU 规范） | 待 owner 拍是否成文 | 中性口吻 + 建议/拍板分层 + 技术措辞先核准 |

## 7. Model 选型

- 本 session（精细 Figma 结构改 + 坐标坑诊断 + git 竞态恢复 + 多轮文案）= 高推理 + 长 context，Opus 合适。
- 批量审计（conformance 全套）外包给 subagent（一般 model 即可），主线只接结论——本轮已照此执行，省主线 token。

## 8. 给团队的 Action Items

1. **PM（Trevor）**：在 FB-9586 comment 249176 确认 2 个设计点（嵌入只选连续声道 / 矩阵路由 + 源跟随 Mic&Speaker）+ 在方案 A（单页）/ B（分 VoIP/IFB + Audio 两页）间拍板。
2. **开发（Bonnie/Dave/Bonson）**：知会上述设计假设；WebCam 视频嵌入可先 SDI 后补（同 UI）。
3. **DS owner**：G2/G3 两条流程经验是否成文进 design-process（本复盘暂记，累积同类再抽象）。

### 附录 · use_figma 改动统计
- 分页板：新建 Section 1 + clone 设备页 2 + 标注卡/header/chip ~6 容器 + ~30 文字节点。
- 修复：Section 坐标重设 6 + glyph 清理 4 + Tx mixing 可见性切换 2 + PRD 链接 5×(hyperlink+cyan)。
- 机检：scoped `--node` colors/integrity/typography/bilingual 多轮，新作产物全 0 违例（继承自克隆 legacy 设备页的 C1/library/binding 债为 §M49.1 owner-deferred）。