# 协作复盘（内部分享）— V4-1827 NDI 并入 IP Source 页 Mockup

> AI（Claude，Nancy 的 executor 代理）与 Nancy 协作过程复盘，供 UX / PM 内部分享。
> 区别于实现层 handoff（`docs/handoffs/2026-07-21-...`）与 design-record（`docs/specs/2026-07-21-...`）。
> 日期：2026-07-21 · 任务：V4-1827 Round 3

## 1. TL;DR
- **总轮次**：spec 起点 1 次 + 交互 gate/纠正约 6 次（PRD Gate A → 优先级 → 落点方案 → PRD 现状措辞纠正 → Gate B → 交付卡缺失纠正）。
- **最终交付**：Config-T `rJJjWWs51n2iFOlCIC7aYG` 工作页 `7452:2`，四段 Section（Context / BEFORE / AFTER〔流程卡+三态帧〕/ UX Delivery〔UX 卡+Journey 卡〕）+ _backup；PRD/UX卡/Journey卡/流程卡/design-record/handoff 全交付；Jira comment 255806 + priority→High。
- **核心 process gap 数**：2 个中等（PRD 现状措辞、交付卡跨页放置）+ 3 个低成本自查修正（流程说明补齐、auto-layout divider、嵌套 instance 改字）。
- **关键 insight**：spec 已 approved 大幅压缩前期 gate；但**交付物"组织/落点"与"内容"同等重要**——本轮内容早早正确，两处返工都出在组织（措辞的参照系、卡片的落页）。

## 2. Session 概览
- **起点**：已定稿+approved 的 spec（`docs/superpowers/specs/2026-07-21-...`）+ memory Round 3 段。
- **走的流程**：tvu-design-mockup 8 步 design-process（US-3 迭代既有 + Jira 关联硬 gate）。起手 M48/M49 kickoff packet（exit 0）→ Jira 评论链核实 → PRD 重写(Gate A/B) → Phase 0 外包只读 subagent 勘察 → Section 重构 + AFTER 三态帧 → 交付卡 → in-file 机检 → Jira 回复。
- **process artifacts**：kickoff packet · PRD(Figma) · design-record · handoff · ledger 条目 · REQUEST-INDEX · 本复盘。

## 3. 主要迭代表
| # | 触发 | 改动量 |
|---|---|---|
| 1 | spec approved → PRD 草稿 Gate A | 起草 6 段双语 PRD |
| 2 | 用户：优先级改 High | PRD ⑥ + Jira 字段 |
| 3 | 用户答落点方案（选项一 archive backup + 要前后对比 + 问为何没 Section 包裹）| 定 Context/BEFORE/AFTER/backup 结构 |
| 4 | **用户纠正：PRD "移除 NDI tab" 措辞错**（现状无 NDI）| PRD 标题/需求/背景改"新增" + 删 Req7 |
| 5 | Gate B PRD 写入 Figma 确认 | PRD 6 段 in-place 重写 + hyperlink |
| 6 | mockup 主体 + 交付卡建成 | Section 重构 + 3 态帧 + combobox 浮层 + UX/Journey 重建 |
| 7 | **用户纠正：看不到 UX 交付说明/流程/体验地图** | 交付卡从 page 3078 移到工作页 + 补交互流程卡 |
| 8 | 用户确认 Jira → 发送 | comment 255806 + priority High |

