直播口播稿生成器（批量 · 多商品 · Word 输出）

用途

把"发商品链接 → 研究卖点 → 写主播口播稿 → 导出 Word"这套流程固化下来。支持一次批量处理多个链接，
每个商品产出一份独立的 .docx 口播稿，文档内必须覆盖：商品速览、FAB 介绍、价格优势、顾客常见提问（Q&A）、
主播执行贴士。

> 本 skill 由真实用例沉淀而来：京东「护佑蓝芩喉糖」（临期清仓 + 商标争议）与 1688「小熊帆布包」（源头批发价 + 白牌无内袋）。
> 这两类雷点已被写进下方调研与合规要点中。

何时使用

• 用户给出 1 个或多个电商商品链接，要求生成直播带货口播稿。
• 用户明确要求"每个商品独立成稿 / 导出 Word / 批量生成"。
• 即便只发 1 个链接，也可走本流程（单元素数组即可）。

工作流程

Step 1 — 收集并核对商品链接

• 把用户给的链接逐个列出。若链接 ≥ 3 个，用 TaskCreate 建立任务追踪（每个链接一项，状态 pending → in_progress → completed）。
• 确认输出目录（默认当前工作区）。

Step 2 — 逐个商品调研（研究阶段，核心）

对每个链接执行两轮检索，缺失信息时在稿中标注【待确认】而非编造：

1. 抓商品页：用 WebFetch 抓取链接，prompt 明确要求提取：
   标题/名称、品牌、核心卖点、规格参数表、价格（现价/原价/划线价/起批量/阶梯价）、
   促销活动、材质或成分、产地、店铺名、是否一件代发、运费、评价关键词、库存。
2. 交叉验证：用 WebSearch 补充/核对：
   - 真实成交价或零售参考价（1688 批发价常需去义乌购等镜像站核对单件起购价）；
   - 起批量、是否支持一件代发、MOQ；
   - 争议与合规雷点（如"蓝芩含量为0"、临期清仓、虚假功效宣称、是否为白牌不可授权）；
   - 同类竞品卖点，用于差异化。

平台差异与雷点速查见 references/platform_notes.md。

Step 3 — 撰写口播稿内容（生成阶段）

每个商品必须包含下列必要元素（顺序可微调）：

1. 商品核心信息速览 — meta 二维表（项目 / 内容），含名称、平台、品牌、材质/成分、规格、价格、店铺、服务等。
2. 合规与诚实卖点提醒 — warnings 列表（强烈建议）：如"非药品不得宣称治疗""白牌非大牌""无内袋夹层""临期慎拍/不支持无理由"。
3. 产品 FAB 介绍 — fab 三列表格（特征 Feature / 优势 Advantage / 利益 Benefit），每行一个卖点。
4. 价格优势 — 在 script 中单列小节，写明真实到手价；不确定数字一律用【】占位并提示主播开播前填真实值。
5. 顾客常见提问回应（Q&A） — 在 script 中单列小节，覆盖材质/容量/价格/售后/是否正品等高频问题。
6. 主播执行小贴士 — tips 文本，含价格占位提醒、合规红线、节奏建议。

script 正文建议小节顺序：开场钩子 → FAB 介绍 → 价格优势 → 场景种草 → 常见提问回应 → 催单收尾。
语言口语化、可直接照念；价格/起批量等不确定项用【】占位。

将全部商品整理为一份 products.json（schema 与示例见 references/script_template.md），结构：

{
  "products": [
    {
      "name": "商品名称",
      "source": "京东 / 1688 / 淘宝 ...",
      "url": "https://...",
      "meta": [["项目", "内容"], ["品牌", "..."], ["价格", "..."]],
      "warnings": ["诚实卖点1", "合规提示2"],
      "fab": [["特征", "优势", "利益"], ["...", "...", "..."]],
      "script": [
        {"title": "开场钩子", "body": "口语化正文，换行用 \\n 表示。"},
        {"title": "产品FAB介绍", "body": "..."},
        {"title": "价格优势", "body": "到手价用【】占位。"},
        {"title": "场景种草", "body": "..."},
        {"title": "顾客常见提问回应", "body": "Q1：...\nA：...\nQ2：..."},
        {"title": "催单收尾", "body": "..."}
      ],
      "tips": "执行贴士多行文本，换行用 \\n。"
    }
  ]
}

Step 4 — 生成 Word 文档（确定性执行）

运行打包脚本，由它读取 products.json 并为每个商品生成独立的 .docx：

python scripts/build_docx.py --input products.json --out ./output

• 脚本依赖 python-docx；若环境缺失会尝试自动 pip install，离线环境请先手动安装。
• 每个商品输出一个文件：<商品名>_直播口播稿.docx，含速览表、FAB 三列表、口播正文各小节、执行贴士。
• 文档已设中文字体（宋体 / 微软雅黑回退），表格与标题排版规整，可直接打印或分发。

Step 5 — 交付

• 用 present_files 把生成的全部 .docx 一并展示。
• 文字汇总：每个商品的平台、核心卖点、价格占位、需重点提示的合规风险。

注意事项（红线）

• 功效合规：普通食品/保健品/草本类不得宣称治疗、消炎、杀菌等药效；只讲"舒缓/润喉/食养"。
• 品牌诚实：白牌/源头货不得包装成轻奢大牌；明确"不可授权自有品牌"时勿宣称可贴牌。
• 价格诚实：批发价 ≠ 零售价；1688 页面价是批量价，直播到手价必须让运营确认后再填【】占位。
• 临期/退换：临期清仓、不支持 7 天无理由等，须在产品速览与口播中明示，降低售后纠纷。