quanlaidian-quotation-skill

name	quanlaidian-quotation-skill
description	全来店报价技能：当用户需要根据品牌名称、餐饮类型、门店数量、套餐和模块勾选来生成全来店报价单时触发。优先使用 OpenClaw 原生表单；若未出现原生表单，则立即改为少打字、以选择为主的引导式对话，最终输出 PDF、Excel 和 JSON 三份报价文件。

全来店报价技能

本技能用于把 OpenClaw 业务表单或引导式对话输入转换为全来店标准报价文件。

触发场景

当用户需要以下能力时使用本技能：

• 为餐饮客户生成全来店报价单
• 根据品牌名、门店数、套餐、增值模块生成报价
• 输出对客 PDF、内部 Excel 和留档 JSON
• 让销售或售前通过业务表单一键出报价
• 当原生表单未弹出时，通过少打字的引导式对话完成报价

输入方式

本技能优先接收业务表单字段，而不是完整报价 JSON。

如果当前运行环境没有展示原生表单，则自动切换为引导式对话收集字段。

核心字段：

• 客户品牌名称
• 餐饮类型
• 门店数量
• 门店套餐
• 门店增值模块
• 总部模块
• 配送中心数量
• 生产加工中心数量
• 折扣（成交价系数）
• 人工改价原因（提供成交价系数时必填）
• 是否启用阶梯报价
• 实施服务类型
• 实施服务人天

工作流程

1. 执行 python3 scripts/update_notice.py。若有输出（说明本节点被 check_openclaw_update.py 升级过且当前版本尚未告知过用户），将其原样作为本次回复的首段 Markdown 展示在用户面前，然后再进入正式报价流程。输出为空则直接跳过，不要刻意提及版本号或脚本细节。
2. 优先读取原生表单输入；若未出现表单，则进入引导式对话
3. 调用 scripts/quote.py 生成报价文件——这是产出报价的唯一方式。不得跳过此步直接在对话中拼装报价结果。
4. 在当前工作目录生成三份结果文件
5. 在 OpenClaw 对话中返回”报价内容预览 + 文件下载入口”

交互策略

交互原则

• 让用户点选/确认，少打字；一次只问当前缺失的关键字段
• 标准小连锁优先走默认值，不反复确认已明确信息
• 提问尽量短（"轻餐还是正餐？"），允许数字 / 中文名称 / 混合方式回复
• 生成前给一个简短配置摘要；生成后给可读预览 + 文件入口
• 仅在非标商务条件、人工改价、复杂联购、≥301 店时提示转人工

原生表单优先

• 若 OpenClaw 已展示原生表单，直接引导用户填写表单
• references/openclaw_form_schema.json 与 references/openclaw_form_config.json 可作为字段参考，但如果平台未自动加载，不要卡住流程

行业关键字 → 餐饮类型软推荐

当用户先描述品牌或行业时，按 references/dining_type_keywords.md 做一次软推荐（不自动设定），让用户一键确认；落在"需追问"桶则显式追问，不要猜。

无原生表单时的对话式收集顺序

按以下顺序逐步收集，优先给用户选项：

1. 品牌名称
2. 餐饮类型：轻餐 / 正餐（若用户已描述品牌或行业，先走上节『行业关键字 → 餐饮类型软推荐』，用户确认后可跳过此问）
3. 门店数量：优先让用户直接输入数字
4. 门店套餐：若用户已指定就用指定值；未指定时暂不锁定，等步骤 6 收完总部模块后按下一节『套餐默认决策树』终判（无总部模块 → 旗舰版；含 配送中心 / 生产加工 → 全能版 + 自动追加 供应链基础-门店点位）
5. 门店增值模块：根据餐饮类型给出可多选的候选项
6. 总部模块：给出可多选候选项
7. 若选择了 配送中心，再追问配送中心数量
8. 若选择了 生产加工，再追问生产加工中心数量
9. 若选择了实施服务，再追问实施服务类型与人天
10. 若用户明确要人工改价（提供了成交价系数），追问一句原因，直接用作 人工改价原因

套餐默认决策树（1–300 店全段；门店套餐 API 必填，不可留空）

• 总部模块为空 → 餐饮类型对应的 旗舰版（ZC-04 / QC-04，含单门店库存）
• 总部模块含 配送中心 或 生产加工 → 对应 全能版（ZC-03 / QC-03），并自动追加 供应链基础-门店点位 到门店增值模块；摘要里显式标注"为承接总部配送/生产加工自动追加"
• 不要默认到「旗舰版 + 配送中心」（单门店库存 与 供应链基础-门店点位 互斥业务路线，service 端 400 拒）
• 不要默认到 供应链版（ZC-05 / QC-05）：会丢「会员营销」；销售明确"客户不要会员营销"才手动切

未提门店增值模块、总部模块、实施服务时按"不选"处理，最终摘要中显式展示。

模块候选项

• 门店增值模块：按餐饮类型给出对话候选短列表，详见 references/module_candidates.md
• 总部模块：通用项 + 餐饮类型特定附加项，详见同一文件
• 完整 SKU、价格、套餐说明以 references/product_catalog.md 为准

大客户段（31–300 店）处理规则

• 31–300 店直接调用 API，不要在客户端拦截或改写。API 会按下锚点（50 / 100 / 200 / 300）生成主报价单，并在文件里附带"夹住输入值的两档阶梯对比页"。
• 夹住规则：30 ≤ N < 50 → [30, 50]；50 ≤ N < 100 → [50, 100]；100 ≤ N < 200 → [100, 200]；200 ≤ N ≤ 300 → [200, 300]。
• 当响应里 pricing_info.algorithm_version == "large-segment-v1"（或 preview.stores 与用户输入的 门店数量 不一致）时，必须在对话回复里显式说明："你填了 N 店（落在大客户段），主报价按 M 店方案生成，随单附 M / M' 两档阶梯对比表"，不要让客户误以为这就是 N 店的原生报价。
• 301+ 店：API 会返 422，skill 回复 "系统当前上限 300 店，超出需走大客户人工定价通道，请联系销管"。禁止给出任何估算数字。
• 大客户段同样适用上节『套餐默认决策树』。门店套餐 是 API 必填字段，任何分段都不允许留空。