## 4. Top process gap（按返工成本排序）
1. **交付卡与 mockup 不同页（中）** — UX 卡 + Journey 卡在 Round-2 遗留的 page `3078:3723`，我按"discovery-before-create：更新既有不新建"就地改在原页，没意识到**原页位置本身就是问题**。用户看工作页时三样交付物都不在。返工：跨页移动 Section + 补流程卡。**回流落点**：交付集必须与 mockup **同页/同一交付区**；"更新既有"时要顺带审"既有的位置对不对"，不是无条件保留旧落点。
2. **PRD 现状措辞参照系错（中）** — 初稿写"移除独立 NDI tab"，但产品现状根本无 NDI/无 tab，"移除"只相对我们作废的 Round-2 草稿成立。**PRD 描述的是相对真实产品做什么，不是相对设计迭代**。返工：PRD 标题/需求/背景重述 + 删冗余 Req。**回流落点**：design-process Step B「现状/功能需求」措辞须锚定产品现状基线，作废的自家草稿不作为"现状"参照。
3. **流程说明起初缺失（低）** — Round-2 有流程连线 legend，Round-3 起初只有 3 态帧没有显式流程说明。用户提醒后补交互流程卡。**回流落点**：迭代方向变更时，对照上一版交付物清单逐项确认对等物（流程说明/状态标注等）不遗漏。
4. **auto-layout divider 插入（低，自查修正）** — divider `appendChild` 被落到 auto-layout 末尾（设的 x/y 被忽略）；改 `insertChild(1)` + `layoutSizingHorizontal FILL`。
5. **嵌套 instance 改字句柄失效（低，自查修正）** — combobox Option `setRangeFontName` 后 ID 位移致 `setCharacters` 抛错；去掉多余 setRangeFontName（本就 Roboto）+ 每次 `findAll` 重取句柄。

## 5. 高效对话建议
**给需求/纠正方（UX/PM）**：
- 落点/组织类期望（交付卡放哪页、要不要前后对比、要哪些说明卡）在**方案确认阶段**一次说清，比建完再补省一轮返工——本轮"交付卡缺失"若在结构方案时点明可省移动。

**给 AI 协作流程**：
- "discovery-before-create 更新既有"时，**同时审既有物的落点/组织是否合理**，别无条件继承旧位置。
- 方向变更（Round N→N+1）时，**对照上一版交付物清单逐项确认对等物**，避免漏（流程说明本轮即漏）。
- PRD/需求措辞**锚定产品现状基线**，作废的自家草稿不当"现状"。

**给 PM/review 方**：
- Jira 评论已按团队精简格式（`UX Design updated.` + Figma 锚链接 + @review + cc），一条直达设计，减少背景噪声。

## 6. 已回流 / 待回流规则
| 规则 | 真源文件 | 状态 |
|---|---|---|
| PRD 措辞锚定产品现状基线（非设计迭代参照）| ledger 反思 + design-record 决策#5 | 已记；候选升 design-process Step B |
| 交付集与 mockup 同页/同交付区 | 本复盘 §4.1 | 待用户拍板是否升 design-process ① |
| 方向变更逐项核对上一版交付物对等 | 本复盘 §4.3 | 待观察是否复发再抽象 |
| auto-layout 插入靠 index+FILL / 嵌套 instance 改字重查句柄 | ledger 反思(2)(3) | 已记（figma 技术坑，figma-technical-reference 候选）|

> 按 meta 规则：3+ 同类病灶累积后由用户拍板抽象到 tvu-design-system 真源；本轮先落 ledger + 本复盘，不直接改 DS 真源。

## 7. Model 选型
本 session 全程 Opus 4.8（1M context）：多轮 Figma write + 长 context（真源规则 + Jira + 多轮截图核验）下表现稳，未丢前文决策。Phase 0 勘察外包 general-purpose subagent 有效压缩主线 context。

## 8. Action items + use_figma 统计
- **Action items**：① owner 定夺是否把 §6 前两条规则升入 design-process；② 提供真实 NDI 源名清单后可程序化替换 combobox 示例名；③ REST token 配置后补跑 `pnpm audit:mockup-conformance` 双重确认。
- **use_figma 改动统计**（本 session write 调用）：PRD 6 段重写(2 calls) + 副标题 + Section 重构(2) + AFTER-1 clone/radio/状态色/divider(约5) + AFTER-2/3 clone+radio(1) + HDMI 内容(1) + NDI 表单(1) + combobox 浮层(2,含1次原子回滚重试) + caption(1) + UX 卡(2) + Journey 卡(2) + Journey 行距修正(2) + 交付 Section 跨页移动(1) + 流程卡(4,含宽/高自适应修正) + 机检(3)。截图核验约 10 次。