SuperAPI AI 工具集

motherduck-explore

数据与分析

查看项目

更新于 10-16 01:20

技能介绍

用途:在 MotherDuck 中探索数据集结构,发现数据库、表、列、共享(share)与样本数据,为后续建模或仪表盘工作建立 schema 认知。

主要能力:列出范围内的数据库;加载相关 Guide 上下文后列出目标库中的表与视图;检查列、类型、可空性与注释;用定向剖析或 SUMMARIZE 了解范围、基数与空值率;预览行数据并记录粒度与连接假设。

使用方式:优先使用 MotherDuck MCP 工具(list_databases、list_tables、list_columns、search_catalog),其结构化结果比临时 SQL 更快。通过 MCP 做业务语义探索前先调用 get_query_guide,只读相关根 Guide 与主题分支,并遵循目录工具返回的 relatedGuides。附加多个数据库后使用完全限定表名。在断定数据不可用前先检查共享数据库。

工作流:列出范围内数据库;加载 Guide 上下文并列出目标库的表与视图;写查询前检查列、类型、可空性与注释;必要时做定向剖析或 SUMMARIZE,避免为目录查询做全表扫描;预览行、记录粒度与连接假设,再进入分析 SQL 或建模。

适用场景:需要快速理解陌生数据集、确认共享数据是否可用、为分析查询或建模准备 schema 地图时。

限制与注意:需已建立 MotherDuck 连接或活跃的 MCP 服务器;应记录共享是否被过滤,以及已有 Dive 处于 Draft、Ready、Endorsed 还是 Archived,这些属性影响下游代理的信任预期;进入建模或仪表盘前应返回包含表粒度、连接键、日期列与可能度量的简洁 schema 地图。相关技能:motherduck-connect 负责会话与认证,motherduck-query 负责 schema 明确后的分析 SQL,motherduck-duckdb-sql 提供 DuckDB 语法模式,motherduck-share-data 处理共享创建与消费,motherduck-manage-guides 读取或维护对象上下文。完整 SQL 工作流、共享发现模式、MCP 工具指引与常见错误见 references/EXPLORATION_PLAYBOOK.md。