ClawHub

Issue Analysis Agent

Other

自动分析客服问题Excel，生成含趋势对比的周报，支持HTML可视化、多图表展示及自动告警并上传公网链接。

Install

openclaw skills install issue-analysis-agent

📊 客服问题周报技能

技能名称: issue-analysis-agent
版本: v2.0.0
作者: 老六 🥷
创建时间: 2026-03-23
更新时间: 2026-03-23

📋 技能描述

自动化分析客服问题收集表（Excel），生成可视化分析报告，支持每周数据更新和趋势对比。

团队协作模式：

  • 🐛 找茬 - 数据分析（读取 Excel、统计分析、未解问题人统计）
  • 🎨 画师 - 报告生成（HTML 可视化、图表绘制、COS 上传）

🎯 核心功能

  1. 数据读取 - 自动解析 Excel 文件，识别字段
  2. 统计分析 - 问题总数、解决率、趋势分析
  3. TOP5 排行 - 反馈人、解决人、未解问题人等
  4. 可视化报告 - HTML 交互式报告（Chart.js，8 个图表）
  5. COS 上传 - 自动生成公网访问链接
  6. 周报对比 - 与上周数据对比，分析趋势
  7. 自动告警 - 解决率<80%、单周>50 个等阈值告警

📥 输入

  • 文件格式: .xlsx Excel 文件
  • 必需字段:
    • 问题描述
    • 提交日期/所属周
    • 所属平台
    • 问题模块
    • 反馈人
    • 解决者
    • 解决状态（已解决/待解决等）
    • 问题类型（Bug/咨询/需求等）

📤 输出

  1. 结构化数据 - analysis_data_latest.json
  2. 文字总结 - analysis_summary.md
  3. 可视化报告 - report_cn_latest.html（HTML 交互式，8 个图表）
  4. COS 链接 - 公网访问地址

🚀 使用方法

方式 1：完整流程（推荐）

cd /Users/master.yu/.openclaw/workspace/skills/issue-analysis-agent
python3 weekly_report.py /path/to/issue_data.xlsx

方式 2：分步执行

# 步骤 1: 分析数据（找茬 🐛）
python3 analyze.py /path/to/issue_data.xlsx

# 步骤 2: 生成报告（画师 🎨）
python3 generate_report.py analysis_data_latest.json report_cn.html

# 步骤 3: 上传 COS（画师 🎨）
python3 upload_cos.py report_cn.html reports/issue_analysis/report_cn_latest.html

方式 3：Agent 调用

任务：分析本周客服问题数据
技能：issue-analysis-agent
输入：issue_data_week_12.xlsx
输出：可视化报告 + COS 链接

📊 报告内容

8 大图表

  1. 📈 每周新增问题趋势（折线图）
  2. 🏷️ 问题类型分布（饼图）
  3. 💻 平台问题分布 TOP5（横向柱状图）
  4. 👤 反馈人 TOP5（柱状图）
  5. ✅ 解决人 TOP5（柱状图）
  6. ⚠️ 未解问题人 TOP5（柱状图）- 解决者中未解决问题最多的
  7. ⚠️ 未解决问题模块 TOP10（表格）

核心指标

  • 问题总数
  • 已解决数/解决率
  • 未解决数
  • 环比变化

自动告警

  • 🔴 解决率 <80%
  • 🔴 单周新增 >50 个
  • 🟡 Bug 占比 >60%
  • 🟡 卖家端占比 >60%

🔄 每周更新流程

固定流程（每周一）

  1. 接收数据 (10:00)

    • 用户上传最新 Excel 文件
    • 保存到 issue_data_week_XX.xlsx

  2. 数据分析 (10:00-10:30) 🐛 找茬

    • 读取 Excel
    • 统计分析
    • 对比上周

  3. 生成报告 (10:30-11:00) 🎨 画师

    • HTML 报告生成
    • 图表绘制
    • 数据验证

  4. 上传 COS (11:00-11:10) 🎨 画师

    • 上传文件
    • 设置权限
    • 生成链接

  5. 推送通知 (11:10-11:20)

    • 发送报告链接
    • 关键发现摘要
    • 预警信息

  6. 归档历史 (11:20-11:30)

    • 保存本周报告
    • 更新索引
    • 清理临时文件

📁 文件结构

issue-analysis-agent/
├── SKILL.md              # 技能说明
├── README.md             # 使用说明
├── config.json           # 配置项
├── weekly_report.py      # 主流程脚本
├── analyze.py            # 数据分析（找茬 🐛）
├── generate_report.py    # 报告生成（画师 🎨）
├── upload_cos.py         # COS 上传（画师 🎨）
├── output/               # 输出目录
│   ├── analysis_data.json
│   ├── analysis_summary.md
│   └── report_cn.html
└── reports/              # 历史报告归档
    ├── week_10/
    ├── week_11/
    └── week_12/

🛠️ 技术依赖

# Python 依赖
pip3 install openpyxl qcloud_cos

# Node.js 依赖（可选）
npm install chart.js

📝 更新日志

v2.0.0 (2026-03-23)

  • ✅ 团队协作模式（找茬 + 画师）
  • ✅ 新增未解问题人 TOP5 统计
  • ✅ 修复字段名不匹配问题
  • ✅ 优化 COS 上传响应头
  • ✅ 自动告警功能

v1.0.0 (2026-03-23)

  • ✅ 初始版本
  • ✅ Excel 数据读取
  • ✅ 统计分析
  • ✅ HTML 报告生成
  • ✅ COS 上传

📞 负责人

  • 技能开发: 老六 🥷
  • 数据分析: 找茬 🐛
  • 报告制作: 画师 🎨
  • 技能维护: 客服 📞

最后更新：2026-03-23