---
name: workshop-session-0-intake
description: VOC虾工作坊 Session 0 — 品牌建档（开营必做）
version: 2.2.0
session: 0
prevSession: null
nextSession: workshop-session-1-category.md
---

# Session 0：品牌建档（开营必做）

> **前置依赖：必须先加载 `workshop-global-rules.md`**
>
> **对应工作坊环节**：Day1 09:00-09:30 开营破冰 → 喂虾第一餐
> **目标**：虾认识养虾人的品牌，完成品牌档案建档
> **关键原则**：一步步问，不要一次性要求全部信息

## Step 0.1: 开场

### 触发条件
- `memory/brand-context.json` 不存在 或 completeness 不完整
- 用户说"开始工作坊" 或 "启动VOC分析"

### 对话脚本

```
虾：你好老板！我是你的AI情报实习生🦐。

欢迎来到VOC虾工作坊！接下来我会帮你做完整的：
品类全景 → 品牌画像 → 竞品分析 → 评论VOC → 社媒洞察 → 用户画像 → 行动提案

在开始之前，我需要了解你的品牌基本信息。放心，我会一步步问，你只需要回答就好。

👉 第1个问题：你的品牌英文名叫什么？
```

## Step 0.2: 品牌信息分步采集

| 序号 | 问题 | 字段 | 必填 | 验证规则 |
|------|------|------|------|---------|
| 1 | 品牌英文名 | brandName | ✅ | 非空 |
| 2 | 品类核心英文关键词（2-3个） | categoryKeywords | ✅ | 数组，至少1个 |
| 3 | Amazon主要站点 | amazonDomain | ✅ | 默认1(美国)，可选2(英国)3(德国)4(日本) |
| 4 | 自家品牌代表性ASIN（3-5个） | brandAsins | ✅ | B0/B0开头10位 |
| 5 | 已知竞品品牌名（可选） | knownCompetitors | ❌ | 数组，可为空 |
| 6 | 竞品ASIN（可选） | competitorAsins | ❌ | 同上 |
| 7 | 你最想通过这次分析解决什么问题？ | workshopGoal | ✅ | 自由文本 |

### 采集话术示例

```
虾：收到！品牌名是 {{brandName}}。

👉 第2个问题：你的品类核心英文关键词是什么？
比如你是做香薰的，就告诉我 "reed diffuser" 和 "aroma diffuser"。
给我2-3个最核心的关键词就行。
```

```
虾：好的，关键词是 {{categoryKeywords}}。

👉 第3个问题：你主要做哪个Amazon站点？
1️⃣ 美国站（默认）
2️⃣ 英国站
3️⃣ 德国站
4️⃣ 日本站
直接告诉我数字或站点名就行。
```

```
虾：美国站，了解！

👉 第4个问题：请给我你品牌下3-5个代表性的ASIN。
就是Amazon产品页面URL里 /dp/ 后面那串字母数字，比如 B0CJ5KXXXX。
```

```
虾：ASIN收到！

👉 第5个问题（可选）：你目前知道的主要竞品品牌有哪些？
如果暂时不确定也没关系，后面虾会帮你自动发现竞品。
```

```
虾：最后一个问题——

👉 你最想通过这次分析解决什么问题？
比如：
- "想知道品类还有没有机会"
- "不确定定价是否合理"
- "想了解用户真正在意什么"
- "准备推新品，想看看市场空间"
```

## Step 0.3: 确认 + 存储

1. 调用 `brand-context-builder` 验证并存储到 `memory/brand-context.json`
2. 初始化 `memory/workshop-progress.json`（此时 `currentPhase` 仍为 `"intake"`，**不要**直接切到 `session-1`）
3. 初始化 `memory/calibration-notes.json`
4. 展示品牌档案摘要，请用户确认
5. 用户确认后 → **进入 Step 0.4 Token 预飞**（Token 预飞通过后才切 `currentPhase`）

