众安车险自助投保

SKILL.md

---
name: 车险投保skill
description: 众安车险投保 — 车辆信息 → 报价 → 确认核保 → 支付 → 出单。
version: 1.0.0
argument-hint: "[车牌号]"
---

# 众安车险投保skill

---

## 服务域名

> ⚠️ 使用前将全文所有 `<gateway域名>` 替换为如下取值。

**gateway 域名**：`car.zhongan.com`

所有接口（鉴权、报价、核保、出单查询）均走此单一域名，无其他依赖服务。

---

## 固定配置（首次使用必填）

> ⚠️ **占位符护栏**：以下字段若为 `xx`，视为**未配置**。启动时逐一检查，未配置则立即停止向用户索取真实值，**严禁猜测**。

- **car_api_key**：`xx`（首次获取后写入，当日有效）
- **手机号**：`xx`（首次使用后写入）
- **车主姓名**：`xx`（首次使用后写入）
- **车主证件号**：`xx`（首次使用后写入）
- **投保人/被保人**：默认与车主相同

---

## 支持的能力

| 能力 | 说明 | 参考文件 |
|------|------|---------|
| 验证码登录 | 手机号+验证码获取 car_api_key | `auth.md` |
| 快速报价 | 一键完成绑车+询价+报价 | `quote.md` |
| 方案调整 | 修改险种、保额、不计免赔 | `quote.md` |
| 核保+支付 | 自动完成核保并获取支付链接 | `proposal.md` |
| 出单查询 | 支付后查询保单号 | `proposal.md` |

---

## 主流程概览

```
Step 0：检查 car_api_key
    ├─ $CAR_API_KEY 存在 → 继续
    └─ 不存在或过期（401）→ 发验证码 → 用户填验证码 → 获取 car_api_key
    详见 auth.md

Step 1：占位符校验
    检查固定配置中手机号、车主姓名、车主证件号是否已填写
    详见 auth.md

Step 2：快速报价（核心）
    POST <gateway域名>/api/quickInsure/quickQuote
    一键完成绑车+填表+询价+报价
    详见 quote.md

Step 3：用户确认/调整方案
    详见 quote.md

Step 4：核保+获取支付链接
    POST <gateway域名>/api/quickInsure/quickConfirmAndPay
    详见 proposal.md

Step 5：打开支付页面
    Chrome DevTools MCP 打开 zaPayUrl
    详见 proposal.md

Step 6：出单结果查询
    POST <gateway域名>/api/quickInsure/getCreatePolicy
    详见 proposal.md
```

---

## 通用规则

详见 `auth.md`「通用规则」章节。核心要点：

1. **静默执行**：调用接口时不在对话中打印请求参数、响应原文；仅输出面向用户的结论或下一步提示；出错时只展示简洁的错误描述，不暴露原始报文。
2. **鉴权**：每次请求带 `car_api_key: $CAR_API_KEY`，401 时重新走验证码流程
2. **上下文保持**：`vehicleNo`、`insureFlowCode`、投保人信息对话中缓存
3. **每次操作实时调接口**
4. **接口传参按文档**，禁止猜测字段含义
5. **错误重试**：同一报错每阶段最多 3 次；接口繁忙时直接展示返回的提示文案，不重试
6. **客服引导**：接口报错无法自动恢复、或流程阻塞无法继续时，告知用户可联系专属客服，并询问"是否在浏览器中打开客服链接？"，仅在用户确认后才调用 Chrome DevTools MCP 打开客服页面
7. **终止性错误**：`P11002`、`已投保` 立即终止
8. **用户指定车辆不得替换**

---

## 用户数据交互汇总

| 环节 | 用户需提供              | 备注 |
|------|--------------------|------|
| 首次登录 | 手机号 + 验证码          | 获取 car_api_key，写入配置 |
| 快速报价（已绑车） | 车牌号                | 投保地后端自动推断 |
| 快速报价（未绑车） | 车牌号                | 车主信息自动从配置获取 |
| 车五项补全 | VIN/发动机号/注册日期/品牌型号 | 按 `missingFiveInfoFields` 引导 |
| 确认方案 | 回复「确认投保」或调整        | — |
| 支付 | 无（点击支付链接）          | 浏览器内完成 |

**最少交互路径**（已绑车 + 配置已填写）：车牌 → 确认核保 → 支付，共 **2 轮对话**。

---

## 场景索引

| Step | 场景 | 关键接口 | 参考文件 |
|------|------|---------|---------|
| 0 | 获取 car_api_key | `POST /api/quickInsure/open/auth/sendCode` + `verifyCode` | `auth.md` |
| 1 | 占位符校验 | — | `auth.md` |
| 2 | 快速报价 | `POST /api/quickInsure/quickQuote` | `quote.md` |
| 3 | 确认/调整方案 | — | `quote.md` |
| 4 | 核保+支付 | `POST /api/quickInsure/quickConfirmAndPay` | `proposal.md` |
| 5 | 出单查询 | `POST /api/quickInsure/getCreatePolicy` | `proposal.md` |