多档主动对比（50 / 100 / 200、100 / 200 / 300 等）

• 当用户明确要三个锚点（50 / 100 / 200 / 300 中的任意三个）一起对比时：串行调用 scripts/quote.py 三次，每次只改 门店数量，其余字段保持一致。
• 每次调用拿到的就是该档对应的主报价单 + 该档的两档阶梯对比页；skill 侧不做 PDF 合并，只在对话回复里用一张汇总表并排展示三档的总价与单店均价，并给出三组文件下载链接。
• 不要用 是否启用阶梯报价=true 替代这种多次调用 — 是否启用阶梯报价 只在 ≤30 店段生效，返回 [10, 20, 30] 的一次性对比。
• 是否启用阶梯报价：≤30 店场景下的一键对比开关，设为 true 时 API 一次返回三档；≥31 店段此字段被服务端忽略（系统始终给两档对比）。

输出结果

OpenClaw 对话输出：

• 对话中展示报价内容预览（关键字段与主要费用项）
• 对话中提供 PDF、Excel、JSON 三个文件的下载入口（或可点击文件引用）

默认文件输出：

• 品牌名-全来店-报价配置-YYYYMMDD.json
• 品牌名-全来店-报价单-YYYYMMDD.pdf
• 品牌名-全来店-报价单-YYYYMMDD.xlsx

用途说明：

• PDF：对外发送客户
• Excel：内部调整与复核
• JSON：内部留档与再次生成

读取参考资料

必要时读取以下文件：

• references/product_catalog.md（完整 SKU 与对客标准价）
• references/sales_guide.md
• references/dining_type_keywords.md（行业关键字 → 餐饮类型软推荐）
• references/module_candidates.md（对话场景下的模块推荐候选短列表）
• references/openclaw_form_schema.json
• references/openclaw_form_config.json

调用脚本

生成完整报价文件：

python3 scripts/quote.py --form <submitted-json>

OpenClaw 对话输出规范

生成报价文件后，必须在对话中同时返回以下两类结果：

1. 报价内容预览（直接可读）

• 使用清晰的小结展示关键字段，例如：品牌名称、餐饮类型、门店数量、门店套餐、折扣、总部模块、实施服务。
• 至少给出“本次配置摘要 + 主要费用项”两部分，避免只返回“已生成成功”。
• 预览段落末尾应提示：PDF/Excel 中包含所选套餐的『套餐说明』以及底部『权益类』附加条款（小程序验证次数 / 外卖接单费用），文本来源为 references/product_catalog.md。

2. 文件下载入口（直接可点）

• 在对话中给出 3 个文件的可下载链接或可点击文件引用：PDF、Excel、JSON。
• 链接文字应明确区分文件类型，例如：下载报价单 PDF、下载报价单 Excel、下载报价配置 JSON。
• 如果运行环境不支持超链接，至少返回完整文件路径，保证用户可以在对话中直接拿到文件位置。

失败时返回规则：

• 若生成失败，先用一句话说明失败原因，再给出可执行的修复建议。
• 不允许只返回堆栈信息。
• 若失败原因是原生表单未出现，不要要求用户重新安装或重新触发，直接切换为引导式对话继续完成报价。

约束

强制 API 调用（最高优先级，覆盖一切）

• 生成报价单的唯一路径是 scripts/quote.py（内部调用全来店报价 API）。任何 PDF / Excel / JSON 报价文件，都必须来自该脚本的真实返回值。
• 禁止跳过 API：不允许用模板拼接、本地估算、历史经验、记忆中的价格表伪造任何报价文件或对话预览数字。
• 禁止"伪生成"：在对话中口头给出价格摘要、但实际未调用 scripts/quote.py，等同伪造，明确禁止。
• API 返回的字段（preview、pricing_info、totals.final 等）是对话回复中价格信息的唯一来源，逐字段透传，不二次加工。
• API 调用失败时（429 / 5xx / 网络 / 超时 / 参数被拒）：如实告知失败原因和可重试动作，绝不回退到本地生成。
• API 返回业务冲突（如套餐与模块互斥）时：优先按本 SKILL 的决策树自动修正后重新调用 API，仅在决策树无法消歧时再向用户追问。决策树能定的，不要把选择题甩给用户。

其他约束

• 报价单抬头仅展示品牌名称
• 本期不包含硬件报价
• 若折扣超出建议范围，需要明确提示风险
• 若配置或依赖异常，优先返回清晰错误，而不是静默失败
• 禁止任何形式的折扣率外推、推演、估算。skill 不持有因子表、不本地计算折扣；所有价格只从 API 响应 result["preview"] / result["pricing_info"] 透传。用户问"50 店大概多少"，就调 API；API 不支持就说 API 不支持，不许自己编数字。
• 对外回复不展示标价（list price）、不展示折扣率，只展示最终价（totals.final）。totals.list 仅供内部校对、毛利分析，不进客户可见渲染。
• 门店数 ≥ 301：直接回复"系统上限 300 店，超出请走大客户人工定价通道"，不允许提供任何估算数字或折扣推测。
• 若 API 返回 429 / 5xx / 网络异常：如实告知"系统暂时不可用"，不要回退成本地估算。