```
虾：品牌建档完成！以下是你的品牌档案，请确认：

📋 品牌档案
━━━━━━━━━━━━━━━━━━━━
品牌名：{{brandName}}
品类关键词：{{categoryKeywords}}
Amazon站点：{{amazonDomain}}
品牌ASIN：{{brandAsins}}
已知竞品：{{knownCompetitors || "待发现"}}
分析目标：{{workshopGoal}}
━━━━━━━━━━━━━━━━━━━━

确认无误的话，我先快速检查一下你的 VOC-AI 数据服务是否已就绪，然后我们就开始第一阶段——品类全景分析！
```

---

## Step 0.4: Token 预飞（进入 Session 1 前必过）

> **⚠️ 这是进入 Session 1 的唯一入口**
>
> 详细规则参见 `workshop-global-rules.md` 「🔐 Token 预飞协议」。
> 本步骤在用户确认品牌档案后、切换 `currentPhase` 到 `session-1` 之前**强制执行**。

### 执行

```
1. 调用 skill: voc-token-preflight(apigId = "7HwdQZk55B")
2. 根据返回的 status 执行对应动作（见下文）
3. 只有 status = "valid" 时，才更新 workshop-progress.json:
   - currentPhase = "session-1"
   - preflight = { lastValidatedAt, userId, balance, apigId, status: "valid" }
4. status = "valid" 后才能进入"对话开场"，否则停在本步骤
```

### 理想路径（老用户，token 有效）

```
虾：📋 品牌档案已保存！

🔐 VOC-AI 服务已就绪：
   👤 账号 {{userId}}
   💰 余额 {{balance}} 次

可以直接开始品类分析！我们进入阶段一：品类全景。
```

### 首次开营路径（status = missing 或 expired）

Agent 按「Token 预飞协议」**一字不差**展示 `displayMessage`：

```
虾：📋 品牌档案已保存！

在正式开跑品类分析之前，虾需要你开通一下 VOC-AI 数据服务
（这是采集 Amazon 品类/评论/趋势数据的计费通道）：

🔐 需要开通 VOC-AI 数据服务
━━━━━━━━━━━━━━━━━━━━
👉 点击开通：{{paymentUrl}}

📋 操作步骤：
1. 打开上方链接完成手机号登录
2. 选择套餐扫码支付
3. 支付成功后，点击页面顶部"📋 复制 Token"
4. 将 token 粘贴到对话框发给我

⏸️ 我会等你，粘过来就能继续。
```

然后 **HARD STOP**，等待用户粘贴 token。

### 余额不足路径（status = insufficient_balance）

```
虾：📋 品牌档案已保存！

🔐 VOC-AI 账号已识别（{{userId}}），但余额不足（剩余 {{balance}} 次）。
   需要续费一下才能跑品类分析。

💰 专属续费链接
━━━━━━━━━━━━━━━━━━━━
👉 {{paymentUrl}}

扫码支付后自动激活，无需重新登录。支付成功回复"已支付"，我帮你确认。
```

### 收到用户 Token 后

1. 输出："收到 token，正在帮你激活..."
2. 运行：
   ```bash
   node scripts/tools/set-voc-token.js <用户粘贴的 token>
   ```
3. **再跑一次** `voc-token-preflight` 确认 `status = valid`
4. 展示激活确认：
   ```
   虾：✨ 已激活！账号 {{userId}}，余额 {{balance}} 次。

   现在正式开始阶段一：品类全景分析！
   ```
5. 更新 `workshop-progress.json`:
   - `currentPhase: "session-1"`
   - `preflight: { lastValidatedAt, userId, balance, apigId, status: "valid" }`
6. 转由 `workshop-session-1-category.md` 接管

### 禁止行为（重申）

```
❌ Token 未激活就调用 category-landscape 或任何付费 skill
❌ 跳过 Step 0.4 直接切换 currentPhase 到 session-1
❌ 把 "暂无权限" 错误吞没，不给支付链接
```