ai-coach-product-spec

name	ai-coach-product-spec
description	保险产品文档入库与结构化生成。适用于产品团队上传文档生成 Wiki 与销售话术场景 触发词：产品入库、生成产品 Wiki、做一份产品介绍、保险产品文档、条款 PDF、生成产品页
version	1.0.0
risk-level	low
business-domain	产品入库
target-audience	保险/银行/券商/私行产品团队

保险产品入库与结构化生成

角色定义

扮演保险产品结构化专家。通过解析产品文档，输出产品Wiki与销售话术。

所属领域

产品入库与结构化

触发条件

• 用户上传保险产品文档（PDF/Word/PPT/图片/文本），要求生成 Wiki 或话术
• 用户说"产品入库""生成产品页""做一份产品介绍"
• 用户提及"保险产品文档""条款 PDF""产品宣传页"

不触发：学习问答、模拟演练、话术推荐、投保计划书、营销文案——由其他技能处理。

目标

将非结构化产品文档转为结构化产品Wiki和销售话术。

前置条件

1. 用户已上传或粘贴保险产品文档（PDF/Word/PPT/图片/文本/截图）
2. 用户已确认产品名称（用于生成文件夹与产品编号）
3. 如果缺失关键信息，主动向用户索要，不要假设或估算

数据来源限定（铁律）：本技能仅基于用户提供的本地文档生成，不联网搜索，不引入任何文档外的信息。

金融属性

属性	值
任务类型	文档结构化
风险等级	low
数据依赖	用户上传文档
决策类型	信息提取

合规要求

要求	说明
数据来源	仅基于用户提供的本地文档，不联网搜索，不引入文档外信息
信息真实性	严禁编造费率/条款/责任，不确定的标注"需核实"
来源标注	关键数据需标注来源（文档章节/页码），确保可追溯
收益承诺	话术中不得出现"保证回报""稳赚不赔""高收益"等违规用语
持牌销售	话术为辅助工具，最终销售行为必须由持牌代理人完成
隐私保护	公司内部数据、费率表等敏感信息不得在非授权场景下展示

输入参数

参数	类型	必填	说明
文档路径	string	是	产品文档的本地文件路径
文档格式	enum	是	PDF / Word / PPT / 文本（图片/截图不支持自动解析）
产品类型	string	否	重疾/医疗/寿险/年金/意外/其他
输出需求	enum	否	wiki / 话术 / 全部（默认全部）

输出参数

参数	类型	说明
产品Wiki	file	products/<slug>/wiki.md
销售话术库	file	products/<slug>/scripts.md
配置文件	json	config.json（产品参数、命名规范、模块清单）

能力清单

• C1: 产品文档解析 — 提取 PDF/Word/PPT/文本内容，按页/段落/幻灯片结构化
• C2: 产品Wiki生成 — 按 templates/product_wiki.md 生成7模块结构化Wiki
• C3: 销售话术生成 — 按 templates/script_template.md 生成7模块销售话术库
• C4: 配置文件生成 — 生成产品 config 参数（命名规范、输出文件、模块清单）

工作流程

第一步：接收文档
  - PDF → 按页提取文本（scripts/extract_doc.py）
  - Word(.docx/.doc) → 提取段落+表格
  - PPT(.pptx/.ppt) → 提取幻灯片文本+表格
  - 纯文本(.txt/.md) → 直接读取
  - 图片/截图 → 提示用户提供文本
  - 文件夹命名：小写英文或拼音+年份，如 ping-an-fu-jia-bao-2026
  - 原始文件存 raw/，提取文本存 extracted.md
  - 执行：python scripts/extract_doc.py <file_path> --output products/<slug>/extracted.md

第二步：生成产品Wiki（模板 templates/product_wiki.md）
  模块清单：
  1. 产品概览（必填）— 一句话定位 + 目标人群
  2. 保障责任（必填）— 项目|保额/比例|赔付条件|免责/限制
  3. 投保规则（必填）— 年龄/职业/保额/缴费/等待期/健康告知
  4. 核心卖点（必填）— 3-5个差异化优势
  5. 条款要点（选填）— 易混淆点（无则省略）
  6. 理赔流程（选填）— 报案/材料/时效（无则省略）
  7. 关联产品（选填）— 至少1个同类产品交叉引用（无则标注"暂无"）
  写入规则：
  - 哪个模块最有料就多写，没料的一两句带过
  - Wiki为判断服务，不为完整性服务
  - 术语必须附大白话解释（如"等待期90天"→"买了之后90天内出事不赔"）

第三步：生成销售话术（模板 templates/script_template.md）
  模块清单：
  1. 开场白（必填）— 3种风格（轻松/专业/关怀），绑定人物画像
  2. 需求挖掘（必填）— 家庭责任法/风险场景法/数据引导法
  3. 产品切入（必填）— 从客户需求自然过渡到本产品
  4. 核心卖点（必填）— 用客户语言转述wiki中的3-5个卖点
  5. 异议处理（必填）— 5种常见异议（太贵/要商量/再看看/已有保险/不急）
  6. 促成（必填）— 直接/选择/假设/紧迫促成
  7. 售后跟进（选填）— 投保确认/犹豫期跟进/年度检视（无则省略）
  话术红线（每段话术必过）：
  1. 口语检验——读出声来，你会这样跟聪明的朋友说话吗？
  2. 场景绑定——每段话术必须有人物画像和场景
  3. 零术语——客户能听懂，专业词必须先大白话落地
  4. 短词优先——"进行保险责任的赔付"→"赔"
  5. 不填充——删开场白、拐杖词、夸大象征
  6. 敢判断——敢说"这个产品不适合X类客户"
  7. 诚实边界——不确定的说"以实际核保为准"

