分析Excel表中的申报失败信息，自动生成Word版本的申报运维报告，用于定位问题、统计趋势、提出整改建议。

分析Excel表中的申报失败信息，自动生成Word版本的申报运维报告，用于定位问题、统计趋势、提出整改建议。

Security Scan

技能说明、输入和运行步骤在功能上自洽：它只描述读取 Excel、做清洗/统计并生成 Word 报告，没有要求额外凭据或可疑安装来源。

Purpose & Capability

技能名称和描述与 SKILL.md 中的要求一致——读取含失败明细的 Excel、做统计分析并生成 Word 报告。要求的输入字段（excel_path、report_title、output_path）与功能相符，没有请求与税务分析无关的外部凭据或路径。

Instruction Scope

运行步骤限于读取指定 Excel 文件、数据清洗、统计分析、生成 Word 文件并保存；没有指示读取其它系统文件、环境变量或把数据发往外部服务。交互式列映射与大文件分块读取是合理且与目的相关的范围扩展。

Install Mechanism

这是指令型技能、没有 install spec 或代码文件，降低了磁盘写入风险。但 SKILL.md 假定使用 pandas / openpyxl / python-docx / 可选的 matplotlib 等 Python 库；这些库需要在运行环境中已安装或由宿主环境安装。没有提供安装来源或版本约束，使用者应在受信环境中安装来自官方源（pip/conda）的包。

Credentials

技能不请求任何环境变量、凭据或配置路径；仅基于传入的 Excel 文件进行处理，所需权限与功能相称。

Persistence & Privilege

技能没有设置 always:true，也不修改其它技能或系统配置；默认允许模型调用（平台默认）且在当前描述下与功能一致，没有不当持久权限请求。

Assessment

该技能在功能和要求上自洽，但在安装与运行前请注意：1) 确保运行环境已安装并信任 pandas、openpyxl、python-docx（以及可选的 matplotlib），最好从官方源安装并固定版本；2) 该技能会读取并处理你提供的 Excel 文件，文件可能包含敏感或个人税务信息——仅在可信环境中运行并谨慎选择输入文件；3) 技能没有说明会把数据发送到外部服务，但如果在可联网的代理/平台上运行，请确认平台/代理不会将文件自动上传到第三方；4) 如果你希望技能在无法联网或受限环境执行，先在本地或受控环境测试其行为并验证产出。

技能执行步骤

1. 读取并解析Excel数据

• 使用pandas或openpyxl读取 excel_path 文件。
• 自动检测列名（支持中英文别名），标准字段映射如下：
  • 时间字段：申报时间 / submit_time / date
  • 业务类型：业务类型 / biz_type
  • 失败原因：失败原因 / fail_reason / error_msg
  • 申报渠道：渠道 / channel
  • 处理状态：状态 / status（仅统计“失败”记录，若存在“已修复”等状态则区分）

2. 数据清洗与预处理

• 删除全空行、重复记录。
• 将时间列统一为 datetime 类型，按天或小时聚合。
• 对失败原因进行文本标准化（如去除标点、统一大小写、提取核心错误码）。

3. 统计分析（必须输出以下内容）

3.1 总体概览

• 总申报失败笔数
• 时间范围（最早失败时间 ~ 最晚失败时间）
• 涉及业务类型数量、渠道数量

3.2 趋势分析

• 日趋势：每日失败数量折线图（用字符或文字描述，也可生成matplotlib图并嵌入Word）
• 时段热点：按小时统计失败高峰时段

3.3 多维下钻

• 按业务类型：失败数 Top 5 业务，及其主要失败原因
• 按渠道：各渠道失败率（失败数 / 该渠道总申报数，若无总量则只列失败数）
• 按失败原因：聚类统计（如“网络超时”、“参数校验失败”、“数据不存在”等），列出 Top 5 原因及占比

3.4 异常检测

• 发现同一业务/同一原因持续超过3天的“顽固错误”
• 发现短时间内（30分钟内）爆发式失败（阈值：>10笔）

4. 生成Word报告

• 使用 python-docx 库创建Word文档。

• 报告结构如下：

  封面：报告标题、生成日期、数据时间范围 一、 执行摘要：200字以内，概述总失败数、最严重业务/渠道、核心问题。 二、 总体情况：总失败笔数、业务/渠道分布表格。 三、 趋势分析：日趋势描述 + 时段热点表格。 四、 问题明细： - 按失败原因分类的表（原因、次数、占比、典型错误样例） - Top 5 业务+渠道组合的失败详情 五、 顽固问题清单：持续超过3天的相同失败，列出业务、原因、起始日期。 六、 整改建议：基于失败原因给出可执行建议（例如：优化超时重试机制、增加参数前置校验、联系渠道方排查接口）。

• 将统计图表（如有）以图片形式插入对应章节。

• 保存文件到 output_path。

5. 输出确认

• 打印生成成功信息及文件绝对路径。
• 若Excel缺少必要字段，给出明确错误提示并建议手动映射列名。

注意事项

• 当Excel文件大于20MB时，启用分块读取。
• 如果找不到标准列名，则以交互方式让用户选择对应的列。
• 所有数值保留整数，百分比保留一位小数。
• 报告语言为简体中文，日期格式 YYYY-MM-DD。