用途：对 MotherDuck 数据库执行 DuckDB SQL 查询，覆盖分析、聚合、转换和数据探索等场景。
前提条件：需先通过 connect 建立 MotherDuck 连接，并通过 explore 确认目标数据库与表。
默认准则：编写 DuckDB SQL 而非 PostgreSQL SQL，即使使用 PG 端点也一样；始终使用完全限定的 "database"."schema"."table" 名称；尽早过滤、尽早聚合，重复读取优先使用服务表或汇总；SQL 保持直观、多行，明确粒度、过滤条件和输出形态；连接路径支持时，用 custom_user_agent 标记长期集成。
工作流：写 SQL 前先确认实际表、列和粒度；先写 SQL，必要时再包进 Python 或 TypeScript；使用 CTE 和 DuckDB 原生模式，如 GROUP BY ALL、QUALIFY、arg_max；检查执行计划与形态，关注下推、不必要的排序或重复原始扫描；对昂贵的重复查询，酌情物化为服务表或轻量视图。
后续参考：references/QUERY_PLAYBOOK.md 提供 DuckDB 查询模式、探索 SQL、性能规则、常见分析形态和常见错误。
相关技能：connect 用于会话设置，duckdb-sql 用于语法与函数参考，explore 用于在写查询前理解源模式。
限制：资料未提供具体收费、价格、平台支持范围或效果数据。