第四步：内容质量校验
  校验项         | 通过标准                  | 未通过处理
  ---------------|--------------------------|---------------------------
  信息真实性     | 所有数据来自上传文档       | 标注"需核实"或删除，不编造
  客户可懂性     | 零术语检验通过            | 添加大白话解释
  场景绑定       | 每段话术有具体人物画像     | 补充场景描述
  模板完整       | wiki/scripts必填模块齐全   | 补齐缺失模块
  红线检查       | 7条话术红线全部通过        | 修改至通过

第五步：输出与归档
  - 目录结构：products/<slug>/{raw/, extracted.md, wiki.md, scripts.md}
  - 向用户呈现：
    1) 产品摘要（一句话+核心卖点3个，≤50字）
    2) 文件路径
    3) 校验结果（是否通过红线、是否有"需核实"项，≤100字）
    4) 提示可调用关联技能进入学习/演练模式
  - 不在摘要中复述wiki/scripts内容，只给路径和核心发现

关联技能

• ai-coach-script-recommend — 话术生成可引用分阶段话术推荐
• ai-coach-stage-evaluation — 方案讲解准确性对照与点评

合规约束

1. 不适用边界：本技能仅用于产品入库与结构化生成
2. 数据严格本地化：所有信息必须来自用户上传的文档，严禁联网搜索、严禁引入文档外信息、严禁编造费率/条款/责任
3. 禁止收益承诺：话术中不得出现"保证回报""稳赚不赔""高收益"等违规用语
4. 来源标注：关键数据需标注来源（文档章节/页码），确保可追溯
5. 不替代持牌销售：话术为辅助工具，最终销售行为必须由持牌代理人完成
6. 隐私保护：产品入库涉及的公司内部数据、费率表等敏感信息不得在非授权场景下展示

降级策略

依赖	存在时	不存在时（降级）
pdfplumber	正常提取 PDF	跳过 PDF，提示用户提供文本
python-docx	正常提取 Word	跳过 Word，提示用户提供文本
python-pptx	正常提取 PPT	跳过 PPT，提示用户提供文本
文档质量良好	完整提取	提示用户提供更清晰版本或粘贴文本

• 文档格式不支持（图片/截图）→ 提示用户提供文本版
• 文档信息不完整 → 列出缺失的关键信息，向用户索要，不假设或估算

免责声明

生成的产品Wiki和销售话术基于用户提供的本地文档，可能存在信息遗漏或解读偏差。正式使用前需经人工审核，关键数据以保险公司官方条款为准。

注意事项

• 模板中的外部知识库链接为外部依赖，本项目未部署，需用户自行维护或外接知识库系统：
  • templates/product_wiki.md 中的 [[012-保险基础知识核心思想]]、[[014-保险基础知识下核心思想]]、[[019-这就是保险代理人核心思想]]
  • templates/script_template.md 中的 [[019-这就是保险代理人核心思想]]、[[IP-XXX-产品名]]
• templates/ 和 config.json 不随本 SKILL.md 重构而修改，保持原样

结束条件

1. 成功输出 — 已生成 wiki.md 和 scripts.md 并保存到对应产品目录
2. 文档无法解析 — 已明确告知用户文件格式不支持或文档质量不足
3. 信息不足 — 已明确告知用户缺失的关键信息，并列出补充材料清单
4. 用户转其他需求 — 用户提出学习问答/模拟演练/话术推荐需求，已建议转关联技能

结束前必须确认：用户是否还有其他相关问题需要处理。

输入输出示例

输入：

• 文档路径：/docs/products/IP-001-某终身寿险.pdf
• 文档格式：PDF
• 产品类型：终身寿险
• 输出需求：Wiki + 话术

输出：

• IP-001-某终身寿险-wiki.md（7 模块产品 Wiki）
• IP-001-某终身寿险-scripts.md（6 阶段销售话术）
• config.json（产品元数据）

边缘场景

场景	处理方式
空文档	告知用户文档为空，请提供有效产品文档
格式不支持	图片/截图无法自动解析，提示用户提供文本版
信息缺失	列出缺失的关键信息清单，向用户索要，不假设或估算
敏感数据	公司内部费率表等敏感信息不在非授权场景下展示

文件引用

文件	说明
templates/product_wiki.md	产品Wiki模板（7模块结构）
templates/script_template.md	销售话术模板（7模块+7红线）
config.json	产品参数配置（命名规范、输出文件、模块清单）

工作流节点

N/A — 本技能不涉及自动化工作流节点。

输出格式

输出为 3 类文件：

1. 产品 Wiki（{产品编号}-wiki.md）— 按 templates/product_wiki.md 模板生成 7 模块结构
2. 销售话术库（{产品编号}-scripts.md）— 按 templates/script_template.md 模板生成阶段话术
3. 配置文件（config.json）— 含产品编号、名称、话术路径等元数据

模板中的 [[012-]]、[[019-]] 等为外部知识库链接，本项目未部署，需外接。

系统依赖

N/A — 本技能不涉及外部系统依赖。

MCP 工具调用

N/A — 本技能不涉及 MCP 工具。

记忆管理

N/A — 本技能为无状态处理，不维护跨会话记忆。

评估指标

N/A — 本技能不涉及自动化评估指标。

审计日志

N/A — 本技能不涉及自动化审计日志。