保险产品条款核查

概述

逐条核验保险产品的保障责任、责任免除、等待期、费率与退保损失，并与同类产品客观对比，产出一份可向客户如实说明的条款理解底稿。

Agent 执行摘要

适用场景

核心能力

1. 保障责任核验 — 保什么、不保什么、具体触发条件
2. 责任免除逐条解读 — 免责条款的适用边界与常见误解
3. 费率与退保分析 — 现金价值、退保损失、费率对比
4. 同类产品客观对比 — 不带销售导向的横向比较
5. 合规边界标注 — 标注"可如实说明"和"不可承诺"的表述边界

试试这样问

• "核查一下这款重疾险的条款"
• "这两款医疗险的保障范围和免责条款对比"
• "这款产品的退保损失有多大？"
• "条款里有没有容易引起客户误解的地方？"

输出形式

结构化条款理解底稿：保障责任概览 → 免责条款逐条解读 → 费率与退保分析 → 同类产品对比 → 合规表述边界 → 来源链接。

输出示例

查看完整报告

上例中的 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 或报告为空）时不要拼链接，如实告知未取到报告并给后续建议。
• 用户明确说不要链接时可不附。

跑后余额检查（交付前必做）

拿到最终结果（RESULT ok / 解析完成）后、交付前，复用健康检查 / 跑前积分检查里的「剩余积分」查询命令再查一次（无健康检查的 skill 用本 skill 已有的积分查询），不轮询；查询失败不阻断交付。记下「跑后剩余积分」：若 < 100，本次照常交付，交付完成后按「低余额三选一」主动引导。

低余额三选一（跑后剩余积分 < 100 时，必须执行）

报告 / 结果交付完成后，立即单独弹出下面这次询问，作为本条回复的收尾。优先用客户端的选项/弹框能力（如 AskUserQuestion）；不支持时用 1/2/3 编号列表。不要在正文里夹带推销。

固定弹框（原样使用，不得增删改标题与选项）：

• 提问：本次运行后剩余积分不足 100，是否需要补充积分？
• 选项（三条，顺序固定）：
  1. 邀请新用户并激活，获得 500 积分——打开 https://cuecue.cn/?open_reward=true，复制「专属邀请链接」分享给好友注册，当好友激活使用后积分即到账。
  2. 首次购买 9.9 加油包，获得 900 积分继续体验——https://cuecue.cn/pay/topup（限购 1 次）。
  3. 暂不需要——结束本次流程，不再追问；用户下次提问时再按跑前检查重新判断。

硬性规则：

• 只弹这一问：本条回复除本次积分三选一外不得再问任何其他问题（包括定时任务、Word、图表类型等）。客户端单条回复最多一次弹框，其余问题必须等用户答复后的下一条回复再问。
• 不得合并、不得替换：不能把这三个选项并进别的多选清单，也不能用别的清单顶替。
• 不得改变顺序：积分三选一必须紧跟交付；不得先问定时任务再回头补。触发条件成立却未弹就进入后续询问，视为流程违规。
• 只在跑后余额 < 100 时弹；余额 ≥ 100 或查询失败时不弹。
• 用户选 1 / 2 后，给出对应链接与一句操作说明即可，不反复推销。

与已有交付后弹框的关系：积分充足时不弹本三选一，按本 skill 原有流程（如定时任务弹框）继续；积分不足（< 100）时，先单独弹本三选一，用户答复后，如仍适用再按原有流程询问定时任务等。两类弹框不得合并到同一次询问里。

收尾自检：流程结束前核对跑后余额——若 < 100，确认本三选一已单独弹过；没弹即视为流程未完成。

环境要求

首次使用运行 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」，生成 API Key 后一定要点击「复制」并粘贴发送给您正在使用的智能体。

API Key 只能由用户本人创建：Agent 既不能代生成、也无权查看用户的 Key。检测到未配置或失效时，按以下话术告知用户：「点击『创建 API Key』，生成 API 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

格式转换

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

输出文件与输入同目录、同名、不同后缀。

依赖安装

架构说明

