前言¶
手裏有一份 CSV 或 Excel，想快速看清變量關係、擬合趨勢、出散點圖或迴歸圖時，常見做法是切到 Jupyter 或 BI 工具裏手寫腳本。在 Cursor、Claude Code 等帶 Skills 的 Agent 裏，也可以把「讀表 → 選模型 → 畫圖 → 解釋」收成一條對話鏈路。下面介紹 SkillHub 上的社區技能「數據建模」（@user_1581d31c/data-modeling-viz-v2），面向「給數據文件 + 用自然語言要分析結果」這一類任務。
這是什麼¶
「數據建模」是 SkillHub 分類 data-analysis 下的社區技能（來源：community，發佈者 user_1581d31c，當前版本 v1.0.0）。官方簡介寫明：對數據表進行數學建模分析並生成可視化圖表；當用戶提供 CSV/Excel 並要求分析數據關係、建立數學模型、繪製圖表或解釋數據規律時，應使用此技能。標籤 requires_api_key=false，表示按 SkillHub 元數據無需額外 API Key。
Skill 頁面：https://www.skillhub.cn/skills/user_1581d31c/data-modeling-viz-v2
資源座標：@user_1581d31c/data-modeling-viz-v2
核心功能¶
依據官方簡介，技能覆蓋的能力包括：
- 表數據輸入：以 CSV、Excel 等表格文件爲分析對象。
- 關係與規律：分析列與列之間的關係，解釋數據規律（官方列舉場景含關聯分析、相關性分析、數據挖掘）。
- 數學建模：建立數學模型，含統計建模、趨勢預測；觸發詞示例中有迴歸分析。
- 可視化：生成圖表；觸發詞示例中有畫圖、可視化、散點圖等。
官方給出的觸發關鍵詞包括：分析數據、建模、畫圖、預測趨勢、找規律、可視化、相關性分析、CSV 分析、Excel 分析、數據挖掘、散點圖、迴歸分析。Agent 在對話中識別到上述意圖且用戶提供了表格數據時，可按技能說明走完整流程。
安裝與啓用¶
安裝方式以 SkillHub 技能頁說明爲準：參照 SkillHub 安裝與優先源配置，安裝座標 @user_1581d31c/data-modeling-viz-v2。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可用官方腳本完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝「數據建模」到當前 Agent 的 skills 目錄¶
官方文檔要求：安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。
skillhub install @user_1581d31c/data-modeling-viz-v2 --dir <skills 目錄>
常用客戶端 skills 路徑（摘自官方安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
將 <skills 目錄> 換成你當前環境對應路徑。安裝後按各客戶端說明重啓或刷新 Agent，使技能被加載。
典型用法¶
官方未提供帶具體數值的逐步教程；用法可從簡介與觸發詞歸納如下，便於在 Agent 裏復現「要做什麼」：
- 將 CSV 或 Excel 放在 Agent 可讀的位置（工作區文件或對話附件，取決於客戶端能力）。
- 在提示中寫清目標，並儘量帶上官方觸發詞，例如：「用這份 CSV 做相關性分析，畫散點圖，並對主要變量做迴歸分析，解釋規律。」
- 若需要預測，可寫明「預測趨勢」或「建模」以及要預測的列名、時間粒度（列名需與表頭一致）。
- 讓 Agent 按技能內的
SKILL.md流程執行：讀表、選型、出圖、用文字說明結論。
示例提示（表頭與文件名按你的實際數據替換）：
附件 sales_2024.csv。請分析銷售額與廣告投入、客單價的相關性，畫散點圖；
對「銷售額」對「廣告投入」做簡單迴歸，並說明擬合是否合理、有無明顯異常點。
經過上面的步驟，Agent 應在啓用該技能後優先走「數據建模」所規定的分析路徑，而不是僅做泛泛的文字總結。
適用場景與注意¶
適合誰
- 已有表格數據、希望在對話裏完成統計建模與出圖，而不想每次從零寫 notebook 的分析人員或開發者。
- 需要快速做相關性、迴歸、趨勢類探索，並要圖表與文字解釋一併交付的場景。
使用注意
- 本技能爲社區發佈（
community），建模方法與圖表質量取決於技能內指令與 Agent 執行環境（Python 庫、是否允許寫文件等），使用前可在小樣本上試跑。 - 敏感數據請勿上傳到不可信環境；大表可能受上下文與運行時限影響，必要時應先抽樣或聚合。
- SkillHub 頁面展示的評分爲 100000、下載約 5667 次（以頁面/抓取元數據爲準），可作爲選用參考，不代表特定業務場景的準確率保證。
- 未要求 API Key，但若 Agent 執行分析時需要本地 Python 等依賴，仍需在本機或沙箱中自行滿足運行條件。
結尾¶
「數據建模」把 CSV/Excel 上的關係分析、數學建模與可視化收斂成可觸發的 Agent 技能，適合在 Cursor、Claude Code 等環境中用自然語言驅動分析。安裝與目錄配置以 SkillHub 官方文檔爲準；技能詳情與安裝入口見：https://www.skillhub.cn/skills/user_1581d31c/data-modeling-viz-v2。
