duckdb-sql

用途：帮助用户了解数据、用自然语言生成 DuckDB SQL、按指令修改已有查询，以及从正确性、性能和风格角度审查 SQL。\n\n主要能力：读取 duckdb_sql_assets/ 中的 tables_inventory.json、schema_*.sql 和 data_dictionary.md，识别表、字段、枚举值与查询模式；支持 .ddb、.csv、.parquet 及 glob；生成查询前会校验表名和列名，避免臆造字段。\n\n使用方式：首次使用需按触发语初始化，检查 duckdb -version，失败时按平台安装（macOS：brew install duckdb；Linux：curl -fsSL https://install.duckdb.org | sh）。生成资产时用 .schema 和 DESCRIBE SELECT * FROM '<file>'; 提取结构。查询 .ddb 时先 ATTACH，例如 ATTACH IF NOT EXISTS 'data/sales.ddb' AS _db_sales (READ_ONLY);，CSV 与 Parquet 直接按路径引用。\n\n限制：默认只展示 SQL，不执行，除非用户明确要求运行。资产存在时不得直接访问数据库、重跑 schema 或校验变更，只有用户明确要求刷新时才更新。若资料中未提供具体文件、文档或枚举，应提示补充，不应编造。