前言¶
本地放着 CSV、Parquet 或 Excel，想快速做聚合、抽樣或 ad hoc 查詢時，常見路徑是：自己起 Python 讀文件、寫 pandas，或把數據導入數據庫再寫 SQL。步驟多、環境雜，對話式 Agent 也很難穩定選對庫和語法。
下面介紹 SkillHub 社區 Skill「智能數據分析」（座標 @user_af28adda/chat2duckdb-cloudcba）。它在 Agent 側封裝 DuckDB 能力，面向「對本地/常見格式文件直接 SQL 與分析」這一類任務，並標明無需 API Key（requires_api_key=false）。
這是什麼¶
「智能數據分析」是社區發佈者 user_af28adda 維護的 data-analysis 類 Skill，當前版本 1.0.0，來源標註爲 community。
官方簡介概括爲：基於 DuckDB 引擎的數據分析工具；當用戶需要對 CSV / JSON / Parquet / Excel 等文件做 SQL 查詢、數據分析、數據抽樣，或需要 自動糾錯的查詢執行 時，由 Agent 按 Skill 指引調用相應能力。
SkillHub 頁面：https://www.skillhub.cn/skills/user_af28adda/chat2duckdb-cloudcba
API 入口：https://api.skillhub.cn/user_af28adda/chat2duckdb-cloudcba
（SkillHub 展示數據：評分 100000，下載 10415，安裝 63。）
核心功能¶
以下能力均來自官方簡介，未在資料中出現的細節不展開：
- 多格式文件：支持 CSV、JSON、Parquet、Excel 等常見數據文件作爲分析對象。
- SQL 與分析：在 DuckDB 語義下對文件執行查詢與常規數據分析。
- 數據抽樣：適合在大文件上先看分佈、行樣例，再決定完整查詢。
- 查詢執行與糾錯：在查詢失敗或語法問題時，由 Skill 引導自動修正並重試執行（具體糾錯策略以 Skill 包內
SKILL.md爲準）。
安裝與啓用¶
安裝流程遵循 SkillHub 通用說明：https://skillhub.cn/install/skillhub.md
1、檢查 SkillHub CLI¶
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、安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。
skillhub install user_af28adda/chat2duckdb-cloudcba --dir <你的 Agent skills 目錄>
也可將下面提示交給支持 Skill 安裝的 AI，讓其按 skillhub.md 完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_af28adda/chat2duckdb-cloudcba`。
3、各客戶端 skills 目錄（摘自 SkillHub 文檔）¶
| 環境 | 典型路徑 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
裝到對應目錄後，按你所用客戶端說明刷新或重啓 Agent，使 Skill 被加載。
典型用法¶
官方頁面未附帶獨立命令行 demo；用法與簡介中的觸發條件一致：在已啓用該 Skill 的對話裏，用自然語言描述數據文件路徑與分析目標，由 Agent 按 Skill 調用 DuckDB 相關步驟。
可復現的交互模式示例（表述需替換爲你的真實路徑與字段名）：
- 說明數據文件位置與格式，例如：「項目下的
data/sales.csv，用 SQL 統計各品類銷售額 Top 10。」 - 需要先看數據時，可要求抽樣，例如：「從該 Parquet 隨機抽 100 行，並說明列類型。」
- 若查詢報錯，可繼續讓 Agent 修正 SQL 並重跑——這與簡介中的「自動糾錯的查詢執行」場景一致。
具體 SQL 方言、文件掛載方式、依賴包安裝以安裝後 Skill 包內的 SKILL.md 爲準；本文不臆造腳本名或配置項。
適用場景與注意¶
適合誰
- 已在 Cursor、Claude Code、Codex 等環境使用 Skills，希望用 SQL 快速探查本地表格類數據。
- 不想爲單次分析單獨搭數據庫，又希望分析邏輯可復現爲 SQL 的開發者或數據相關角色。
限制與注意
- 社區 Skill（
community），行爲與維護節奏取決於發佈者；升級前可在 SkillHub 查看版本 1.0.0 是否有更新。 - 大文件性能與內存佔用受 DuckDB 與本機環境約束；極大數據集仍需自行評估是否要先分區或入庫。
- 無需 API Key 僅表示 Skill 標籤如此標註；你分析的數據仍在本機或你指定的路徑，注意敏感數據權限。
- 安裝目錄錯誤是常見坑：務必
skillhub install ... --dir指向當前 Agent 的 skills 路徑。
結尾¶
「智能數據分析」把 DuckDB 的文件 SQL 能力接到 Agent 工作流裏，面向 CSV/JSON/Parquet/Excel 的查詢、分析與抽樣，並覆蓋查詢失敗時的糾錯執行場景。若你已在用 SkillHub，可按上文安裝 @user_af28adda/chat2duckdb-cloudcba，在對話中直接描述文件與分析需求即可。
官方 SkillHub 頁面：https://www.skillhub.cn/skills/user_af28adda/chat2duckdb-cloudcba
