用途：帮助用户用 DuckDB 查询数据，输入可为原始 SQL 或自然语言问题，针对已附加的数据库（会话模式）或直接对文件做临时查询（ad-hoc 模式）。
主要能力：自动解析状态文件（.duckdb-skills/state.sql 或 $HOME/.duckdb-skills/<项目ID>/state.sql）判断模式；检查 duckdb 是否安装，缺失时转交 /duckdb-skills:install-duckdb；自然语言输入时先取表结构（duckdb_tables()、DESCRIBE）再生成 SQL；执行前估算结果规模，对超过 1M 行且无 LIMIT/聚合的查询提示加 LIMIT 1000，超过 10 GB 额外提醒耗时；执行后展示结果，超过 100 行提示截断。
使用方式：ad-hoc 模式在 :memory: 中沙箱执行，仅允许访问引用文件，命令形如 duckdb :memory: -csv <<'SQL'，内含 SET allowed_paths=['FILE_PATH']; SET enable_external_access=false; SET allow_persistent_secrets=false; SET lock_configuration=true; 后接查询。会话模式使用 duckdb -init "$STATE_DIR/state.sql" -csv -c "<QUERY>"，多行查询用 heredoc。生成 SQL 时优先 Friendly SQL 惯用法，如 FROM-first、GROUP BY ALL、SELECT * EXCLUDE/REPLACE、count()、FILTER、COLUMNS(*)、PIVOT/UNPIVOT、ASOF/POSITIONAL/LATERAL 连接、直接查询 'file.csv' 与通配符、CREATE OR REPLACE TABLE、INSERT ... BY NAME 等。
错误处理：语法错误给出修正建议并重跑；缺扩展转交 /duckdb-skills:install-duckdb <ext>；表不存在列出可用表；文件不存在用 find 定位；其他错误用 /duckdb-skills:duckdb-docs 查文档后重试。
限制：无状态文件且未引用文件时回退到 :memory:，需在 SQL 中直接引用文件；状态文件中 ATTACH 失败会警告并回退 ad-hoc；大结果集需用户确认后才执行。具体收费、平台与效果资料暂未提供。