mcpField
U
using-datahub

using-datahub

github.com/datahub-projectデータ・データベース45214 回インストール4 週間前に更新
リポジトリ

using-datahub について

カタログ関連の依頼を扱うエージェント向けの、DataHub スキル振り分けガイドです。意図に応じて Search、Enrich、Lineage、Quality、Setup に割り当て、曖昧な依頼の判定や CLI の利用帰属ルールも示します。

主な機能

  1. 015種類の DataHub スキルへの振り分け
  2. 02意図に応じたカタログ操作の判別
  3. 03系譜分析とメタデータ検索の区別
  4. 04DataHub CLI の利用帰属ガイド
  5. 05複数スキル依頼の処理ルール

活用シーン

  1. 01曖昧なカタログ依頼に適したスキルの選択
  2. 02メタデータ編集を適切なワークフローへ振り分け
  3. 03依存関係の質問とエンティティ検索の区別

インストール

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

$npx skills add https://github.com/datahub-project/datahub-skills --skill using-datahub

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

詳細

DataHub スキルの使い方

DataHub カタログを操作する 5 つのスキルを利用できます。このガイドを使って、ユーザーのリクエストに適したスキルを選択してください。

スキルの振り分け表

ユーザーの意図スキルコマンド
エンティティを検索または発見する（検索、参照、フィルタリング、一覧表示）Search/datahub-search
カタログについて質問に答える（「X のオーナーは誰ですか？」「X はいくつありますか？」）Search/datahub-search
メタデータを更新する（説明、タグ、用語集の用語、オーナーシップ、非推奨化）Enrich/datahub-enrich
リネージュを調べる（上流、下流、影響、根本原因、依存関係）Lineage/datahub-lineage
データ品質（アサーション、インシデント、ヘルスチェック）Quality/datahub-quality
通知（アサーションの失敗、インシデントの通知を購読）Quality/datahub-quality
CLI のインストール、認証、接続の確認Setup/datahub-setup
デフォルトのスコープとプロファイルを設定するSetup/datahub-setup

意図の判別ルール

意図が曖昧な場合は、次のルールを使用してください。

「タグ」に関するリクエスト
  • すべてのタグ操作（PII、機密、重要、レビュー済み、team-x）→ Enrich（一般的なメタデータ）
「ドメイン」に関するリクエスト
  • 検索対象をドメインで絞り込む → Search（範囲を指定した検索）
  • デフォルトのドメインを設定する → Setup（プロファイルの設定）
「品質」または「ヘルス」に関するリクエスト
  • 失敗したアサーション、アクティブなインシデント、ヘルスステータス → Quality
  • アサーションの作成、品質チェックの実行、インシデントの登録 → Quality
  • アサーションの失敗またはインシデントの通知を購読する → Quality
  • メタデータの品質、ドキュメント、オーナーシップの網羅状況 → Search を使ってデータを収集し、回答をまとめる
リネージュと検索の使い分け
  • 「X にデータを提供しているものは何ですか？」／「X に依存しているものは何ですか？」／「X を変更した場合の影響は何ですか？」 → Lineage
  • 「テーブル X を使用しているダッシュボードは何ですか？」 → Lineage（関係をたどる）
  • 「X のオーナーは誰ですか？」／「X とは何ですか？」 → Search（メタデータの検索）
Setup とその他のスキルの使い分け
  • 「セットアップする」／「インストールする」／「認証する」／「接続を確認する」 → Setup
  • 「デフォルトを設定する」／「デフォルトのプラットフォームを設定する」／「プロファイルを作成する」 → Setup
  • 「DataHub が動作しているか確認する」 → Setup（接続の確認）

CLI の帰属情報

datahub CLI コマンドを実行する際は、使用状況を適切に帰属できるよう、ルートコマンドに -C skill=<name> を渡してください。

datahub -C skill=datahub-search search "revenue"
datahub -C skill=datahub-enrich graphql --query '...'
datahub -C skill=datahub-lineage lineage --urn "..."

YAML のフロントマターに記載されているスキル名を使用してください。-C が認識されない場合は省略してください。省略してもコマンドは同じように動作します。

重要なルール

  1. スキルを推測してはいけません。 意図が本当に曖昧な場合は、ユーザーに確認してください。
  2. ユーザーが複数の操作を明示的に依頼した場合を除き、1 つのリクエストにつき 1 つのスキルを使用してください。
  3. Lineage はリネージュ専用です。「このエンティティは何ですか？」といった一般的な質問には使用しないでください（その場合は Search を使います）。
  4. Search はその場での質問に対応します。「X のオーナーは誰ですか？」や「X にはどのような列がありますか？」は Search に関する質問であり、Lineage ではありません。
  5. Enrich はすべてのメタデータの書き込みを扱います（説明、タグ、用語集の用語、オーナーシップ、非推奨化）。
  6. Quality はデータ品質を扱います（アサーション、インシデント、ヘルスチェック、サブスクリプション）。
  7. Setup は環境と設定を扱います（CLI のインストール、認証、接続確認、デフォルトのスコープ）。

コメント

Markdown 対応