零售指导手册产出

根据用户提供的品牌和产品信息，产出结构化的《零售指导手册》。工作流分两阶段：自动信息采集（品牌定位 + 受众画像）→ 引导式用户素材收集（产品权益 + 话术参考）。

环境与依赖

> Word 生成方式：使用 npm 包 docx（纯 JavaScript 实现），不依赖 pandoc/LibreOffice。脚本 scripts/gen_docx.js 封装了配色、字体、布局等样式常量和全套 helper 函数，agent 调用 helper 逐段构建文档，确保输出风格一致。
>
> 仅支持 Markdown 和 Word 输出，不支持 PDF。

一、工作流概览

Phase 0: 素材快问（先问用户有无现成素材）
    ↓
    有素材 → 先读取素材，从中提炼关键信息
    无素材 → 跳到 Phase 1
    ↓
Phase 1: 自动采集（品牌+受众），缺质保/三包等条款自行搜索
    ↓ 用户确认
Phase 2: 引导收集（产品素材+话术素材）
    ↓ 话术素材必须由用户提供，缺则标注待补充
    ↓ 素材齐全
Phase 3: 撰写输出 → 质检
    ↓
交付：Markdown 文件到素材同目录
    ↓ 询问是否转 Word

Phase 0 — 素材快问

先问用户有无现成素材文件。用户可以一次性提供：
- 文件夹路径（agent 自动扫描目录下所有支持的文件）
- 多个文件路径（空格或逗号分隔）
- 直接将文件作为附件发送

第一句话建议：
> 「您手上有现成的素材文件吗？可以直接给我文件夹路径、多个文件路径，或者把文件丢进来都行，我先读再跟您确认。」

执行要点：
- 从素材中提炼品牌、车型、产品范围、价格等关键信息，整理成确认稿让用户一次性确认
- 支持的文件格式：xlsx/docx/pdf/md/csv
- 大文件（>200行）先做关键词索引，再读取命中行
- 素材中未覆盖的信息（如品牌定位、用户画像），再通过 Phase 1 联网采集补充

流程经验

1. 输出目录默认规则

默认输出到素材所在目录，无需单独询问。如果用户没有提供素材（纯联网采集），则询问输出路径。交付时告知用户文件路径即可。

2. 质保/三包等条款自动搜索

用户提供的资料中没有质保政策、三包期限、保养周期等信息时，agent自行联网搜索采集，并在手册中标注「以下信息来源于公开搜索结果，具体以品牌官方最新保修手册为准」。搜索优先使用WebSearch工具，不做无效的官网web_fetch。

3. 话术素材必须由用户提供

话术章节依赖用户的销售方法论素材。如果用户无法提供：
- 使用 references/sales-tactics.md 通用框架作为基础
- 手册中明确标注「本章节话术基于通用销售心理学框架，建议补充品牌定制内容」
- 严禁凭空编造品牌定制话术

4. 产品类型前置判断

Phase 0 读取素材后，先判断产品类型，不同类型对应不同的核心话术逻辑：
- 延保型（质量问题延长保修）→ 重点：质保空白期、老化件、三电误区
- 事故补偿型（保险叠加型，如畅行无忧）→ 重点：概念切割（≠保险≠延保）、与车险的差异化、事故维修成本
- 混合型 → 两者结合

此判断影响第二部分的产品逻辑和第三部分的异议处理重点。

5. 联网采集优先搜索引擎

Phase 1 采集时：WebSearch搜索 → web_fetch官网。官网和汽车媒体页面大多需要JS渲染或有反爬，web_fetch成功率低。搜索引擎已做内容提取，结果更可靠。只在需确认精确配置表/价格表时才尝试web_fetch。

6. 大文件先索引再读取

xlsx/csv超过200行时，先做关键词过滤（品牌名+产品名），拿到命中行后再细读。避免全量读取后反复筛选。

7. 阶段中间文件

