SKILLOfficialdevelopment

idmp-dashboard

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

説明

IDMP ダッシュボード管理スキルダッシュボード（データを視覚的に整理・表示する画面）の一覧表示、詳細情報の閲覧、レイアウトと表示順序の変更、安定したダッシュボードのテンプレート化、そしてダッシュボードとパネル（個別の情報表示部品）のライフサイクル（生成から廃止までの各段階）を独立して管理する機能を提供します。

原文を表示

IDMP dashboard skill for listing dashboards, reading details, updating layout and order, templating stable dashboards, and keeping dashboard lifecycle separate from panel lifecycle.

ユースケース

ダッシュボードの一覧を確認したい
ダッシュボードの詳細情報を閲覧する
ダッシュボードのレイアウトを変更する
ダッシュボードをテンプレート化する
ダッシュボードのライフサイクルを管理する

本文（日本語訳）

ダッシュボード

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

書き込み操作の前に: 🛑 破壊的操作の確認プロトコルに従ってください。読み取り専用のコマンドはそのままですが、削除・書き込み・修正の操作では、共有の確認ゲートが必要です。

推奨ショートカット

ショートカット	用途
`+list`	ある要素の配下にあるダッシュボードを一覧表示します。
`+search`	ダッシュボードをシステム全体から検索します。
`+templates`	ある要素で利用できるダッシュボードテンプレートを一覧表示します。

推奨リファレンス

先に解決が必要なコンテキスト

コンテキスト	作成または更新の前に必要な理由
所有要素	ダッシュボードの一覧表示、取得、作成、順序変更、またはテンプレート化を行う前に、最終的な `elementId` が必要です。
ダッシュボード名の候補	`dashboard.dashboards.new-name` には `elementId` と提案する `name` の両方が必要です。
パネル配置計画	ダッシュボードに表示するパネルIDを決定し、パネル作成を先に行うかどうかを判断します。
所有要素の更新間隔	ダッシュボードの更新間隔（自動更新の頻度）は `dashboard.params` に含まれるため、ダッシュボード本体が更新間隔の動作を持つかどうかを把握する必要があります。
検証対象	最終確認を、レイアウト再確認、パネル構成、順序、テンプレート準備状況、またはそのすべてのどれにするかを決定します。

制限された動作ルール

dashboard.dashboards.new-name は候補となる name が必須です。所有要素スコープだけで呼び出さないでください。
refreshInterval（更新間隔）は dashboard.params に属し、トップレベルのフィールドではありません。
パネルを作成しても、それは自動的にダッシュボードに追加されません。ダッシュボードへの追加は別の更新操作が必要です。
make-top は順序変更のみを行います。レイアウト編集やダッシュボード内容の更新には使用できません。
ダッシュボードを削除または編集しても、その中のパネルは自動的に削除されません。
ダッシュボードからパネルを削除する場合、ダッシュボードレイアウトと独立したパネル在庫の両方を再度読み取ることで検証が必要です。ダッシュボードの更新だけではパネルオブジェクト自体は削除されません。
パネルの構成を変更した後、変更が完了したと判断する前に、ダッシュボードと独立したパネル在庫の両方を再度読み取ってください。

完了の証拠

ダッシュボード作成は、dashboard dashboards get または dashboard dashboards list が意図した所有要素を持つ新しいダッシュボード枠を返した時点でのみ完了です。
レイアウトまたはパネル構成の更新は、ダッシュボードの再読み取りと独立したパネル在庫の両方が意図した状態を反映した時点でのみ完了です。
順序変更は、再読み取りで新しい位置が表示された時点でのみ完了です。make-top だけでは十分な確認にはなりません。

保持すべき製品の仕様

ダッシュボードを変更する前に、list で一覧を読み取り、次に get で詳細を読み取ってください。
ダッシュボード枠を作成する前に、候補となる name を指定して new-name を使用してください。
refreshInterval は dashboard.params に属し、トップレベルのフィールドではありません。
パネルを作成しても、ダッシュボードに自動的には追加されません。ダッシュボードへのパネル追加は別途管理します。
ダッシュボードを削除または変更しても、その中のパネルは自動的には削除されません。
dashboard.panels からパネルを削除した後、レイアウト変更が完了したと判断する前に、ダッシュボードとパネル在庫の両方を再度読み取ってください。

