claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 1h ago
スキルOfficialdevelopment

🔍idmp-workflow-datasource-diagnose

プラグイン
idmp-plugin
ソース
GitHub で見る ↗

説明

**IDMP データソース診断ワークフロー** 接続の確認、接続性の検証、データベースとメタデータ（データの構造や属性に関する情報）の検査、モデルのマッピング（対応づけ）の比較を行います。プローブ（接続状態の確認）または書き込み操作のあとは、毎回その結果を再度読み込んで確認します。

原文を表示

IDMP datasource diagnosis workflow. Read the connection, probe connectivity, inspect databases and metadata, compare model mappings, and reread after every probe or write.

ユースケース

  • ✓接続の確認と検証をするとき
  • ✓データベースとメタデータを検査するとき
  • ✓モデルのマッピングを比較するとき
  • ✓プローブ後に結果を確認するとき
  • ✓書き込み操作後に結果を再度確認するとき

本文（日本語訳）

ワークフロー: データソース診断

まず最初に ../idmp-shared/SKILL.md をお読みください。

推奨される参考資料

先に確認が必要な情報

  • 認証情報（どこから取得するのか）
  • 読み込み直しの内容
  • オペレータが問題と考えている接続先・データベース・テーブル
  • トラブルの内容が「接続の到達可能性」「メタデータの見える範囲」「データ形式のズレ」のどれなのか
  • どの要素またはテンプレートマッピングをソースのメタデータと照らし合わせるべきか

動作上の制限

  • connections get の結果を connectivity create にコピーしてはいけない
  • 組み込みの TDengine リスナー（監視役）については datasource check list を使用する
  • 書き込みを伴う検査やインポート後は、必ず読み込み直しを行う
  • 接続可能性の検査前に接続オブジェクトを読み込む
  • 追加プロパティとメタデータは参考情報であり、実際の接続可能性の検査に代わるものではない
  • メタデータ診断は順序を守る: 接続 → 検査 → データベース → テーブル → カラム → データモデルマッピング

実行の流れ

  1. 何らかの検査を行う前に、idmp-cli datasource connections list と idmp-cli datasource connections get --params を読み込む
  2. idmp-cli datasource additional-properties list-get --params でデータソース側の背景情報を収集する
  3. idmp-cli datasource check list を読み込み直してから idmp-cli datasource connectivity create --ack-risk --data を実行し、全体的な状態と実際の接続可能性を分けて評価する
  4. idmp-cli datasource dbnames list --params、idmp-cli datasource tablenames list --params、idmp-cli datasource columninfo create --ack-risk --params でメタデータの範囲を確定させる
  5. そのメタデータを idmp-cli attr-template elements attributes --params と照らし合わせ、診断に書き込みを伴う CSV 検査が含まれる場合だけ idmp-cli datasource csv create --ack-risk --params を使う
  6. 診断がインポートやエクスポートの履歴に関わる場合は、idmp-cli data records list を読み込み直す

例外的な対応

  • 接続可能性の検査が失敗した場合、メタデータ読み込みと datasource check list に戻り、テーブルの欠落をスキーマのバグと解釈する前に判断する
  • メタデータが存在するのにデータモデルが合わない場合は、カラムまたはマッピングの具体的なズレを報告する
  • 記録の履歴がない場合は、その原因が「データ取り込み時点の欠落」なのか「データソース側の見える範囲の問題」なのかを述べ、接続性が根本原因かどうかを確認する

検証シナリオ

1. リスナー（監視役）の健全性確認

idmp-cli datasource connections list と idmp-cli datasource connections get --params から始め、その後 idmp-cli datasource check list を実行する

2. マスク済みペイロードの接続障害の特定

マスク対応の接続読み込み後、idmp-cli datasource connectivity create --ack-risk --data を使用する。到達可能性の障害から機密情報を探し出すことのないようにする

3. メタデータとデータモデルのズレ

idmp-cli datasource columninfo create --ack-risk --params と idmp-cli attr-template elements attributes --params を組み合わせる。結果は具体的なマッピングのズレを示すべき

4. テーブル発見の失敗

idmp-cli datasource dbnames list --params と idmp-cli datasource tablenames list --params を順番に実行する。失敗した段階がそのまま報告の対象となる

5. 診断中の CSV インポート履歴

データソースの問題がデータ取り込みに関わる場合、idmp-cli data records list を読み込み直す。記録の履歴と接続性の情報は分けて管理する

原文（English）を表示

workflow: datasource diagnose

Read ../idmp-shared/SKILL.md first.

Recommended references

Missing context to resolve first

  • Credential source.
  • Verification rereads.
  • The target connection, database, or table that the operator thinks is broken.
  • Whether the complaint is reachability, metadata visibility, or model mismatch.
  • Which element or template mapping should be compared back to source metadata.

Constrained live behaviors

  • Do not copy connections get into connectivity create.
  • datasource check list for the built-in TDengine listener.
  • After any write-like probe or import, reread.
  • Read the connection object before probing reachability.
  • Additional properties and metadata are evidence; they do not replace a live connectivity probe.
  • Metadata diagnosis stays ordered: connection -> probe -> db -> table -> column -> model mapping.

Execution flow

  1. Read idmp-cli datasource connections list and idmp-cli datasource connections get --params before any probe.
  2. Use idmp-cli datasource additional-properties list-get --params to capture datasource-side context.
  3. Reread idmp-cli datasource check list and then run idmp-cli datasource connectivity create --ack-risk --data to separate summary health from live reachability.
  4. Use idmp-cli datasource dbnames list --params, idmp-cli datasource tablenames list --params, and idmp-cli datasource columninfo create --ack-risk --params to lock the metadata boundary.
  5. Compare that metadata with idmp-cli attr-template elements attributes --params, and use idmp-cli datasource csv create --ack-risk --params only when the diagnosis includes a write-like CSV probe.
  6. Reread idmp-cli data records list if the diagnosis also touches import or export traces.

Exception paths

  • If the connectivity probe fails, fall back to datasource check list plus metadata reads before interpreting missing tables as schema bugs.
  • If metadata exists but the model does not match, report the exact column or mapping mismatch.
  • If record traces are absent, say whether the gap is ingestion history or datasource visibility. Capture whether the root cause is connectivity.

Validation scenarios

1. Listener health confirmation

Start with idmp-cli datasource connections list and idmp-cli datasource connections get --params. Only then run idmp-cli datasource check list.

2. Redacted-payload connectivity failure isolation

Use idmp-cli datasource connectivity create --ack-risk --data after a redaction-aware connection read. Reachability failures should not trigger secret hunting.

3. Metadata versus model mismatch

Pair idmp-cli datasource columninfo create --ack-risk --params with idmp-cli attr-template elements attributes --params. The result should name the exact mapping mismatch.

4. Table discovery failure

Walk idmp-cli datasource dbnames list --params and idmp-cli datasource tablenames list --params in order. The failing step should become the reported boundary.

5. CSV import trace during diagnosis

If the datasource complaint touches ingestion, reread idmp-cli data records list. Keep record-trace evidence separate from connectivity evidence.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。