一看问数周报生成
只需上传问答表,即可输出周报 HTML,命名 一看问数周报-YYYYMMDD.html。
执行流程(触发后先做这步)
第一步:确认问答表已上传。 触发本 skill 后,先确认已收到:
- 问答表(必传)—— 一看问数系统导出的问答记录 xlsx(含提问者账号、提问内容、提问时间)
若未收到,立即询问,不要继续执行:
> 生成周报需要上传问答表 —— 一看问数系统导出的问答记录(含提问者账号、提问内容、提问时间)。
收到后,按下方「执行命令」运行脚本,然后用 present_files 展示生成的 HTML。
输入文件
1. 问答表(必填)
一看问数系统导出的问答记录 xlsx。需含以下列(列名关键词自动匹配,顺序无关):
| 必需信息 | 列名关键词(任含其一即可) |
|---|---|
| 提问者账号 | 提问者账号 / questioner / 账号 / BIP / 工号 |
| 提问内容 | 提问内容 / 内容 / content |
| 提问时间 | 提问时间 / create_time / 时间 / 日期 |
> 注意:若表里同时有"回复内容/回复时间"列,脚本会自动排除,只取提问列。
时间范围口径(默认规则,优先于一切)
用户没有说明时间范围时,一律采用问答表里的实际时间范围(即全量,不加 --days)。
判定顺序:
- 用户明确给了时间范围(如"最近 7 天""本周""10月9日到15日")→ 按用户说的来,用
--days N或自行筛选。 - 用户没说 → 默认全量,直接
python3 generate_report.py --qa "问答表.xlsx",取表中最早到最晚的全部记录。
禁止在用户未指定的情况下擅自切到 7 天。用户给了一批数据却只出 7 天,等于丢掉大部分样本,是口径事故,不是"贴心的周报"。
跑完后必须主动报出实际数据周期(如"2026年9月12日—10月15日,共 34 天"),让用户知道口径。若周期 >10 天,脚本标题会自动改为「使用分析(N 天累计)」——这是正常的,不要为了凑"周报"两个字去砍数据。
执行命令
# 【默认】用户未指定时间范围 → 全量,采用表中实际时间范围
python3 generate_report.py --qa "问答表.xlsx"
# 仅当用户明确要求「最近 N 天 / 本周」时才加 --days
python3 generate_report.py --qa "问答表.xlsx" --days 7
# 带使用率(需用户提供已覆盖用户数)
python3 generate_report.py --qa "问答表.xlsx" --covered 14446
> 脚本路径:与 SKILL.md 同目录下的 generate_report.py(脚本与说明文件始终在同一目录,cd 到该目录运行即可,与安装位置无关)
> 依赖:openpyxl(venv 内 pip install openpyxl)
> 默认输出目录:~/Desktop/WB工作区(用户统一交付根目录),文件名 YYYYMMDD_一看问数周报.html
> --days N:只取最新日期往前 N 天;0(默认)= 全量 = 表中实际时间范围
> 报告标题在周期 >10 天时自动改为「使用分析(N 天累计)」,避免"周报"名不副实
输出内容
一、核心指标(默认 2 个 KPI,无副行、无环比)
- 总问答数 = 问答表行数
- 已使用用户数 = 问答表去重提问账号数
- 问数使用率(仅在传 --covered 时显示,排在「已使用用户数」之后,无副行)= 已使用用户数 ÷ 已覆盖用户数;页脚自动补口径与「从未提问 N 人」
> 覆盖率分母(已覆盖/已开通用户数)必须问用户要,不要自己猜。用户给了就传 --covered 14446 这类整数。
二、提问分析(两图并排)
- 2.1 指标分布:按提问内容关键词分类,命中多类指标判「综合查询」,均未命中兜底「其他」
- 2.2 意图:基础查数 / 原因诊断 / 趋势分析 / 报告/清单生成 / 排名/对比
三、高频问题 Top 10:按提问内容出现频次降序,标注次数+涉及人数
分类口径
- 指标 13 类(判定优先级从高到低):报告生成 → 收费率 / 实收 / 满意度 / 欠费/回款 / 预存金额 / 利润/财务(六类指标词,命中 ≥2 类判「综合查询」)→ 排名/对比 → 趋势/对比 → 基础信息 → 原因诊断 → 其他
- 意图 5 类(判定优先级从高到低):报告/清单生成 → 排名/对比 → 趋势分析 → 原因诊断 → 基础查数
- 分类为关键词规则自动归类,非人工复核
口径说明(重要)
- 时间范围:用户未指定时 = 表中实际时间范围(全量)。详见上文「时间范围口径」。
- 已使用用户数 = 问答表去重提问账号(以实际数据为准)
- 不依赖任何白名单/开通名单表;如需岗位维度的分析,另行单独提需求