主要コマンド

idmp-cli schema dashboard.dashboards.list
idmp-cli dashboard dashboards list --params '{"elementId":123}'

idmp-cli schema dashboard.dashboards.get
idmp-cli dashboard dashboards get --params '{"elementId":123,"dashboardId":456}'

idmp-cli dashboard dashboards search --params '{"keyword":"energy","current":1,"size":20}'
idmp-cli dashboard dashboards new-name --params '{"elementId":123,"name":"demo-dashboard"}'

idmp-cli dashboard dashboards create --dry-run --ack-risk --params '{"elementId":123}' --data '{...}'
idmp-cli dashboard dashboards update --dry-run --ack-risk --params '{"elementId":123,"dashboardId":456}' --data '{...}'
idmp-cli dashboard dashboards make-top --ack-risk --params '{"elementId":123,"dashboardId":456}'
idmp-cli dashboard dashboards make-top --dry-run --ack-risk --params '{"elementId":123,"dashboardId":456}'

idmp-cli dashboard dashboard-templates list --params '{"elementId":123}'

例外とエラー処理

パネルが存在しているのにダッシュボードに表示されていない場合、ダッシュボードを明示的に更新してください。パネル作成だけでは不十分です。
refreshInterval がダッシュボード params の外に配置されている場合、ダッシュボードは意図したとおりに動作しません。ペイロード（送信データ）を修正してから再試行してください。
make-top が成功した場合、順序変更だけが行われることを予期してください。レイアウト編集の代わりとして使用しないでください。
更新が成功しても get が古いレイアウトやパネルIDを表示している場合、別の操作を送信する前に即座に再読み取りしてください。不一致が続く場合、盲目的に再試行するのではなく、古い状態にあることを報告してください。
ダッシュボードが削除されても、パネルは個別に削除されるまで利用可能なままです。

検証シナリオ

idmp-cli schema dashboard.dashboards.list と idmp-cli dashboard dashboards list --params '{"elementId":123}' でダッシュボード一覧を読み取ります。
idmp-cli dashboard dashboards get --params '{"elementId":123,"dashboardId":456}' で1つのダッシュボードを詳細に読み取ります。
idmp-cli dashboard dashboards search --params '{"keyword":"energy","current":1,"size":20}' と idmp-cli dashboard dashboards new-name --params '{"elementId":123,"name":"demo-dashboard"}' で発見と命名を確認します。
idmp-cli dashboard dashboards update --dry-run --ack-risk --params '{"elementId":123,"dashboardId":456}' --data '{...}' で構造変更をプレビューしてから、パネル構成の変更を適用し、ダッシュボードと独立したパネル在庫の両方を再度読み取ります。
idmp-cli dashboard dashboards make-top --ack-risk --params '{"elementId":123,"dashboardId":456}' で順序とテンプレート準備状況を確認してから、同じ操作を --dry-run でプレビューし、idmp-cli dashboard dashboard-templates list --params '{"elementId":123}' でテンプレート状況を確認します。

原文（English）を表示

dashboard

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

Before any write: Follow the 🛑 Destructive op confirmation protocol. Read-only commands stay read-only here, but delete / write / patch flows still require the shared yes-gate.

Recommended shortcuts

Shortcut	Purpose
`+list`	List dashboards under one element.
`+search`	Search dashboards globally.
`+templates`	List dashboard templates available to one element.

Recommended reference

Missing context to resolve first

Context	Why it must be resolved before create or update
Owner element	You need the final `elementId` before you can list, get, create, reorder, or template dashboards.
Candidate dashboard name	`dashboard.dashboards.new-name` requires both `elementId` and a proposed `name`.
Panel placement plan	Decide which panel IDs should appear in the dashboard and whether panel creation must happen first.
Refresh owner	Dashboard refresh belongs in `dashboard.params`, so you need to know whether the dashboard shell owns refresh behavior.
Verification target	Decide whether the final proof is layout readback, panel membership, ordering, template readiness, or all of them.

