用途：针对 MotherDuck 数据编写、执行或优化分析型 DuckDB SQL。
前提：已建立 MotherDuck 连接，或存在可用的 MotherDuck MCP 服务；已确定目标数据库与表。
主要能力与默认做法：当 MotherDuck MCP 可用且查询用于回答业务问题时，先调用 get_query_guide 再写 SQL，只浏览相关主题，并用实时 schema 校验 Guide 的说法。写 DuckDB SQL 而非 PostgreSQL SQL，即使通过 PG 端点访问。始终使用完全限定的 "database"."schema"."table" 名称。优化或物化前保留结果粒度，并检查连接基数。尽早过滤、尽早聚合，重复读取优先使用服务表或汇总。SQL 保持直观、多行，明确粒度、过滤与输出形态。DDL、DML、ATTACH、DETACH、CREATE SNAPSHOT、ALTER DATABASE ... SET SNAPSHOT、UNDROP DATABASE、SHUTDOWN 等视为写操作，用户变更请求授权时使用 MCP 的 query_rw 工具；仅当操作具破坏性、对外可见或超出范围时才请求确认。连接路径支持时，用 custom_user_agent 标记长期集成。
工作流：先确认实际表、列与粒度；MCP 可用时加载相关 Guide 上下文，但不替代 schema 检查；先用 SQL 写查询，必要时再包进 Python 或 TypeScript；能用 DuckDB 原生模式简化时就用，简单查找无需 CTE 或物化；验证结果形态与关键聚合，性能相关或执行异常时检查计划；确有需要时将昂贵的重复查询物化为服务表或轻量视图。
参考：只读当前任务所需的参考章节，如 references/QUERY_PLAYBOOK.md 中的查询模式、探索 SQL、性能规则、常见分析形态与常见错误。相关技能仅在缺少能力时加载：motherduck-connect 负责会话建立，motherduck-duckdb-sql 提供语法与函数参考，motherduck-explore 用于写查询前理解源 schema，motherduck-manage-guides 用于读取或维护语义定义与可复用查询规则。
限制：资料未提供具体收费、价格、平台支持范围或效果数据。