name: yi-chang-bao-gao-fen-xi-skill description: 异常报告 Excel 自动入库与分析技能。用于处理从钉钉 OA 审批“异常报告”单据导出的 Excel 文件：当收到新的异常报告文件或相关目录时，先自动导入到 skill 自带的 SQLite 数据库，再按用户要求做查询、统计、趋势分析、供应商/物料/部门检索、损失与审批状态分析。
异常报告分析 Skill
概述
用这个 skill 处理“异常报告”Excel：收到新文件先自动入库，再按用户要求做查询、统计、趋势分析、异常明细检索。
数据库以 数据id 为业务主键；同一文件内容按哈希跳过重复导入；重复导入或新版本导入时按 数据id 覆盖更新，避免重复累计。
自动入库工作流
1. 收到单个异常报告文件
当用户提供新的 Excel 文件时：
- 如果文件名包含“异常报告”，或用户明确说明这是钉钉 OA 的异常报告导出文件，则立即导入
- 执行
python3 scripts/import_exception_report.py <excel_path> - 如果返回
skipped: true，说明相同文件内容已导入过，直接告知用户已跳过 - 导入完成后，再继续后续分析
2. 收到目录或历史文件集合
如果用户给的是目录，或者要求“把这批异常报告都入库”：
- 执行
python3 scripts/scan_exception_reports.py <folder> - 递归扫描目录内文件名包含“异常报告”的
.xlsx/.xls文件 - 自动批量导入，并汇总导入 / 跳过 / 报错数量
3. 分析前先理解数据结构
分析前如需确认字段，读取：
references/schema.mdreferences/auto-import.md
如需查看数据库中的实际列映射，可查询：
report_columns
执行分析
按用户问题组织 SQL，优先使用聚合查询。
常见分析方向：
- 数量统计：公司、部门、问题类型、责任归属、审批状态
- 时间趋势：按天/周/月统计异常数量
- 明细筛选：按供应商、物料编码、物料名称、创建人、负责人筛选
- 风险分析：造成损失的记录、处理中超时记录、重复发生异常
- 文本分析：总结异常说明、原因分析、改进措施中的高频问题
执行查询时：
- 用
scripts/query_exception_report.py执行 SELECT 类 SQL - 先给结论，再给必要明细
- 行数较多时，只展示代表性样本或 Top N
查询模板
总量与分布
SELECT 问题类型, COUNT(*) AS cnt
FROM reports
GROUP BY 问题类型
ORDER BY cnt DESC按公司统计
SELECT 所属公司, COUNT(*) AS cnt
FROM reports
GROUP BY 所属公司
ORDER BY cnt DESC按供应商统计
SELECT 异常材料清单_1 AS 供应商名称, COUNT(*) AS cnt
FROM reports
GROUP BY 异常材料清单_1
ORDER BY cnt DESC
LIMIT 20处理中记录
SELECT 数据id, 审批编号, 所属公司, 问题类型, 当前负责人, 审批状态, 更新时间
FROM reports
WHERE 审批状态 LIKE '%审批中%'
ORDER BY 更新时间 DESC损失记录
SELECT 数据id, 审批编号, 是否造成损失, 损失明细, 损失明细_1, 责任归属, 责任归属_1
FROM reports
WHERE COALESCE(是否造成损失, '') <> ''
AND 是否造成损失 NOT IN ('否', '无', 'nan')
ORDER BY 更新时间 DESC结果表达规范
- 先回答用户真正关心的结论，不要先甩 SQL
- 尽量把字段名翻译成自然语言，例如：
异常材料清单.1= 供应商名称异常材料清单.2= 物料编码异常材料清单.3= 物料名称- 如果发现原始数据有重复表头行或重复
数据id，按既定规则清理后再分析，不把脏数据直接报给用户 - 如果用户要求“基于最新导入数据”，可先查看
imports表确认最新批次
资源
- 导入脚本：
scripts/import_exception_report.py - 批量扫描脚本：
scripts/scan_exception_reports.py - 查询脚本：
scripts/query_exception_report.py - 自动入库说明：
references/auto-import.md - 结构说明：
references/schema.md - SQLite 数据库：
assets/exception_reports.db