motherduck-build-dashboard

アナリティクスダッシュボードを作成する

まず確認：MotherDuck サーバーは起動していますか？

起動中のリモート MotherDuck MCP サーバーまたはローカル MotherDuck サーバーを使って、対象データベース、スキーマ、粒度、キー、関連するメトリクスを確認します。既知のコンテキストを再利用し、探索は依頼された作業に絞ります。デフォルトではワークスペース全体をスキャンしないでください。実際のデータモデルに沿って結果を作成します。

依頼またはアクティブなコンテキストから対象を特定します。曖昧さが結果に大きく影響する場合にのみ、確認してください。サーバーがない場合は、提供されたスキーマと明示した前提を使って計画を立て、ライブ検証を行ったかのように示さないでください。

ダッシュボードのデフォルト設定

• ダッシュボードごとに、伝えるストーリーは1つにします。
• レスポンシブな KPI グループ、主要チャート、意思決定に役立つ補足情報から始めます。質問やデータに応じてセクションを追加してください。これらはデフォルトであり、チャート数を固定するものではありません。
• 複雑なデータ整形は React ではなく SQL で行います。
• ダッシュボードからアクション（承認、更新、送信）を実行する必要がある場合は、Flight を実行する書き戻しボタンを追加します。motherduck-create-dive を参照してください。
• 閲覧者は Dive の AI Chat で追加の質問ができるため、セクション名とメトリクス名はビジネス用語にします。

ワークフロー

1. 利用可能な MotherDuck サーバー、または提供されたスキーマのコンテキストを確認します。
2. 関連するルート／ドメインのガイドを読み、実際のスキーマを調べて、管理されたメトリクスを検証します。
3. ダッシュボードのストーリーを決めます。
4. セクションごとにクエリを1つ作成します。
5. 新しいダッシュボードを作成する場合、またはレイアウトを変更する場合は、motherduck-design-dive のレスポンシブデザインとテーマに関するガイダンスを使用します。範囲を限定した SQL またはテキストの編集では、既存のデザインを維持します。
6. Dive でダッシュボードを構成します。MotherDuck MCP が利用可能な場合は、Dive のコードを記述する前、および save_dive または update_dive を呼び出すたびに、get_dive_guide を呼び出します。
7. 依頼に Dive の作成または更新が含まれる場合は、レスポンシブデザイン、テーマ、クエリ状態、データを検証してから保存します。依頼された対象範囲内の書き込みに、追加の承認プロセスを設けないでください。
8. 保存した Dive を読み戻します。作業中のものは Draft のままにし、依頼された成果物の検証が完了した後にのみ Ready にします。既存の信頼できる回答を作り直す前に、Endorsed Dives を再利用します。

依頼に合わせて実行内容を調整します。回答、レビュー、計画の依頼には、求められたダッシュボード成果物を返します。構築または変更の依頼には、対象範囲内の Dive を作成または更新し、検証します。破壊的な置き換え、無関係な外部への書き込み、または対象範囲の大幅な拡張の前には、確認してください。

このスキルでネイティブ DuckDB（md:）接続を作成する場合は、custom_user_agent=agent-skills/2.6.0(harness-<harness>;llm-<llm>) を付与します。メタデータがない場合は、harness-unknown と llm-unknown を使用します。

出力

依頼に関連する範囲で、完全な作業では次の内容を含めます。

• ダッシュボードのストーリー
• セクションの一覧
• セクションごとの検証済み SQL
• Dive の実装計画
• 保存／更新の手順

明示的に構造化 JSON を求められた場合は、出力仕様を読んでください。それ以外の場合は、依頼された成果物に合う形式を使用します。

参考資料

タスクに関連するセクションのみを読みます。これらはガイダンスであり、必須の手順ではありません。

• references/DASHBOARD_IMPLEMENTATION_GUIDE.md -- セクションと SQL の対応付け、TSX の構成、検証例
• references/DASHBOARD_PATTERNS.md -- ダッシュボード構成例と再利用可能なセクション

例

同梱の例を実行する場合、またはその検証を再現する場合にのみ、実行リファレンスを読んでください。

• dashboard_story_example.py
• dashboard_story_example.ts

関連スキル

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

• motherduck-explore -- ダッシュボードのセクションを決める前に、実際のデータベースを調査します
• motherduck-query -- 各ダッシュボードクエリを検証します
• motherduck-create-dive -- useSQLQuery、テーマ設定、プレビューと保存、読み込み、ビジュアルの仕組みを扱います
• motherduck-design-dive -- レスポンシブレイアウト、フィルター容量、ライト／ダークテーマのトークン、再利用可能なコンポーネント、ビジュアルの品質確認を扱います
• motherduck-duckdb-sql -- 構文や関数に関する疑問を解決します