motherduck-partner-delivery

パートナー向けデリバリー

はじめに：MotherDuck サーバーは稼働していますか？

稼働中のリモート MotherDuck MCP サーバーまたはローカル MotherDuck サーバーを使用して、対象データベース、スキーマ、粒度、キー、および関連する指標を確認します。既知のコンテキストを再利用し、依頼された作業に合わせて調査範囲を絞ります。デフォルトではワークスペース全体をスキャンしないでください。実際のデータモデルに基づいて結果を作成します。

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

デリバリーのデフォルト

• クエリ実行時のテナントフィルタリングより、構造的な分離を優先します
• クライアントごとにデータベースを 1 つ用意するか、それ以上に強固な境界を設けます
• アーキテクチャは共有し、スキーマはクライアントごとに用意します
• クライアントごとに明示的な共有と取り消しを行います
• プロビジョニング、検証、引き継ぎ、例外追跡用のバージョン管理されたテンプレートを用意します
• クライアントごとのプロビジョニングには Terraform (motherduckdb/motherduck) を使用します。データベース、共有と権限付与、ロール、シークレット、サービスアカウントを作成し、クライアント名を記載した説明を付けます
• 管理されたテーブル単位のデリバリーに適する場合は、対象者ごとのインクルードパターンを指定したロール付与済みの制限付き Shares を使用します。クライアントの対象者に行、列、またはマスキングのルールが必要な場合は、セキュアビューも使用します
• クライアント固有の参照定義と例外を含む、再利用可能な Guide トピックのレイアウトを用意します

ワークフロー

1. 利用可能な MotherDuck サーバーまたは提供されたクライアントのコンテキストを確認します。
2. クライアントのパターンを分類します。
3. 利用可能な場合は、既存のリージョンおよびデータベースのレイアウトを確認します。
4. アーキテクチャとプロビジョニングの経路を標準化します。
5. すべてのクライアント環境で繰り返し実行できる検証パックを定義します。
6. Guide の保守が対象範囲に含まれる場合は、標準規約とクライアント固有の例外をまとめた参照用 Guide を作成または更新します。
7. ロール、権限付与、インクルードパターン、およびリージョン固有の利用可能状況を監査します。
8. 引き継ぎ用の成果物と検証チェックを作成します。

依頼に合わせて実行内容を調整します。回答、レビュー、または計画作業では、依頼されたデリバリー成果物を返します。構築または変更作業では、依頼された対象範囲内のテンプレートまたはクライアント資産を作成し、検証します。追加のクライアント環境のプロビジョニング、破壊的な変更、またはすでに許可されていない外部への書き込みを行う前に、確認してください。

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

出力

全面的なエンゲージメントでは、依頼に関連する以下の項目を扱います。

• デフォルトのマルチクライアントパターン
• 標準のプロビジョニングチェックリスト
• リージョンおよび分離に関する方針
• クライアント固有の例外

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

参考資料

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

• references/PARTNER_DELIVERY_GUIDE.md -- デフォルトのマルチクライアントパターン、標準化とクライアント固有の区分、Shares・Dives・アプリの選択、リージョンおよびコンプライアンスへの対応、プロビジョニングのひな形

例

同梱の例を実行する場合、またはその検証を再現する場合に限り、実行リファレンスを参照してください。

• client_delivery_example.py
• client_delivery_example.ts

関連スキル

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

• motherduck-connect -- 接続経路を標準化します
• motherduck-explore -- 既存のクライアントワークスペースと境界を確認します
• motherduck-model-data -- クライアント固有のスキーマを設計します
• motherduck-query -- 主要な指標とデータ契約を検証します
• motherduck-share-data -- 管理された共有境界を公開します
• motherduck-create-dive -- 必要に応じて、クライアント向けの回答面を繰り返し作成できるようにします