mcpField
M
motherduck-cli

motherduck-cli

github.com/motherduckdbデータ・データベース62119 回インストール3 日前に更新
リポジトリ

motherduck-cli について

データワークフローで MotherDuck CLI を使うためのスキルです。認証やクエリ、Dive、Flight、Guide の編集と公開を慎重に進める方法を案内します。

主な機能

  1. 01CLI の状態と認証の確認
  2. 02クエリと JSON 出力の手引き
  3. 03Dive と Flight のローカル作業
  4. 04Guide のバージョン管理と公開
  5. 05リモート変更の安全策

活用シーン

  1. 01自動化から MotherDuck クエリを実行
  2. 02公開前に Dive を編集して検証
  3. 03Guide の変更を Git に紐付け
  4. 04リモートリソースを変更せず CLI 作業を計画

MCP 対応

ファイル操作、自動化、大きな結果には CLI、チャットでの探索やインライン回答には MCP を使うよう案内します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/motherduckdb/agent-skills --skill motherduck-cli

インストール後、Claude Code で/motherduck-cliを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yamlreferences/CLI_PLAYBOOK.md

詳細

MotherDuck CLI を使用する

信頼できる情報源

  • 現行の MotherDuck CLI ドキュメントとコマンドリファレンスを優先してください。コマンドの仕様は変わることがあるため、記憶しているフラグに頼る前にコマンドのヘルプを確認してください。
  • Dive または Flight を作成または編集する前に、motherduck dive guide または motherduck flight guide を実行してください。組み込みガイドは、現在の実行時の仕様です。
  • 構文解析エラーやオプションエラーが発生した場合は、構文を推測せずに motherduck <command> --help を使用してください。

基本方針

  • 認証済みの CLI が利用できる場合は再利用し、ログインを開始する前に motherduck status で確認してください。
  • 自動化では、MOTHERDUCK_TOKEN を環境変数経由で渡し、並行するエージェント間で認証情報やアセットを共有しないよう、タスク専用の絶対パスを MOTHERDUCK_HOME に設定してください。
  • 機械可読なリソース操作には --output json を指定し、終了コードと返された success フィールドの両方を確認してください。motherduck query --output json は、代わりに JSON 配列をそのまま返します。
  • 大きなクエリ結果は、すべての行をモデルのコンテキストに取り込むのではなく、ファイルにリダイレクトしてください。
  • 認証が不足しているという理由だけで motherduck new を実行してはいけません。アカウントの作成には、明示的なサインアップの依頼が必要です。
  • Guides は motherduck guide init|pull|push を使ってファイルとして管理してください。push は作成または更新を行い、内容に変更があった場合にのみバージョンを追加します。Git SHA は --external-id で、理由は --version-description で記録してください。pull はローカルファイルを上書きするため、先にローカルの編集内容をプッシュするか保存してください。
  • dive push、flight push、guide push、スケジューリング、シークレットの変更、アカウントの作成は、外部への変更を伴う操作として扱ってください。ユーザーの作成・変更依頼にその結果が含まれる場合にのみ実行してください。

ワークフロー

  1. ホストプロジェクトと既存の CLI／認証状態を調べます。
  2. 必要な場合に限り、現行のプラットフォーム別ドキュメントに従ってインストールまたはアップグレードします。
  3. タスクの内容に応じて CLI と MCP のどちらを使うか選択します。
    • ファイル、ローカル編集、CI、大きな結果、または反復作業の場合：CLI
    • チャットのみでの調査、インラインの回答、またはファイルシステムを使わない場合：MCP
    • 混在するワークフローの場合：MCP で調査し、その後 CLI でローカルファイルから作成します
  4. クエリには motherduck query を使い、適切な範囲で最小の出力形式を指定します。
  5. Dive または Flight の場合は、組み込みガイドを読み、ローカルプロジェクトをプルまたは初期化してから、ファイルを編集し、検証またはプレビューを行います。公開を依頼された場合にのみプッシュしてください。
  6. JSON 出力からリソース ID、URL、または実行番号を取得し、変更後にリモートの状態を確認します。

回答、レビュー、計画の依頼では、ログイン、アカウント作成、リモートリソースの変更を行わずに、コマンドを提案してください。明示的な作成・変更依頼では、対象範囲内の CLI ワークフローを完了し、結果を検証してください。破壊的な削除や、対象範囲を大幅に超える外部変更を行う前には確認してください。

リファレンス

現在のタスクに必要なリファレンスセクションのみを読みます。

  • インストール、認証、JSON の仕様、クエリのパターン、エージェントの分離、Dive／Flight のファイルを使った一連のワークフローについては、references/CLI_PLAYBOOK.md を読んでください。

関連スキル

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

  • 基盤となるアプリケーションの接続方法の選択には motherduck-connect
  • カタログの探索と SQL の動作については motherduck-explore と motherduck-query
  • 製品固有の作成ワークフローについては motherduck-create-dive と motherduck-create-flight

コメント

Markdown 対応