data-analysis-partner
📖 技能介紹
name: data-analysis-partner description: 智慧資料分析 Skill，輸入 CSV/Excel 檔案和分析需求，輸出帶互動式 ECharts 圖表的 HTML 自包含分析報告 metadata: { "openclaw": { "emoji": "📊", "requires": { "bins": ["python3"] } } }
資料分析 Skill
功能說明
本 Skill 提供 analyze_data 工具，能夠：
- 讀取 CSV 或 Excel 資料檔案（.csv / .xlsx / .xls）
- 自動進行資料概覽（行列數、欄位型別、缺失值）
- 執行統計分析（描述統計、相關性分析、異常值檢測）
- 根據使用者需求生成針對性的分析和洞察
- 輸出帶互動式 ECharts 圖表的自包含 HTML 報告
觸發場景
當用戶出現以下意圖時，應主動呼叫 analyze_data 工具：
- 上傳了 CSV 或 Excel 檔案，並提出分析需求
- 要求"幫我分析這份資料"、"生成資料包告"、"視覺化這個檔案"
- 要求找規律、找差異、找趨勢、找異常
- 要求生成 BI 報告、資料洞察報告
呼叫方式
analyze_data(
file_path: "<檔案絕對路徑>",
requirements: "<自然語言分析需求>",
output_dir: "<輸出目錄，可選>"
)
呼叫示例
示例 1：
使用者說「幫我分析一下這個銷售資料，各區域表現怎麼樣？」
→ 呼叫 analyze_data(file_path="/path/to/sales.csv", requirements="分析各區域銷售額差異，找出表現最好和最差的區域，給出改善建議")
示例 2：
使用者說「分析使用者行為資料，找出流失節點」
→ 呼叫 analyze_data(file_path="/path/to/users.xlsx", requirements="對使用者行為資料做漏斗分析，找出主要流失節點，分析流失原因")
示例 3：
使用者說「分析產品退貨率的影響因素」
→ 呼叫 analyze_data(file_path="/path/to/orders.csv", requirements="分析產品退貨率，找出與退貨率相關的主要因素，給出降低退貨率的建議")
返回值說明
工具返回一個物件，包含：
| 欄位 | 說明 |
|---|---|
report_path |
HTML 報告檔案路徑，可直接在瀏覽器開啟 |
summary |
結構化摘要資料（行列數、欄位資訊、關鍵洞察列表） |
charts_count |
生成的圖表數量 |
insights |
規則引擎提取的關鍵洞察列表 |
open_command |
開啟報告的命令（如 open /path/to/report.html） |
報告結構
更多技能請訪問小蔥技能站7w4.net。
生成的 HTML 報告包含以下模組：
- 執行摘要 — 核心發現概覽卡片
- 資料概覽 — 欄位型別、缺失值、基礎統計表格
- 資料洞察 — 規則引擎自動提取的關鍵發現
- 視覺化圖表 — 互動式 ECharts 圖表（分佈圖、柱狀圖、熱力圖、趨勢圖等）
- 描述統計 — 數值列的 min/max/mean/std/quartile 詳細統計
- 分析結論 — 針對使用者需求的分析總結
獲取檔案路徑
如果使用者上傳了檔案但未提供路徑，使用以下方式獲取：
# OpenClaw 上傳檔案後，路徑通常在 ~/Downloads/ 或臨時目錄
# 可以用 list_files 工具確認
list_files("~/Downloads")
首次使用：安裝 Python 依賴
本 Skill 在首次呼叫時會自動嘗試建立隔離的 Python 環境並安裝依賴。如果自動安裝失敗，請手動執行：
# 在 Skill 目錄下建立虛擬環境
python3 -m venv ~/.openclaw/skills/data-analysis-partner/.venv
# 安裝依賴
~/.openclaw/skills/data-analysis-partner/.venv/bin/pip install pandas numpy openpyxl xlrd
依賴安裝優先順序：
1. Skill 目錄內建 .venv（隔離環境，推薦）
2. 系統 python3（需已安裝 pandas/numpy）
3. 自動建立 .venv 並安裝（首次執行時嘗試）
隱私說明
生成的 HTML 報告通過 CDN 載入 ECharts 圖表庫：
<script src="https://cdn.jsdelivr.net/npm/echarts@5/dist/echarts.min.js"></script>
這意味著：
- 用瀏覽器開啟報告時會向 cdn.jsdelivr.net 發出網路請求
- CDN 伺服器可能記錄訪問 IP、時間等基礎日誌
- 報告本身的資料內容不會上傳，僅載入圖表渲染庫
如需完全離線檢視，可在有網路時開啟一次報告（ECharts 會被瀏覽器快取），後續即可離線使用。
其他注意事項
- 大檔案（>100MB）分析時間可能較長（30秒~2分鐘）
- 超過 5 萬行的資料集會自動隨機抽樣，原始行數在報告中標註
- HTML 報告自包含（圖表配置內嵌），可傳送給他人檢視
🤖 AI 評測
這是一個功能完整、體驗良好的資料分析工具，能夠快速將 CSV/Excel 檔案轉化為帶互動圖表的專業報告。它最大的優點是操作簡單、圖表豐富、報告美觀，文件清晰易懂。不足之處是生成的報告在開啟時會連線外部網路載入圖表庫，對隱私敏感的場景不太友好；另外對於複雜資料分析場景，自動生成的洞察和建議相對基礎。總體來說質量不錯，適合日常資料分析使用，但在處理敏感資料時需注意網路連線問題。
