name: Data Bird version: 1.1.0 description: 輕量級資料分析 Agent。支援工作區表格與通過 http(s) 下載的 CSV/Excel，按自然語言生成 ECharts 與文字結論。（公開發布版說明） metadata: {"clawdbot":{"emoji":"📊"}}

Data Bird — 資料分析與圖表生成（公開發布版）

用途：分析 CSV / Excel，輸出 ECharts JSON、Markdown/HTML/PDF 報告。適合與前端圖表、Agent 工作臺對接。

免費版限制：

• 每日最多 5 次 呼叫
• 單次最多 5 個圖表
• 不支援 MySQL 資料來源
• 使用者若輸入 “升級套餐 / 檢視套餐 / 價格 / 付費版”，應優先返回升級與套餐入口，而不是繼續要求資料來源

資料來源：

1. 工作區已有檔案 — 使用者或系統提供的本地路徑
2. http:// / https:// 連結 — 先下載到本機再分析

路徑請按你的 OpenClaw 部署替換下文中的 <WORKSPACE>（通常為 OPENCLAW_WORKSPACE 指向的目錄）與 <SKILL_DIR>（本 skill 安裝目錄，一般為 <WORKSPACE>/skills/data-bird）。

必須遵守

1. 使用者給出 本地路徑或 URL → 按本流程執行。
2. 任意可下載 URL（含內網、本機）→ 不要用 web_fetch，用 exec: curl -fsSL 下載，再 --file 分析。
3. 輸出 JSON 後 → 展示圖表摘要、reportMd / report_md、insight、artifacts。
4. 若有 artifacts.reportHtmlPreviewUrl / reportPdfUrl / reportMdUrl → 在回覆中直接給出可點選連結，不要只說“已儲存到某路徑”。
5. 回覆中主動告知：
6. 建議上傳目錄：<WORKSPACE>/databird/data/
7. 報告根目錄：<WORKSPACE>/databird/output/
8. 本次報告目錄（若有）

路徑約定

流程

1）得到本地檔案

• 已有路徑 → 直接進入步驟 2，--file 傳該路徑。
• http(s) URL →

exec: mkdir -p <SKILL_DIR>/data
exec: curl -fsSL "<URL>" -o <SKILL_DIR>/data/table.csv

（按實際型別儲存為 .csv / .xlsx / .xls。無後綴時根據響應或使用者說明命名。）

來源於7w4.net。

• 僅描述「工作區裡的表」 → 在 <WORKSPACE>/data/、<SKILL_DIR>/data/ 等目錄查詢匹配的表格檔案。

2）執行分析

exec: cd <SKILL_DIR> && python scripts/main.py --query "<分析問題>" --file "<本地路徑或 data/xxx.csv>"

3）展示結果

主要欄位：charts、insight（conclusions / anomalies / suggestions）、reportMd 與 report_md（內容相同）、summary、artifacts。

artifacts 中會包含：

• report_md_path
• report_html_path
• report_pdf_path
• chart_paths
• chart_image_paths
• reportHtmlPreviewUrl
• reportPdfUrl
• reportMdUrl

問法提示：「佔比」「趨勢」「排名」「分佈」「散點」等有助於選對圖表型別。

示例（佔位 URL，請替換為真實地址）

HTTPS 表格

exec: mkdir -p <SKILL_DIR>/data
exec: curl -fsSL "https://example.com/data/report.csv" -o <SKILL_DIR>/data/report.csv
exec: cd <SKILL_DIR> && python scripts/main.py --query "趨勢與對比" --file data/report.csv

工作區已有檔案

exec: cd <SKILL_DIR> && python scripts/main.py --query "各品類佔比" --file "<WORKSPACE>/data/sales.xlsx"

依賴

cd <SKILL_DIR> && pip install -r requirements.txt

PDF / 圖表中文：skill 自帶 fonts/SourceHanSansSC-Regular.otf（思源黑體），無需系統安裝中文字型。若該檔案缺失，見 fonts/README.md 一鍵下載說明。

套餐升級

• 使用者若明確提出 升級套餐 / 檢視套餐 / 價格 / Pro 版，優先展示升級指引與連結。
• 免費版觸發限制（額度、MySQL、圖表數等）時，也應返回升級入口，不要只報錯。
• 維護說明：本地 config.yaml 中的 plan / daily_limit / enable_mysql 僅為預設體驗配置；真正的 Pro 授權由 py_api 服務端校驗。

這個 Skill 質量良好，文件清晰易懂，功能完整實用。它能分析 Excel 和 CSV 資料，自動生成圖表和文字結論，還能輸出 Markdown、HTML、PDF 等多種格式的報告。操作流程有詳細說明，配有示例和升級套餐提示。但免費版有呼叫次數和圖表數量限制，且缺少快速上手指南；對中文資料處理依賴特定字型檔案，可能存在相容風險。總體適合需要頻繁進行資料分析和視覺化報告的使用者。