每个Phase结束时，把关键产出写入中间文件（如素材目录下的_phase1_brand_info.md），跨session恢复时优先读文件而非依赖context摘要。

二、Phase 1 — 品牌定位与受众信息采集

无需用户提供任何素材，agent 独立完成。

1. 确认品牌和车型：与用户确认目标品牌和具体车型（如"岚图全系"还是"岚图梦想家"）
2. 联网搜索采集以下信息（优先WebSearch搜索，不直接web_fetch官网）：
   - 品牌定位、价格区间、在售车型矩阵
   - 各车型配置、核心科技卖点、与竞品差异
   - 目标客群画像（年龄、性别、消费特征、购车动机）
   - 人群细分（各占比例、关注点、推荐版本）
   - 质保/三包/保养政策（用户资料未覆盖时自动搜索，产出中标注来源）
3. 产出确认稿：整理成《[品牌]定位、受众分析及配置卖点对照表》，展示给用户确认
4. 用户反馈修正：如有偏差按反馈修正
5. 写中间文件：将确认稿写入素材目录下的 _phase1_brand_info.md

> ⚠️ 无网络时：跳过该项，在产出稿中标注"基于品牌官网 / 用户提供信息"

三、Phase 2 — 引导式用户素材收集

关键流程：列出所需素材 → 用户逐项提供 → 动态裁剪章节

素材清单

话术素材（关键项）

话术章节依赖用户的销售方法论素材。需按以下方式引导用户：

1. 先问用户是否有现有的销售话术参考文件、培训文档或话术库
2. 如果有，请用户提供（可以是 xlsx/docx/pdf/md 格式）
3. 如果没有，引导用户描述常用的销售战术（如算账法、对比法等）
4. 如果用户也提供不了，使用 references/sales-tactics.md 中的通用销售心理学战术作为基础框架，但需告知用户这是通用模板，建议补充品牌定制内容

> ⚠️ 严禁捏造：没有素材支撑的话术不要写。宁可跳过某个子章节，也不能编造。
> ⚠️ 话术素材不可自动搜索替代：话术属于品牌定制内容，必须由用户提供。通用框架仅作结构参考。

素材缺失处理策略

• 某个产品不售卖 → 跳过对应章节，手册目录动态调整
• 某个产品有售卖但无详细资料 → 引导用户补充，告知缺少哪些字段
• 用户无法提供 → 在手册对应位置标注「待补充」
• 所有缺失在交付时告知用户

四、Phase 3 — 撰写输出

标准目录结构（固定不可更改）

第一部分：品牌车型定位与用户画像
1. 车型定位 — 精炼定位总结 + "双刃剑"属性（科技配置高 vs 维修风险高）
2. 目标客群特征 — 核心画像、消费心理、人群细分表、各人群卖点清单
3. 销售应用原则 — 核心销售指导原则

第二部分：产品基础知识
（根据实际在售产品动态调整章节）
1. 车辆基础与保养政策 — 标准化保养/质保事实清单
2. 整车延保 / 驾行安心包 / 电池延保 / 轮胎 / 漆面（在售的保留，不售的删除）
3. 价格表（终端指导价） — 汇总表 + 质检红线提示

第三部分：接待话术推荐
1. 开场破冰与客情建联 — 3种风格话术模板
2. 客户画像识别与精准探需 — 3个方向探需话术
3. 场景塑造与需求挖掘 — 3大具体风险场景话术
4. 方案推荐与产品介绍 — 主推话术（算账法、权益叠加法）
5. 异议处理 — 9大高频异议的定制化话术 + 话术分析
6. 促单与合规结案 — 3种促单话术

文件名格式

《[品牌][车型][产品][业态]零售指导手册》

• 品牌：问界/岚图/零跑/理想等
• 车型：M7/梦想家/C11 等（全系可省略）
• 产品：延保/安心包/轮胎保障（多产品用"增值权益"）
• 业态：新车/售后/二网（新车可省略，售后必须标注）

