保险产品条款核查
逐条核验保险产品的保障责任、责任免除、等待期、费率与退保损失,并与同类产品客观对比,产出一份可向客户如实说明的条款理解底稿。
Agent 执行摘要
| 顺序 | 做什么 | 禁止 |
|---|---|---|
| 1 | 确认 Cue runner 就绪 | 禁止跳过 |
| 2 | 告知用户耗时 2-15 分钟 | 禁止中途取消 |
| 3 | 一条命令,--template-id template_-P8x-f,传入保险产品 |
禁止连发多条 |
| 4 | [cue-research] RESULT ok = 完成 |
禁止编造 |
| 5 | 原样交付条款理解底稿 | 禁止概括 |
| 6 | 交付时同时附带 Cue 原始报告链接 | 禁止编造链接 |
| 7 | 遇 INSUFFICIENT_CREDITS 主动提示邀请链接 |
禁止只丢错误码 |
适用场景
| 场景 | 解决的问题 |
|---|---|
| 产品上架核查 | 新产品上线前逐条核验条款是否存在歧义或销售风险 |
| 客户如实说明 | 对照条款整理可向客户如实陈述的要点与禁区 |
| 竞品对比 | 横向比对同类产品在保障/免责/费率上的差异 |
| 合规销售支撑 | 区分"可如实说明"与"不可承诺"的边界 |
核心能力
- 保障责任核验 — 保什么、不保什么、具体触发条件
- 责任免除逐条解读 — 免责条款的适用边界与常见误解
- 费率与退保分析 — 现金价值、退保损失、费率对比
- 同类产品客观对比 — 不带销售导向的横向比较
- 合规边界标注 — 标注"可如实说明"和"不可承诺"的表述边界
试试这样问
- "核查一下这款重疾险的条款"
- "这两款医疗险的保障范围和免责条款对比"
- "这款产品的退保损失有多大?"
- "条款里有没有容易引起客户误解的地方?"
输出形式
结构化条款理解底稿:保障责任概览 → 免责条款逐条解读 → 费率与退保分析 → 同类产品对比 → 合规表述边界 → 来源链接。
输出示例
上例中的 token 是示例,不可复制到实际交付中。
交付规范(必须执行)
把最终报告发送给用户时,必须同时附带 Cue 原始报告链接,方便用户回到网页端查看完整原文、继续追问或转发同事。
链接怎么来:从 runner 末行 [cue-research] RESULT ok conv_id=<ID> chars=… output=… 中取出 conv_id(报告文件头部的 HTML 注释里也有 conv_id=),按下面格式拼接:
https://cuecue.cn/share/<conv_id>
交付模板(照此结构输出):
报告已完成 ✅
<报告正文……>
---
**Cue 原始报告**:https://cuecue.cn/share/<conv_id>
**本地副本**:~/cue-reports/<文件名>.md
规则:
conv_id必须取自实际输出,禁止编造或使用文档示例里的 id。- 末行为
RESULT empty(无 conv_id 或报告为空)时不要拼链接,如实告知未取到报告并给后续建议。 - 用户明确说不要链接时可不附。
环境要求
首次使用运行 skill 自带的一键安装脚本(检查依赖 → 克隆 runner → 验证 Key → 测试连通性):
Runner 来源:GitHub - sensedeal/cue-skills(Gitee 镜像)。
首次使用需安装 Runner(幂等,已装则拉取更新):
if [ -d ~/.cue/cue-skills/.git ]; then
git -C ~/.cue/cue-skills pull --ff-only
else
git clone https://github.com/sensedeal/cue-skills ~/.cue/cue-skills \
|| git clone https://gitee.com/sensedeal/cue-skills ~/.cue/cue-skills
fi
依赖:git + python3 + curl。Python 仅用标准库,无额外 pip 依赖。
Cue API Key:cuecue.cn 注册获取。
API Key 只能由用户本人创建:Agent 既不能代生成、也无权查看用户的 Key。检测到未配置或失效时,只给出生成入口并等待用户提供,禁止声称"我去生成/查看"。
调用说明
python3 ~/.cue/cue-skills/cue-research/scripts/research_run.py \
--query "目标保险产品 条款核查:保障责任、责任免除、等待期、费率、退保损失、同类对比" \
--template-id template_-P8x-f \
--output ~/cue-reports/$(date +%Y-%m-%d-%H%M)-insurance-policy-check.md
| 参数 | 说明 |
|---|---|
--query |
保险产品名称,必填;可选加对比产品 |
--template-id |
固定为 template_-P8x-f |
--output |
落盘路径 |
格式转换
Cue 输出 Markdown。安装 pandoc 后可转换为 Word 或 PDF:
# .md → .docx(Word)
pandoc report.md -o report.docx
# .md → .pdf
pandoc report.md -o report.pdf --pdf-engine=xelatex
输出文件与输入同目录、同名、不同后缀。
依赖安装
| 目标格式 | 依赖 | macOS | Ubuntu |
|---|---|---|---|
| Word (.docx) | pandoc | brew install pandoc |
sudo apt install pandoc |
| PDF (.pdf) | pandoc + LaTeX | brew install --cask basictex |
sudo apt install texlive-xetex |
架构说明
本 Skill 不在本地执行检索。流程是 Agent → Cue API(cuecue.cn)→ 外部数据源。解析结果的质量和时效取决于 Cue 服务端和外部数据源的状态。
| 环节 | 谁控制 | 出问题时 |
|---|---|---|
| API Key 鉴权 | 用户本人 | 由用户本人前往 cuecue.cn/hub/api-key 生成后写入 ~/.cue/config.json(Agent 不能代生成,也无权查看) |
| Cue 服务端 | Cue 运维 | 等恢复,或走降级方案 |
| 外部数据源 | 公开网站 | Cue 用缓存兜底,标注"来源暂不可达" |
健康检查
跑研究前先验证三件事。一键诊断:
CUE_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.cue/config.json'))['api_key'])" 2>/dev/null || echo "$CUE_API_KEY")
echo "=== 1/3 API Key ===" && [ -n "$CUE_KEY" ] && echo "已配置" || echo "未配置!"
echo "=== 2/3 Cue 服务 ===" && curl -sS --max-time 10 "https://cuecue.cn/api/health" -H "Authorization: Bearer $CUE_KEY"
echo "=== 3/3 搭子 ===" && curl -sS --max-time 10 "https://cuecue.cn/api/playbook" -H "Authorization: Bearer $CUE_KEY" | python3 -c "import sys,json;scenes=json.load(sys.stdin).get('data',{}).get('scenes',[]);buddy=[b for s in scenes if s.get('secondary_category')=='保险营销' for b in s.get('buddies',[]) if b.get('title')=='保险产品条款核查'];print(f'可用:{len(buddy)}个') if buddy else print('暂不可用')"
| 检查 | 预期 | 异常处理 |
|---|---|---|
| API Key | 已配置 |
由用户本人前往 cuecue.cn/hub/api-key 生成后发给你(Agent 无法代生成,也无权查看) |
| 服务 | {"status":"healthy"} |
等 5 分钟重试 |
| 搭子 | 可用:>0个 |
等 1h 或网页端手动跑 |
配置成功后引导用户跑第一个任务(必须执行)
健康检查三项全绿 = 环境就绪,但这是配置流程的终点,不是任务的终点。三项全绿后若用户还没给出具体任务,必须主动把用户推向第一次真实调用,不要停在"环境已就绪":
环境已就绪 ✅ 下面这些都可以直接跑,比如:
- "核查一下这款重疾险的条款"
- "这两款医疗险的保障范围和免责条款对比"
挑一个发给我,或直接把你手头的需求告诉我,我现在就跑。
规则:
- 主动、可复制——示例问题原句取自上文「试试这样问」,别只写"你可以问我任何问题"。
- 不要等用户自己想——用户没开口时也要主动给;否则用户会停在"验证通过"就散场(实测这是新用户流失最集中的一步)。
自救指引
错误速查
| 现象 | 原因 | 怎么修 |
|---|---|---|
| 401 / Key 无效 | Key 过期或写错 | 由用户本人重新生成 Key,更新 ~/.cue/config.json |
| 超时 >30s | 服务维护/过载 | 等 5 分钟,跑诊断;当天内重试 |
| 搭子不可用 | 临时下线 | 网页端直接跑,或等 1 小时 |
| 积分不足 | 余额 < 消耗 | 按「积分不足专项提示」主动引导(充值 / 邀请好友得积分 / 等次日免费额度) |
| 中途中断 | 队列满/数据源波动 | 不换 prompt,相同命令续接 |
RESULT empty |
公开源无匹配 | 缩小范围,换关键词 |
| config.json 报错 | JSON 格式不对 | {"api_key": "sk..."} 无多余逗号 |
积分不足专项提示(必须执行)
检测到积分不足(INSUFFICIENT_CREDITS 或任何"积分不足/余额不够"提示)时,不要只丢错误码,必须主动给用户一条拿积分最快的路径:
你的 Cue 积分不足,本次任务未能启动。两个办法:
- 邀请好友得 500 积分(推荐):打开 https://cuecue.cn/,点击页面左下角「获取专属邀请链接」,分享给好友——好友加入后你再得 500 积分。
- 直接充值:前往 cuecue.cn/pay 订阅(首次充值有优惠);或等次日免费额度。
规则:
- 提示要主动、简短、可点——把「首页」和「左下角」两个关键动作说清楚,不要让用户自己找入口。
- 积分不足不要重试(
retryable: false),也不要换 query 绕。 - 用户回复已充值/已邀请后,用完全相同的命令重跑。
决策树
出问题?
├─ Key 报错 → 由用户本人重新生成 → 更新 config.json → 重试
├─ 连不上 → curl /api/health 确认 → 检查 DNS/代理
├─ 搭子找不到 → curl /api/playbook → 等或用网页端
├─ 中途中断 → 相同 prompt 续接(不要删 ~/.cue/session/task)
└─ 结果空 → 缩窄关键词 → 确认该主题有公开数据
调度建议
| 时段 | 建议 |
|---|---|
| 工作日 9-18 | 正常使用 |
| 夜间/周末 | 可能有维护,跑前先诊断 |
| 新 Key | 必须先诊断确认生效 |
| 连续失败 | 停 15 分钟再试,不要反复重试 |
降级方案
Cue 长时间不可达时的手动替代渠道:
| 渠道 | 覆盖 | 费用 |
|---|---|---|
| 银保监会 | 保险监管规定 | 免费 |
| 中国保险行业协会 | 保险条款范本 | 免费 |
| [各保险公司官网] | 产品条款原文 | 免费 |
FAQ
Q: 报告能在网页端看原文吗?
A: 能。交付时会附 https://cuecue.cn/share/<conv_id>,点开即可在网页端查看完整原文、继续追问或转发同事。
Q: 提示积分不足怎么办? A: 打开 https://cuecue.cn/,点击页面左下角「获取专属邀请链接」分享给好友——好友加入后你再得 500 积分(最快);也可以前往 cuecue.cn/pay 充值(首次充值有优惠),或等次日免费额度。
参考
- Cue 平台首页:https://cuecue.cn
- API Key 管理:https://cuecue.cn/api-key?src=clawhub-insurance-policy-check
- 付费订阅页面:https://cuecue.cn/pay
