motherduck-explore

MotherDuck データを探索する

前提条件

• MotherDuck への接続が確立されていること（または MotherDuck MCP サーバーが稼働していること）

基本方針

• 既知のカタログオブジェクトから調査を開始し、対象が不明な場合にのみデータベースや共有へ範囲を広げます。
• 完全修飾名の"database"."schema"."table"を優先します。複数のデータベースまたは共有がアタッチされている場合は、完全修飾名が必要です。
• データを利用できないと結論づける前に、共有データベースを確認します。セキュアビューを含む共有では、列や行が非表示になることがあります。アタッチした共有で列が見つからない場合、スキーマの変更ではなくポリシーが原因の可能性があります。
• 利用可能な場合は、MotherDuck MCP ツール（list_databases、list_tables、list_views、list_columns、list_macros、search_catalog）を使用します。場当たり的な SQL よりも高速に構造化された結果を返すためです。ロジックを再実装する前にlist_macrosを確認します。テーブルマクロやスカラーマクロには、管理された定義が含まれていることがよくあります。
• MCP を介してビジネス上の意味を探索する前に、get_query_guideを呼び出し、関連するルートガイドとトピック別ブランチのみを読みます。カタログツールが返すrelatedGuidesが対象オブジェクトに適用される場合は、それに従います。
• 共有がフィルタリングされているかどうか、および既存の Dive が Draft、Ready、Endorsed、Archived のいずれであるかを記録します。これらの属性は、後続のエージェントが何を信頼し、何を確認できると想定すべきかに影響します。
• モデリングやダッシュボード作成に進む前に、テーブルの粒度、結合キー、日付列、想定される指標を含む簡潔なスキーママップを提示します。

ワークフロー

1. 対象範囲内のデータベースを一覧表示します。
2. 関連するガイドのコンテキストを読み込んでから、対象データベースのテーブルとビューを一覧表示します。
3. クエリを作成する前に、列、型、NULL 許容性、コメントを確認します。
4. 範囲、カーディナリティ、または NULL 率が回答に影響する場合は、対象を絞ったプロファイリングやSUMMARIZEを使用します。カタログ検索で広範なスキャンは避けます。
5. SELECT * ... LIMIT nまたはUSING SAMPLEで行をプレビューします。幅の広いテーブルでも、必要な行グループのみが読み込まれます。粒度と結合に関する前提を記録してから、分析用 SQL やモデリングに進みます。

参考資料

現在のタスクに必要な参考セクションのみを読みます。

• SQL ワークフロー全体、共有の検出パターン、MCP ツールのガイダンス、よくある探索上の誤りについては、references/EXPLORATION_PLAYBOOK.mdを読みます

関連スキル

不足している機能を補う場合にのみ関連スキルを読み込み、既存のコンテキストを再利用します。

• セッションのセットアップと認証にはmotherduck-connect
• スキーマを把握した後の分析用 SQL にはmotherduck-query
• 探索時の DuckDB 構文パターンにはmotherduck-duckdb-sql
• 共有データセットがワークフローに含まれるようになった後の共有の作成と利用にはmotherduck-share-data
• 検出したオブジェクトに関連付けられたコンテキストの読み取りや管理にはmotherduck-manage-guides