# New Session Prompt — 设计规范网站验收（docs site code↔Figma 一致性）

> 用途：开一个**新 Session** 验收 TVU Design System docs site，确认 code 1:1 还原 Figma 样式。
>
> 触发：复制下面 "起手 prompt" 整段，作为新 session 的第一条消息发给 AI。

---

## 起手 prompt（直接复制给 AI）

```
按 docs/internal/_plans/next-session-pickup-2026-05-19-verification.md 验证设计规范网站的 code↔Figma 样式一致性。

具体任务：
1. 完成 5-step onboarding (STATUS / PROJECT_GOAL / AGENTS §硬规则 / translation/ 四件套 / V1_RELEASE_CHECKLIST)
2. 跑 pnpm run prepublishOnly 看 baseline (13 audit gates 应全 green)
3. 启动 pnpm dev (http://localhost:5173)，按 navigation 依次过 30 个 docs page (dark + light 两主题各看一遍)
4. 重点 spot-check 5 个组件双向 Figma 一致性：
   - Button (8-axis canonical API)
   - FormItem (label dual-form)
   - Tooltip (content dual-form)
   - Pagination (含新的 cell-min-width="100%")
   - Notification (multi-status)
   每个组件：用 pnpm figma-url-to-canonical <figma-url> 拿到 figmaName / variantAxes 后，cross-check docs page demo 是否完整覆盖所有 axes / variants
5. 看 hidden a11y report (/internal/a11y-report 或 Shift+click 右上角 Version 药丸)：
   - text contrast 当前 baseline (设计师待 review)
   - non-text contrast (20 token pair)
6. 跑 pnpm test:a11y 看 Playwright 自动化 a11y 结果 (当前等设计师 Figma sync 后会清零)
7. 把所有发现整理为 finding list 报告给我，不动 src/ source code

禁止做的事 (按 verification mode):
- 不编辑 src/canonical/* / src/components/* / src/tokens/*
- 不跑 pnpm sync:figma-library (等设计师改完 Figma)
- 不改 translation/* (是 ground truth)
- 不 bump 版本 / tag 任何 release

预期产出:
- 一份 finding 报告 (markdown 或对话格式)
- 关键发现分级：critical (1:1 不还原) / serious (轻微 drift) / cosmetic (docs site UX 问题)
- 不要 fix，只发现 + 报告
```

---

## 你期望 AI 输出什么

- 30 page × 2 theme = 60 个 docs page 浏览 finding 表
- 5 个组件 spot-check 报告（每个组件含 figma variant 数 vs docs demo 数 + axis coverage 表）
- a11y report 解读（多少 finding 等设计师 / 多少属于 docs site 自身 bug）
- visual regression diff（如有）

## 你不期望 AI 输出什么

- 任何源码改动
- 任何 release prep
- 设计建议（如何改颜色 / 如何加 variant — 这是设计师的活）

## 时间预估

- onboarding ~30min
- 60 page 浏览 + 5 组件 spot-check ~2-3h
- 报告整理 ~30min
- 总计 ~3-4h

## Session 结束后你要做的

1. 看 AI 的 finding 报告
2. 把 critical/serious 的传给设计师 OR 自己改 docs site code
3. 决定是否触发"修 bug" session