huashu-excel – 花叔開源的 AI 數據分析 Skill

huashu-excel是什麼

huashu-excel 是花叔開源的 AI 數據分析 Skill，通過八步流程，包括體檢→清洗→對齊→分析→對賬→交付→驗圖→質控，解決 AI 做數據分析時算錯不報錯的核心問題。huashu-excel用 openpyxl 讀原始單元格識別結構陷阱，再用表內合計行當免費校驗和對賬，另派獨立 agent 重算拆台。工具支持 HTML/Excel/Word 報告輸出，依賴僅 openpyxl，MIT 協議開源。

huashu-excel的主要功能

• 數據體檢：用 openpyxl 讀取原始單元格，在 pandas 動表前先識別表頭錯位、合併單元格、小計行混入等結構隱患。
• 數據清洗：將髒錶轉化爲規範分析表，並生成可審計、可回放的清洗腳本，每一步影響多少行都有記錄。
• 需求對齊：先摸底數據特徵和外部基準，再與用戶確認真實需求和分析口徑，避免帶着錯的問題做完整套分析。
• 數據分析：掃描辛普森悖論、幽靈分組、小基數、時間斷點等常見數據陷阱，把發現推到「所以呢」。
• 數字對賬：拿清洗後的明細去對錶內自帶的「合計」行，用免費校驗和揪出手填錯誤和口徑差異。
• 報告交付：輸出自包含 HTML（內聯 SVG 離線可開）、原生 Excel（圖表隨數據聯動）、Word 六頁紙敘述體報告。
• 圖表驗圖：檢查 SVG 渲染是否越界、重疊、遮擋、雙軸誤導，確保圖表誠實且色盲友好。
• 獨立質控：另派一個沒參與創作的 agent 從原始數據重算一遍，專門拆台驗證結論可靠性。

微信關注回覆“開源”，加入AI開源項目交流羣

如何使用huashu-excel

• 安裝 Skill：運行 npx skills add alchaincyf/huashu-excel 或手動 clone 到 agent 的 skills 目錄。
• 選擇路徑：Claude Code 放 ~/.claude/skills/，Codex / Kimi Code 放 ~/.agents/skills/，項目級可跟倉庫走。
• 自然語言調用：直接說人話，如「幫我分析這份銷售表」「這兩個數怎麼對不上」「幫我把表洗乾淨」。
• 按需觸發流程：問一個數直接查，要報告走完整八步，洗表只跑體檢+清洗並附可回放腳本。
• 腳本獨立使用：脫離 agent 直接跑 profile_table.py（體檢）、verify_numbers.py（對賬）、verify_visual.py（驗圖）等。

huashu-excel的核心優勢

• 先體檢再計算：用 openpyxl 讀取原始單元格結構，在 pandas 動表前就發現合併單元格、小計行混入等隱患，避免信息損毀後誤判。
• 合計行當校驗和：拿清洗後的明細去對錶內自帶的「合計」行，把原表作者算出的真值變成免費校驗和，揪出手填錯誤。
• 獨立質控拆台：另派一個沒參與創作的 agent 從原始數據重算一遍，專門驗證結論可靠性，解決「內部全對但整體錯一個財年」的問題。
• 算錯會報錯：通過行數守恆、總和守恆、交叉對賬等多重閘門，讓 AI 數據分析從「靜默出錯」變成「對不上就不交付」。
• 圖表誠實性：基於 Cleveland & McGill 感知精度階梯選視覺編碼，類別超 3 個拒絕餅圖，柱形軸強制從 0，不完整末期畫虛線。
• 跨 Agent 通用：不綁定特定平台，Claude Code、Cursor、Codex、OpenClaw、Hermes 都能裝，純標準庫腳本也能脫離 agent 獨立運行。
• 依賴極簡離線可用：核心依賴僅 openpyxl，無需 pandas、繪圖庫、LibreOffice 和聯網，HTML 報告內聯 SVG 手畫，離線直接打開。

huashu-excel的項目地址

• GitHub倉庫：https://github.com/alchaincyf/huashu-excel

huashu-excel的同類競品對比

huashu-excel的應用場景

• 日常運營早會覆盤：每天從後台取前一日運營數據，自動走完體檢→清洗→分析→對賬，在早會前交出帶口徑聲明的數據波動歸因報告。
• 銷售業績深度覆盤：丟一份百萬行交易明細，自動識別新品補窟窿、老品失血等結構性問題，輸出可直接呈報銷售 VP 的 HTML 報告。
• 財務預算執行審查：分析市政或企業預算表，通過外部基準對賬發現「內部全對但整體錯一個財年」的列名口徑陷阱，給出委員會級解釋。
• HR 薪酬公平診斷：處理數萬份薪酬問卷，控制行業/學歷/工齡/城市後計算性別差距，並明確標註「能證明什麼、不能證明什麼」的分析邊界。
• 數據清洗與審計交接：把髒表洗乾淨，附贈一份可回放、可審計的 pandas 清洗腳本，每一步影響多少行都有記錄，方便後續追責或複用。