customer-product-penetration

name	customer-product-penetration
description	分析客户或客群的产品持有率、渗透结构和覆盖深度，识别交叉销售机会和单产品依赖风险，支撑产品营销策略制定。

客户产品渗透分析助手

1. 业务问题

银行零售业务收入和客户粘性与产品渗透深度高度相关。多产品客户流失率低、贡献度高，但实际经营中大量客户仅持有单一产品，交叉销售潜力未被充分挖掘。需要系统分析产品渗透率和持有结构，识别交叉销售机会和单产品依赖风险。

2. 适用场景

• 客群产品渗透率现状分析与对标
• 识别高价值但产品持有单一的客户
• 营销活动前筛选交叉销售目标客户
• 产品到期续接策略制定
• 分行/支行产品渗透率横向对比
• 新产品上线后渗透率追踪

3. 输入

输入项	说明	是否必填
客户列表	待分析的客户编号集合	必填
产品持有明细	每位客户当前持有的产品清单	必填
产品分类标准	产品归类规则（默认五大类）	选填
客户价值层级	分层结果（如有）	选填
产品到期信息	理财/存款/贷款到期日	选填
历史持有记录	产品持有变化历史（如有）	选填
机构维度	分行/支行/网点归属	选填

4. 输出

• 渗透率统计：各产品类别在目标客群中的渗透率
• 持有结构分布：客户按持有产品数量分组的占比分布
• 交叉销售机会：高价值但低渗透客户清单及推荐产品
• 单产品风险客户：仅持有单一产品的客户识别
• 产品组合分析：常见产品组合模式及关联关系
• 到期提醒：近期产品到期客户及续接建议

5. 默认分析维度

• 存款类：活期存款、定期存款、结构性存款、大额存单
• 理财产品类：银行理财、代销基金、代销保险、贵金属
• 贷款类：住房贷款、消费贷款、经营贷款、信用卡
• 电子渠道类：手机银行、网上银行、微信银行
• 其他服务类：代发工资、代扣代缴、安全工具（U盾/短信验证）

6. 默认分析框架

1. 产品归类：将客户持有产品按五大类归类汇总
2. 渗透率计算：调用 bank-calc-utils 计算各产品类别渗透率
3. 持有深度分析：统计客户持有产品类别数分布（1类/2类/3类/4类/5类）
4. 交叉销售识别：
   • 高价值 + 持有类别数<=2 → 优先交叉销售对象
   • 分析常见产品组合，推荐缺失产品
5. 风险识别：标记仅持有单一产品的客户为粘性风险客户
6. 到期机会：汇总近30/60/90天到期产品，生成续接机会清单
7. 结论输出：先给出整体渗透率结论和关键发现，再展示明细

7. 安全边界

• 不编造数据；不夸大结论；缺失信息标注"未获取"或"待核实"
• 不替代正式审批、正式风控、正式合规、正式报送、正式处置、正式责任认定、正式管理决策
• 不替代营销准入判断、授信审批决策、客户适当性评估
• 产品推荐仅基于渗透率分析，不构成客户适当性评估
• 交叉销售建议需结合客户风险偏好和适当性要求后方可执行

8. 上游依赖

• bank-calc-utils：渗透率计算、分布统计、占比分析等数值运算

9. 可联动下游 Skills

• customer-opportunity-list-generation：将交叉销售机会和到期续接机会纳入经营机会清单

使用示例

示例 1: 基本使用

# 调用 skill
result = run_skill({
    "param1": "value1",
    "param2": "value2"
})

示例 2: 命令行使用

python scripts/run_skill.py --input data.json