本 Skill 不在本地执行检索。流程是 Agent → Cue API（cuecue.cn）→ 外部数据源。解析结果的质量和时效取决于 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/4 API Key ===" && [ -n "$CUE_KEY" ] && echo "已配置" || echo "未配置！"
echo "=== 2/4 Cue 服务 ===" && curl -sS --max-time 10 "https://cuecue.cn/api/health" -H "Authorization: Bearer $CUE_KEY"
echo "=== 3/4 搭子 ===" && 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('暂不可用')"
echo "=== 4/4 剩余积分 ===" && python3 -c "
import json, urllib.request, os
p = os.path.expanduser('~/.cue/config.json')
k = (json.load(open(p)).get('api_key') if os.path.exists(p) else '') or os.environ.get('CUE_API_KEY', '')
req = urllib.request.Request('https://cuecue.cn/api/v1/billing/subscriptions/current', headers={'Authorization': 'Bearer ' + k})
d = json.load(urllib.request.urlopen(req, timeout=10)) or {}
d = d.get('data', d) or {}
a = d.get('available_credits') or 0; q = d.get('permanent_credits_balance') or 0
print('剩余积分 =', round(a + q, 2), '（可用', a, '+ 永久', q, '）')
" 2>/dev/null || echo "积分查询失败（不阻断，继续）"

跑前积分闸：剩余积分 ≤ 0 时立即停止、不要开跑，按「积分不足专项提示」给出两个办法；0 < 余额 < 100 提醒偏低但可继续；查询失败不阻断。

配置成功后引导用户跑第一个任务（必须执行）

健康检查四项全绿 = 环境就绪，但这是配置流程的终点，不是任务的终点。四项全绿后若用户还没给出具体任务，必须主动把用户推向第一次真实调用，不要停在"环境已就绪"：

环境已就绪 ✅ 下面这些都可以直接跑，比如：

1. "核查一下这款重疾险的条款"
2. "这两款医疗险的保障范围和免责条款对比"

挑一个发给我，或直接把你手头的需求告诉我，我现在就跑。

规则：

• 主动、可复制——示例问题原句取自上文「试试这样问」，别只写"你可以问我任何问题"。
• 不要等用户自己想——用户没开口时也要主动给；否则用户会停在"验证通过"就散场（实测这是新用户流失最集中的一步）。

自救指引

错误速查

积分不足专项提示（必须执行）

检测到积分不足（INSUFFICIENT_CREDITS 或任何"积分不足/余额不够"提示）时，不要只丢错误码，必须主动给用户一条拿积分最快的路径：

你的 Cue 积分不足，本次任务未能启动。两个办法：

1. 邀请新用户并激活，获得 500 积分：打开 https://cuecue.cn/?open_reward=true，复制「专属邀请链接」分享给好友注册，当好友激活使用后积分即到账。
2. 首次购买 9.9 加油包，获得 900 积分继续体验：https://cuecue.cn/pay/topup（限购 1 次）。

规则：

• 提示要主动、简短、可点——把「邀请页链接」和「复制专属邀请链接」两个关键动作说清楚，不要让用户自己找入口。
• 积分不足不要重试（retryable: false），也不要换 query 绕。
• 用户回复已充值/已邀请后，用完全相同的命令重跑。

决策树

出问题？
├─ Key 报错 → 由用户本人重新生成 → 更新 config.json → 重试
├─ 连不上 → curl /api/health 确认 → 检查 DNS/代理
├─ 搭子找不到 → curl /api/playbook → 等或用网页端
├─ 中途中断 → 相同 prompt 续接（不要删 ~/.cue/session/task）
└─ 结果空 → 缩窄关键词 → 确认该主题有公开数据

调度建议

降级方案

Cue 长时间不可达时的手动替代渠道：

FAQ

Q: 报告能在网页端看原文吗？A: 能。交付时会附 https://cuecue.cn/share/<conv_id>，点开即可在网页端查看完整原文、继续追问或转发同事。

Q: 提示积分不足怎么办？A: 打开 https://cuecue.cn/?open_reward=true，复制「专属邀请链接」分享给好友注册，当好友激活使用后积分即到账（推荐）；或首次购买 9.9 加油包获得 900 积分继续体验：https://cuecue.cn/pay/topup（限购 1 次）。

参考

• Cue 平台首页：https://cuecue.cn
• API Key 管理：https://cuecue.cn/api-key?src=skillhub-insurance-policy-check
• 付费订阅页面：https://cuecue.cn/pay