用途:管理 MotherDuck Guides,把业务语言映射到确切的目录对象和经过验证的 SQL,沉淀业务定义、连接规则与可复用的仓库约定。
主要能力:通过 get_query_guide 或 list_guides 查看可见主题树,避免重复;读取相关 Guide 版本与被引用对象后再起草变更;选择最窄的适用主题,仅在组织级定位时留空主题;用简洁 Markdown 编写内容,标题和描述需有区分度,优先写规则、经过测试的 SQL 和已知陷阱;把引用挂到所治理的数据库、共享、模式、表、列、Dive、Flight 或 Guide 上,便于智能体在合适时机发现;用版本注释说明变更原因,更新前先读,避免覆盖并发工作。
使用方式:分析查询走 MCP 时,先调用 get_query_guide 再写 SQL,只遍历相关主题和 Guide;get_dive_guide 与 get_flight_guide 会自动包含保留主题 dives 和 flights 的摘要,除非需要更深上下文,否则不要单独加载这些主题。新建 Guide 默认 access = 'user',组织可见性需显式请求并具备所需管理员权限。创建或更新请求通过 MCP 或文档化的 SQL 函数执行,并读回验证元数据、访问权限、引用、当前版本和变更注释。
适用场景:回答、评审或规划类请求只检查与起草,不创建或修改 Guide;显式创建/更新请求执行范围内变更并验证;删除或扩大可见范围前先询问。
限制:引用对象和可执行 SQL 需在实时工作区验证后才可视为可信;相关技能仅在缺少能力时加载,如 motherduck-explore 验证目录对象、motherduck-query 测试 SQL、motherduck-create-dive 与 motherduck-create-flight 处理保留主题约定、motherduck-security-governance 处理组织可见性与权限边界。具体收费、价格与平台信息暂未提供。