📊 客服问题周报技能
技能名称: issue-analysis-agent
版本: v2.0.0
作者: 老六 🥷
创建时间: 2026-03-23
更新时间: 2026-03-23
📋 技能描述
自动化分析客服问题收集表（Excel），生成可视化分析报告，支持每周数据更新和趋势对比。
团队协作模式：
- 🐛 找茬 - 数据分析（读取 Excel、统计分析、未解问题人统计）
- 🎨 画师 - 报告生成（HTML 可视化、图表绘制、COS 上传）
🎯 核心功能
- 数据读取 - 自动解析 Excel 文件，识别字段
- 统计分析 - 问题总数、解决率、趋势分析
- TOP5 排行 - 反馈人、解决人、未解问题人等
- 可视化报告 - HTML 交互式报告（Chart.js，8 个图表）
- COS 上传 - 自动生成公网访问链接
- 周报对比 - 与上周数据对比，分析趋势
- 自动告警 - 解决率<80%、单周>50 个等阈值告警
📥 输入
- 文件格式:
.xlsxExcel 文件 - 必需字段:
- 问题描述
- 提交日期/所属周
- 所属平台
- 问题模块
- 反馈人
- 解决者
- 解决状态（已解决/待解决等）
- 问题类型（Bug/咨询/需求等）
📤 输出
- 结构化数据 -
analysis_data_latest.json - 文字总结 -
analysis_summary.md - 可视化报告 -
report_cn_latest.html（HTML 交互式，8 个图表） - 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 大图表
- 📈 每周新增问题趋势（折线图）
- 🏷️ 问题类型分布（饼图）
- 💻 平台问题分布 TOP5（横向柱状图）
- 👤 反馈人 TOP5（柱状图）
- ✅ 解决人 TOP5（柱状图）
- ⚠️ 未解问题人 TOP5（柱状图）- 解决者中未解决问题最多的
- ⚠️ 未解决问题模块 TOP10（表格）
核心指标
- 问题总数
- 已解决数/解决率
- 未解决数
- 环比变化
自动告警
- 🔴 解决率 <80%
- 🔴 单周新增 >50 个
- 🟡 Bug 占比 >60%
- 🟡 卖家端占比 >60%
🔄 每周更新流程
固定流程（每周一）
-
接收数据 (10:00)
- 用户上传最新 Excel 文件
- 保存到
issue_data_week_XX.xlsx
-
数据分析 (10:00-10:30) 🐛 找茬
- 读取 Excel
- 统计分析
- 对比上周
-
生成报告 (10:30-11:00) 🎨 画师
- HTML 报告生成
- 图表绘制
- 数据验证
-
上传 COS (11:00-11:10) 🎨 画师
- 上传文件
- 设置权限
- 生成链接
-
推送通知 (11:10-11:20)
- 发送报告链接
- 关键发现摘要
- 预警信息
-
归档历史 (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