工具简介
它是什么
duckdb-skills 是 DuckDB 官方仓库(duckdb/duckdb-skills)维护的 Claude Code 插件,用一组 DuckDB 驱动的技能,让 AI 编程助手具备本地数据探查与会话记忆能力。底层引擎是 DuckDB——一款 MIT 许可的进程内分析型数据库,因此所有数据处理都在本机完成,数据无需上传云端。项目以 MIT 许可开源,版权归 Stichting DuckDB Foundation。
包含 9 个技能
- attach-db:附加 DuckDB 数据库文件,自动探查表结构、列与行数,并写入会话状态文件。
- query:对已附加数据库或任意文件执行 SQL,支持原生 SQL 或自然语言提问,兼容 DuckDB 的 Friendly SQL 方言。
- read-file:读取并剖析 CSV、JSON、Parquet、Avro、Excel、空间数据、SQLite、Jupyter 等文件,支持本地及 S3/GCS/Azure/HTTPS 远程存储,按扩展名自动识别格式。
- duckdb-docs:对 DuckDB 与 DuckLake 文档、博客做全文检索,默认走 HTTPS 托管索引,也可本地缓存离线搜索。
- read-memories:检索过往 Claude Code 会话日志,找回历史决策、约定与未完成待办。
- install-duckdb:安装或更新 DuckDB 扩展,支持 name@repo 社区扩展语法与 --update 检查 CLI 版本。
- convert-file:在 CSV/Parquet/JSON/Excel/GeoJSON 等格式间互转,可产出 Agent 无法原生写入的二进制文件。
- spatial:用 DuckDB 处理坐标、距离、包含关系与空间连接,结合 Overture Maps 的 S3 免费数据,无需 API Key。
- s3-explore:列举并查询 S3/R2/GCS/MinIO 等对象存储上的数据,无需先下载。
核心设计:共享会话状态
所有技能共用每个项目一份 state.sql 文件(存放 ATTACH/USE/LOAD 语句、密钥与宏),追加写入且幂等;任意技能都能用 duckdb -init state.sql 恢复会话。正因如此,attach-db 探明的表结构能直接交给 query,read-file 配置的密钥能被其他技能复用,无需重复交代上下文。
安装与使用
当前通过 GitHub 作为插件市场安装:/plugin marketplace add duckdb/duckdb-skills,再 /plugin install duckdb-skills@duckdb-skills;之后技能以 /duckdb-skills:<技能名> 形式调用。官方称正在提交 Anthropic 插件市场,未来可在 /plugin 的 Discover 标签安装。前置条件是本机装有 DuckDB CLI,缺失时技能会引导通过 install-duckdb 安装。
平台与定位
已在 macOS 与 Linux 上测试通过,Windows 尚未完全支持。它不是 MCP Server,而是 Claude Code 的 Agent Skills 技能包;若使用其他 Agent,可 clone 仓库后指向 skills/*/SKILL.md 复用。适合需要让编码 Agent 直接分析本地大文件、做即席 SQL 探查、跨会话延续数据上下文的场景。
本页内容来自 KGABC 结构化知识库。带「未验证」标记的字段表示官方资料未明确说明,不等同于「不支持」。
核心功能
- 9 个可复用数据技能:附加数据库、SQL/自然语言查询、文件剖析、文档检索、会话记忆、扩展安装、格式转换、空间分析、对象存储探查
- 共享会话状态:每项目一份 state.sql,追加写入且幂等,跨技能自动复用表结构、密钥与宏
- 本地优先:基于进程内 DuckDB 引擎,数据处理在本机完成,无需上传云端
- 多格式与远程数据:CSV/JSON/Parquet/Avro/Excel/空间/SQLite/Jupyter,及 S3/GCS/Azure/HTTPS
- Friendly SQL:支持 FROM sales LIMIT 10 等简洁写法,自然语言问题可直接映射为查询
- 自我排障:query、read-file、read-memories 出错时可调用 duckdb-docs 检索官方文档
- 零配置空间数据:结合 Overture Maps 的 S3 免费数据,无需 API Key
适用场景
- 让编码 Agent 直接剖析并查询本地 CSV/Parquet/Excel 等数据文件
- 在会话间延续数据上下文:附加一次数据库,后续查询自动复用
- 对 S3/R2/GCS 对象存储做即席数据探查,无需先下载
- 空间数据分析:距离计算、包含判断、空间连接与 GeoJSON 转换
- 检索 DuckDB/DuckLake 文档与历史会话决策,快速排障与回忆
优势
- DuckDB 官方团队维护,MIT 许可,完全开源免费
- 技能之间互相引用形成闭环,共享 state.sql 避免重复交代上下文
- 本地优先的进程内分析引擎,可处理远大于内存的数据集
- 原生支持海量数据格式与云存储,Friendly SQL 降低查询门槛
- 无需 API Key 即可用 Overture Maps 做空间分析
技术能力
信息来源与可信度
| 来源类型 | 依据 | 状态 |
|---|---|---|
| GitHub - duckdb/duckdb-skills https://github.com/duckdb/duckdb-skills | 官方仓库 README,确认插件定位、9 个技能、安装方式、共享 state.sql 机制与平台支持 | 已验证 |
| duckdb-skills LICENSE (MIT) https://raw.githubusercontent.com/duckdb/duckdb-skills/main/LICENSE | LICENSE 文件证明 MIT 许可,版权归 Stichting DuckDB Foundation | 已验证 |
| DuckDB Skills for Claude Code - DuckDB 官方博客 https://duckdb.org/2026/09/16/duckdb-skills.html | DuckDB 官方博客介绍该插件的技能构成、示例交互与会话状态设计 | 已验证 |
| DuckDB Skills - Setup Guide https://www.corpusiq.io/docs/hermes/skills/catalog/duckdb-skills-setup | 第三方技能目录交叉验证:9 个 SKILL.md、MIT 许可、各技能用途与安装方式,且以 Claude Code 插件/Skill 形式分发而非 MCP Server | 已验证 |