Constrained live behaviors

dashboard.dashboards.new-name requires a candidate name; do not call it with only the owner scope.
refreshInterval belongs in dashboard.params, not in a top-level field.
Creating a panel does not add it to a dashboard automatically; dashboard membership is a separate update path.
make-top only changes ordering. It does not replace layout edits or dashboard content updates.
Deleting or editing a dashboard does not delete the underlying panels by itself.
Removing a panel from a dashboard must be verified by rereading the dashboard layout and the standalone panel inventory; a dashboard update does not delete the panel object.
After membership changes, reread both the dashboard and the standalone panel inventory before you conclude the change is complete.

Evidence of completion

A dashboard create is only complete when dashboard dashboards get or dashboard dashboards list returns the new shell with the intended owner.
A layout or membership update is only complete when both the dashboard reread and the standalone panel inventory reflect the intended state.
Ordering work is only complete when a reread shows the new position; make-top does not stand in for broader layout proof.

Product behavior to preserve

Read list first, then get, before changing a dashboard.
Use new-name with a candidate name before creating a dashboard shell.
refreshInterval belongs in dashboard.params, not in a top-level field.
Creating a panel does not add it to a dashboard; dashboard membership is managed separately.
Deleting or changing a dashboard does not delete the underlying panels by itself.
After removing a panel from dashboard.panels, reread both the dashboard and the panel inventory before you conclude the layout change is complete.

Key commands

idmp-cli schema dashboard.dashboards.list
idmp-cli dashboard dashboards list --params '{"elementId":123}'

idmp-cli schema dashboard.dashboards.get
idmp-cli dashboard dashboards get --params '{"elementId":123,"dashboardId":456}'

idmp-cli dashboard dashboards search --params '{"keyword":"energy","current":1,"size":20}'
idmp-cli dashboard dashboards new-name --params '{"elementId":123,"name":"demo-dashboard"}'

idmp-cli dashboard dashboards create --dry-run --ack-risk --params '{"elementId":123}' --data '{...}'
idmp-cli dashboard dashboards update --dry-run --ack-risk --params '{"elementId":123,"dashboardId":456}' --data '{...}'
idmp-cli dashboard dashboards make-top --ack-risk --params '{"elementId":123,"dashboardId":456}'
idmp-cli dashboard dashboards make-top --dry-run --ack-risk --params '{"elementId":123,"dashboardId":456}'

idmp-cli dashboard dashboard-templates list --params '{"elementId":123}'

Exception and failure handling

If a panel exists but does not appear in a dashboard, update the dashboard explicitly; panel creation alone is not enough.
If refreshInterval is placed outside dashboard params, the dashboard will not behave as intended; correct the payload before retrying.
If make-top succeeds, expect only ordering changes; do not use it as a substitute for layout edits.
If an update succeeds but get still shows an old layout or panelIds, reread immediately before sending another mutation. If the mismatch remains, report stale state instead of retrying blindly.
If a dashboard is removed, plan for panels to remain available until they are deleted separately.

Validation scenarios

Read the dashboard list with idmp-cli schema dashboard.dashboards.list and idmp-cli dashboard dashboards list --params '{"elementId":123}'.
Read one dashboard in detail with idmp-cli dashboard dashboards get --params '{"elementId":123,"dashboardId":456}'.
Check discovery and naming with idmp-cli dashboard dashboards search --params '{"keyword":"energy","current":1,"size":20}' and idmp-cli dashboard dashboards new-name --params '{"elementId":123,"name":"demo-dashboard"}'.
Preview structure changes with idmp-cli dashboard dashboards update --dry-run --ack-risk --params '{"elementId":123,"dashboardId":456}' --data '{...}', then apply the membership change and reread both the dashboard and the standalone panel inventory.
Verify ordering and template readiness with idmp-cli dashboard dashboards make-top --ack-risk --params '{"elementId":123,"dashboardId":456}', then preview the same operation with --dry-run and check idmp-cli dashboard dashboard-templates list --params '{"elementId":123}'.

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