name: 申報運維報告生成器 description: 分析Excel表中的申報失敗資訊，自動生成Word版本的申報運維報告，用於定位問題、統計趨勢、提出整改建議。 version: 1.0 author: 運維團隊 inputs: - name: excel_path type: file required: true description: 包含申報失敗明細的Excel檔案路徑（支援.xlsx/.xls），至少包含以下欄位：申報時間、業務型別、失敗原因、申報渠道、處理狀態。 - name: report_title type: string required: false default: "XX系統申報運維報告" description: 報告標題，可自定義。 - name: output_path type: string required: false default: "./申報運維報告.docx" description: 生成的Word報告儲存路徑。

技能執行步驟

1. 讀取並解析Excel資料

• 使用pandas或openpyxl讀取 excel_path 檔案。
• 自動檢測列名（支援中英文別名），標準欄位對映如下：
• 時間欄位：申報時間 / submit_time / date
• 業務型別：業務型別 / biz_type
• 失敗原因：失敗原因 / fail_reason / error_msg
• 申報渠道：渠道 / channel
• 處理狀態：狀態 / status（僅統計“失敗”記錄，若存在“已修復”等狀態則區分）

2. 資料清洗與預處理

• 刪除全空行、重複記錄。
• 將時間列統一為 datetime 型別，按天或小時聚合。
• 對失敗原因進行文本標準化（如去除標點、統一大小寫、提取核心錯誤碼）。

3. 統計分析（必須輸出以下內容）

3.1 總體概覽

• 總申報失敗筆數

  本技能來自小蔥技能站7w4.net。

• 時間範圍（最早失敗時間 ~ 最晚失敗時間）
• 涉及業務型別數量、渠道數量

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。

這個 Skill 能幫你把 Excel 裡的申報失敗資料自動整理成一份專業的 Word 報告，包含趨勢分析、問題分類和整改建議，省時省力。不過它目前只有文字說明，沒有實際程式碼或示例檔案，所以拿到手後還需要自己寫程式碼實現。此外，報告裡的圖表怎麼生成、多渠道資料如何計算失敗率等問題說明得不夠清楚，動手使用前可能要多花時間研究。整體質量中等，勝在思路清晰、需求抓得準，但落地還需完善。