vala-component-oops-stat.xiaoxi/SKILL.md

name	description
vala-component-oops-stat	瓦拉英语组件练习Oops率统计工具，支持按日期统计、自动剔除测试账号、分L1/L2等级、自定义样本量规则、导出Excel报表。使用场景：(1) 统计组件练习错误率/Oops率 (2) 按难度等级拆分L1(A1)/L2(A2)统计结果 (3) 练习次数不足10次自动补充历史记录 (4) 导出多sheet Excel报表 (5) 按Oops率降序排序展示高错误率组件

瓦拉英语组件Oops率统计技能

功能说明

用于统计飞书多维表格中组件练习的Oops（错误）率，支持灵活配置统计规则，自动处理数据口径问题，输出标准化统计结果。

核心特性

✅ 自动剔除测试账号：仅保留bi_vala_app_account.status = 1的正常用户练习记录 ✅ 等级拆分：自动按level字段拆分L1(A1)/L2(A2)两个难度等级分别统计 ✅ 样本量规则：昨日练习≥10次用昨日全量数据，<10次自动补充历史记录至10次，历史不足10次取全部记录 ✅ 正确排序：按Oops率数值从高到低排序，避免字符串排序错误 ✅ 自动导出：生成包含两个sheet的Excel报表，直接发送给用户

使用参数

参数	说明	默认值
统计日期	要统计的日期（格式YYYY-MM-DD）	昨日（当前日期-1天）
最小样本量	组件最少统计样本量	10
是否剔测试账号	是否排除测试账号练习记录	是
是否分等级	是否拆分L1/L2分别统计	是
导出格式	输出格式（CSV/Excel）	Excel

操作步骤

1. 确认用户统计需求：统计日期、样本量规则、是否分等级等
2. 执行对应等级的统计SQL脚本（scripts/stat_l1.sql、scripts/stat_l2.sql）
3. 运行scripts/generate_excel.py生成Excel报表
4. 将报表通过飞书发送给用户

脚本说明

scripts/stat_l1.sql

统计L1(A1)等级组件Oops率的SQL脚本，可修改日期参数调整统计时间

scripts/stat_l2.sql

统计L2(A2)等级组件Oops率的SQL脚本，可修改日期参数调整统计时间

scripts/generate_excel.py

将CSV统计结果合并生成带多sheet的Excel报表

references/table_schema.md

相关数据表结构说明和字段含义参考