前言¶
本地放着 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