示例：
- 《AITO问界M6延保新车零售指导手册》（默认新车）
- 《岚图全系增值权益零售指导手册》（多产品）
- 《零跑C11延保售后零售指导手册》（售后必标）

多业态适配

新车业态（默认）：
- 场景围绕"提车交车"
- 话术侧重"新车权益激活、厂家关怀、首保提醒"

售后业态：
- 场景围绕"回厂保养/维修"
- 话术侧重"车辆使用周期、老化风险、过保焦虑"

如果用户未明确业态，先询问确认。

关键撰写规范

1. 车型定位必须点明"双刃剑"属性 — 即科技配置高 vs 维修风险高
2. 话术部分必须包含"话术分析" — 核心战术、逻辑拆解、品牌定制点
3. 价格表必须附带质检红线提示
4. 严禁捏造 — 所有品牌、车型、产品信息需从采集结果和用户提供的原料中提取
5. 没有出处的宁可跳过 — 积分、优惠政策、产品特性等未在素材中明确提及的，不可擅自添加
6. 仅修改目标章节 — 更新手册时只修改指定章节，不删不改其他章节内容

四-2、质检流程（输出前自检）

每次产出手册后，执行以下质检清单，通过后再交付。

质检检查项

质检输出格式

质检完成后，向用户报告：

> 质检完成 ✅
> - 已检查 8 项，全部通过
> - 产出：《理想全系延保零售指导手册.md》
> - 话术来源：用户素材 + sales-tactics.md 通用框架
> - ⚠️ 待确认：电池延保条款中的「衰减判定标准」，建议补充官方文件

五、交付规范

默认输出

• 手册默认为 Markdown 格式
• 默认输出到素材所在目录，交付时告知文件路径即可
• 如果用户没有提供素材（纯联网采集），则询问输出路径

输出后格式转换

Markdown 文件交付后，主动询问用户是否需要转为其他格式：

> 「手册已生成 Markdown 文件。需要我转成 Word（.docx）格式吗？」

• Word：使用 scripts/gen_docx.js + references/docx-output-guide.md 规范生成，见下方
• 用户说不转 → 保持 Markdown 即可

Word 输出流程

前提：用户确认需要 Word 格式后执行。

1. 初始化临时 Node 项目：/tmp/docx_build/ 下 npm install docx
2. 引用 scripts/gen_docx.js：该脚本导出所有 helper 函数（h1/h2/h3/para/quote/bullet/makeTable/makeCover/analysisBlock/buildDocument 等），配色和字体已固化
3. 生成构建脚本：agent 根据 Markdown 内容编写 JS 脚本，调用 helper 逐段构建 docx children 数组
4. 验证文件完整性：用 Python zipfile 检查
5. 复制到目标目录，清理临时文件

⚠️ 禁止：不要使用内置 write 工具直接写 .docx 二进制文件；不要从零手写样式（必须引用 gen_docx.js 的固化配色）。

详细规范见 references/docx-output-guide.md。

用户确认→编辑工作流

1. agent 产出初始版本
2. 用户在本地编辑修改
3. agent 仅在用户明确要求时才重新生成或修改
4. agent 不主动重写用户已编辑的内容

六、反幻觉规则（最高优先级）

🔴 红线：凡是没有在用户提供素材或搜索采集结果中明确出现的信息，
         禁止写入手册。

具体违反示例：
- ❌ 编造品牌积分政策
- ❌ 编造产品优惠活动
- ❌ 编造质保条款细节
- ❌ 编造客户权益
- ✅ 用户提供的合同/条款/方案文件中写明的内容 → 可用
- ✅ 品牌官网/公开信息 → 可用（标注来源）

七、详细工作流参考

参见 references/workflow.md 获取：
- Phase 1 采集清单的完整字段明细
- Phase 2 素材收集的引导话术模板
- 各章节的具体书写标准和范例

话术部分若用户无法提供自有素材，通用销售框架见 references/sales-tactics.md。