# New Session Prompt — 消费产品验证（reference adoption 实测）

> 用途：开一个**新 Session** 装 TVU Design System 到一个**新消费产品 repo**，跑 audit / ESLint plugin / mockup binding，看是否能用。
>
> 这是 v1.0 触发条件 (3b "reference adoption") 的实测。
>
> 触发：复制下面 "起手 prompt" 整段，**在新 session 起手时**发给 AI。**先填入你要测的 consumer 产品信息**。

---

## 你需要先准备 4 件事

1. **Consumer 产品 repo 本地路径**（如 `~/Documents/AICoding/VS_Code/my-product`）
2. **Consumer 产品 GitHub repo URL**（如果有）
3. **你的 GitHub Personal Access Token**（read:packages scope；用于 .npmrc）— 在 prompt 里填入
4. **Consumer 产品的 Figma file key**（如果有 mockup 需要 audit）— 可选

---

## 起手 prompt（填空后复制给 AI）

```
我要在一个新消费产品上做 TVU Design System v0.6.0 的 reference adoption 实测。

【消费产品信息】
- 产品名: <在此填，如 "MicroApps Console">
- 本地 repo 路径: <在此填，如 "~/Documents/AICoding/VS_Code/my-product">
- GitHub repo: <在此填，如 "github.com/org/repo"，无则写 "N/A">
- Figma file key: <在此填，如 "DtZcMkhNy6qh6jbQQnhreQ"，无则写 "N/A">
- 我的 GitHub PAT (read:packages): <在此填>

【任务流程】(完整请按 docs/CONSUMER_AUDIT_SETUP.md)

1. 起手 onboarding (5-step) + 读 docs/CONSUMER_AUDIT_SETUP.md
2. cd 到我提供的产品 repo
3. 检查 .npmrc 是否存在；如果不存在，创建并写入:
   @nancyzeng0210:registry=https://npm.pkg.github.com
   //npm.pkg.github.com/:_authToken=<我的 PAT>
4. 跑 pnpm add @nancyzeng0210/tvu-design-system 安装库
   - 验证 postinstall banner 是否显示 (TTY 环境会显示)
   - 验证 node_modules/@nancyzeng0210/tvu-design-system/scripts/ 路径存在 (audit CLI 是否在 files[] 中)
   - 验证 node_modules/@nancyzeng0210/tvu-design-system/eslint-plugin/index.js 路径存在
5. 在产品 repo 加 ESLint plugin 配置：
   - 找产品的 eslint.config.js（或 .eslintrc.* 如果是 legacy）
   - 加 import tvuPlugin + tvuPlugin.configs.recommended
6. 在产品 repo package.json 加 audit 脚本 (per docs/CONSUMER_AUDIT_SETUP.md §3)
7. 跑首次 audit：
   - pnpm exec node node_modules/@nancyzeng0210/tvu-design-system/scripts/audit-product-code.mjs --dir src
   - 期望 finding 数 1-50 (legacy code 第一次跑通常 10-50 个真违例)
   - 跑 pnpm exec eslint . 看 ESLint plugin 是否在 IDE / CLI fire
8. 如果产品有 Figma mockup：
   - export FIGMA_PERSONAL_ACCESS_TOKEN=<token>
   - pnpm exec node node_modules/@nancyzeng0210/tvu-design-system/scripts/audit-mockup-library-binding.mjs <figma-file-key>
   - 看 M0/M1/M30 findings
9. 整理报告:
   - 安装成功/失败步骤
   - 每条 finding 是真违例 / false positive / unclear (供库 owner 改进 audit)
   - ESLint plugin 装上是否正常 fire
   - 文档 (CONSUMER_AUDIT_SETUP.md) 是否够清晰；遗漏的步骤
   - 总体接入是否顺利

【不要做的事】
- 不要 fix 任何 finding (这是装+测，不是 cleanup)
- 不要改产品 repo source code (除了 .npmrc / eslint.config / package.json)
- 不要 commit / push 到产品 repo (验证完后让用户决定要不要保留这些 setup 改动)

【期望产出】
- 安装日志 (npm output / error 如有)
- 首次 audit 报告片段 (前 20 行)
- ESLint plugin 装在 eslint.config 的 diff
- finding triage 表 (id / 是否真违例 / 是否文档缺失 / etc.)
- 改进建议: 给 docs/CONSUMER_AUDIT_SETUP.md 加什么 / postinstall banner 改什么 / audit rule 改什么
```

---

## 你期望 AI 输出什么

- 真正的安装实测日志（不是模拟）
- finding triage 报告（critical / acceptable / false-positive 分类）
- 接入文档 (CONSUMER_AUDIT_SETUP.md) 改进建议
- ESLint plugin 真用起来的体感反馈（rules 准不准 / false positive 多不多）

## 你不期望 AI 输出什么

- 给消费产品改源码（哪怕看起来 finding 是真的）
- commit/push 消费产品 repo
- 改 TVU Design System library 本身（DS 验证不在此 session 范围）

## 时间预估

- onboarding + 文档阅读 ~30min
- 安装 + 配置 ~30min
- 首次 audit + triage ~1h
- 报告 ~30min
- 总计 ~2-3h

## Session 结束后你要做的

1. 看 AI 报告，判断 finding 是否合理
2. 如果接入顺利 → reference adoption 实测完成；通知库 owner (我) 可以走 v1.0.0-rc.1
3. 如果接入有问题（文档错 / audit false positive / ESLint 装不上）→ 触发"修 docs/audit/plugin" session

## 关联文档

- [CONSUMER_AUDIT_SETUP.md](../CONSUMER_AUDIT_SETUP.md) — consumer-side setup 完整指南
- [MIGRATION_TO_V1.md](../MIGRATION_TO_V1.md) — 0.x → 1.0 升级指南（含 Button breaking）
- [V1_RELEASE_CHECKLIST.md](../V1_RELEASE_CHECKLIST.md) — 用户 5 大决策表 + 余下 v1.0 工作

## 关键约束（消费产品 session 必读）

- v0.6.0 已 publish 但 **files[] 漏了 scripts/** 这个 bug 已 fix 在 master，**未 ship 到 npm**。如果 consumer 实际跑 `pnpm add @nancyzeng0210/tvu-design-system@0.6.0` 会拿不到 scripts/。
  - 解决：在新 session AI 注意这点 → 报告"v0.6.0 装上看不到 scripts/，需要 v0.7.0 修"
  - 或：本地 dev 用 `pnpm pack` + `pnpm add <tarball>` 装 master 版本测
- ESLint plugin 在 v0.6.0 已 ship 但 consumer ESLint 9 flat config 是必需 (旧 .eslintrc 不支持)