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: 确认 + 存储

调用 brand-context-builder 验证并存储到 memory/brand-context.json
初始化 memory/workshop-progress.json（此时 currentPhase 仍为 "intake"，不要直接切到 session-1）
初始化 memory/calibration-notes.json
展示品牌档案摘要，请用户确认

用户确认后 → 进入 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 后

输出："收到 token，正在帮你激活..."

运行：

node scripts/tools/set-voc-token.js <用户粘贴的 token>

再跑一次 voc-token-preflight 确认 status = valid

展示激活确认：

虾：✨ 已激活！账号 {{userId}}，余额 {{balance}} 次。

现在正式开始阶段一：品类全景分析！

更新 workshop-progress.json:
- currentPhase: "session-1"
- preflight: { lastValidatedAt, userId, balance, apigId, status: "valid" }
转由 workshop-session-1-category.md 接管

禁止行为（重申）

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

workshop-session-0-intake.md 6.8 KB Историја Датотека