duckdb-skills

为 Claude Code 提供 DuckDB 驱动的数据探索与会话记忆技能

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:duckdb-skills。
它的用途是:为 Claude Code 提供 DuckDB 驱动的数据探索与会话记忆技能
完整的 Skill 内容见:https://321skill.com/skills/duckdb-skills/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'/duckdb-skills:read-file sales_data.parquet',它会自动识别文件格式并展示表结构和样本数据,方便你快速了解数据概况。接着,你可以说:'/duckdb-skills:query 计算每个地区的月度销售额趋势',它会基于已加载的数据生成并执行相应的 SQL 查询,将结果清晰地呈现给你。

介绍

duckdb-skills 是一个 Claude Code 插件,旨在解决数据分析师和开发者在探索本地或远程数据、查询数据库以及管理项目会话上下文时面临的效率问题。它通过一系列 DuckDB 驱动的技能,将强大的数据查询能力无缝集成到 Claude Code 的对话环境中。

使用方式非常直观。用户通过简单的命令即可附加数据库文件、查询数据、读取多种格式的数据文件,甚至搜索 DuckDB 官方文档。所有技能共享一个可持久化的 SQL 状态文件,确保会话上下文在不同技能和对话间得以保留,无需重复配置。

这个插件特别适合数据分析师、后端开发者和需要频繁处理数据的学术研究者。它降低了使用 DuckDB 进行数据探索的门槛,让用户能在熟悉的对话界面中直接操作数据,而无需在终端和 IDE 间频繁切换。

建议用户首次使用时从 attach-dbread-file 技能开始,快速建立会话状态。对于团队协作项目,建议将状态文件存储在项目目录中并适当进行版本控制(如忽略敏感信息),以便团队成员共享数据库连接和配置。

核心特点

核心区别在于它将 DuckDB 的强大数据引擎与 Claude Code 的对话式交互深度结合,通过可持久化的 SQL 状态文件实现跨技能、跨会话的上下文共享,而不仅仅是提供孤立的查询功能。此外,其 `read-file` 技能支持从本地到云存储(S3、GCS等)的广泛数据源和格式,并集成了官方文档搜索能力。

注意事项

该技能主要围绕 DuckDB 生态,不适合需要连接其他类型数据库(如 MySQL、PostgreSQL)进行复杂事务处理的场景。

常见问题

如何在不同项目间管理数据会话?

插件支持将状态文件存储在项目目录或用户主目录,通过路径隔离不同项目的会话。运行技能时会提示选择。

能读取 Excel 或远程 S3 文件吗?

可以。`read-file` 技能支持 CSV、JSON、Parquet、Excel、SQLite 等多种格式,并可直接读取 S3、GCS、HTTPS 等远程路径。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/duckdb-skills/raw/index.md 读取 duckdb-skills 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。