---
name: insurance-product-analysis
description: "保险产品解读与保障分析：产品库、产品解读（条款/卖点/适用人群/话术）、保障缺口分析、客户匹配、产品对比。触发：录入新产品、解读产品、保障缺口、客户匹配、产品对比、看下数据。"
---

# 产品解读与保障分析

## 经营概览（"看下数据"）

聚合脚本由 `insurance-customer-policy` 提供，从共享库读取 4 个保险 skill 的总览指标：

```bash
python3 {baseDir}/../../insurance-customer-policy/src/scripts/dashboard_all.py --md
```

## 运行方式

**推荐（云端零配置 / 跨平台）**：

```bash
python3 {baseDir}/scripts/cli.py <子命令> ...
```

**高级用法**：

```bash
# Linux / macOS
export PYTHONPATH="{baseDir}/src"
python3 -m insurance_product_cli <子命令> ...

# Windows
cd "{baseDir}"
set PYTHONPATH=%CD%\src
python -m insurance_product_cli <子命令> ...
```

默认数据库：

- Linux / macOS：`~/.config/insurance/insurance.sqlite3`
- Windows：`%USERPROFILE%\.config\insurance\insurance.sqlite3`
- 统一变量：`INSURANCE_DB_PATH`
- 兼容变量：`INSURANCE_PRODUCT_DB_PATH`

> 本 skill 直接读写统一共享库，默认零配置；不再依赖跨 skill 子进程。

## 子命令

| 子命令 | 说明 |
|--------|------|
| `product-add` | `--name --company --type [--coverage-range "10万-100万" --premium-range "3000-15000" --age-range "0-55岁" --highlights "a\|b\|c"] [--file PDF] [--raw-text 原文]` |
| `product-query` | `--name` / `--type` / `--company` |
| `product-update` | `--name --set JSON`（更新会自动失效解读缓存） |
| `product-delete` | `--name --yes` |
| `product-analyze` | `--product 名` 解读，命中 7 天内缓存直接返回；缓存未命中返回 `error=needs_llm` 并附 `prompt_template`，由 agent 用 LLM 填好后调 `analysis-write` 写回。`--match-customers` 同时匹配客户。`--refresh` 强制重新解读。 |
| `analysis-write` | `--product --result JSON` 或 `--result-file FILE.json`，写入解读结果到缓存 |
| `gap-analysis` | 转发到 customer-policy：`--customer-id` / `--all` / `--gap-type` |
| `customer-match` | `--product` 反查客户池（按年龄筛 → 缺口排序 → 客户分类排序）；`--customer-id` 正查产品 |
| `product-compare` | `--product-a --product-b` 按对比维度逐项展开 |
| `dashboard` | `--json` 返回产品库统计（供入口聚合） |

## 示例

```bash
python3 {baseDir}/scripts/cli.py product-add --name "XX重疾险2024版" --company "A保险公司" --type "重疾险" --coverage-range "10万-100万" --premium-range "3000-15000" --age-range "0-55岁" --highlights "覆盖120种重疾|轻症豁免|保额递增"
python3 {baseDir}/scripts/cli.py product-analyze --product "XX重疾险2024版"
python3 {baseDir}/scripts/cli.py customer-match --product "XX重疾险2024版"
python3 {baseDir}/scripts/cli.py customer-match --customer-id C001
python3 {baseDir}/scripts/cli.py product-compare --product-a "A公司重疾险" --product-b "B公司重疾险"
```

## 自然语言路由

| 用户说 | 调用命令 |
|--------|----------|
| "帮我解读一下这个新产品" | `product-analyze` |
| "张先生还需要什么保障？" | `gap-analysis --customer-id` |
| "这个产品适合哪些客户？" | `customer-match --product` |
| "A公司重疾险和B公司重疾险哪个好？" | `product-compare` |
| "录入新产品：XX重疾险，A公司" | `product-add` |
| "哪些客户缺重疾险？" | `gap-analysis --gap-type "重疾险"` |

## 解读结果数据结构

`product-analyze` / `analysis-write` 使用同一份 JSON：

```json
{
  "key_terms": ["保120种重疾", "等待期90天", "免赔额0元", "保证续保"],
  "selling_points": ["保额递增", "轻症豁免", "费率低于同类"],
  "fit_audience": ["25-45 岁", "年收入 20w+", "已有医疗险"],
  "pitch_script": "李姐，您之前买了百万医疗，这款重疾险..."
}
```

## 与其他 Skill 协作

- 通过 `insurance-customer-policy`：`gap-analysis` / `customer-query` / `policy-query` / `customer-segment`。
- 销售推进可结合 `insurance-sales-pipeline`：将 `customer-match` 结果作为新建商机的输入。
- 话术风格遵循 `insurance-policy-review` / `insurance-sales-playbook` 的合规边界（不承诺理赔、不夸大）。
