SKILLOfficialdevelopment

idmp-data

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

説明

IDMP（医薬品規制データ管理）データの入出力スキル。次のような場合に使用: - 出力可能な基本要素を確認したい - 入出力の記録を確認したい - ファイルやデータをダウンロードしたい - パッケージの出力、ファイルのダウンロード、データの入力という3つの流れを区別して処理したい

原文を表示

IDMP data import/export skill. Use it to inspect exportable root elements, review import/export records, download artifacts, and distinguish package export, artifact download, and import flows.

ユースケース

出力可能な基本要素を確認したい
入出力の記録を確認したい
ファイルやデータをダウンロードしたい
パッケージの出力、ファイルのダウンロード、データの入力を区別して処理したい

本文（日本語訳）

データ

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

このスキルがカバーする内容

パッケージのインポート/エクスポートで利用可能なトップレベルの要素を見つける
ファイルをダウンロードする前、または失敗を調査する前に、インポート/エクスポートの記録を確認する
パッケージエクスポート、ファイルダウンロード、パッケージインポート、単一のインポート/エクスポート操作を区別する
ステータス、ファイル名、エラーメッセージについて、記録を運用者の信頼できる情報源として活用する
2つの有効なエクスポート結果の両方を受け入れる: 記録に基づいたファイルか、標準出力に直接ストリーミング（配信）されたZIPアーカイブ

推奨ショートカット

ショートカット	用途
`+roots`	インポート/エクスポートで表示される第1階層の要素を一覧表示
`+records`	インポート/エクスポートの記録を一覧表示
`+download`	既知の記録に対するファイルをダウンロード

推奨参考資料

データインポート/エクスポート読み取りフロー

インポート/エクスポート前に解決すべき重要な情報

情報の種類	インポート/エクスポート前に確認が必要な理由
ワークフロー種別	パッケージエクスポート、パッケージインポート、データベースCSVインポートでは異なる処理の流れになる
対象範囲	最終的な `elementIds`、`elementTemplateIds`、またはデータベースのスコープを事前に把握する必要がある
想定される成果物	エクスポートはZIPを標準出力に直接ストリーミングするか、後から `fileName` で参照できる記録を作成するかのいずれか
データベース情報	CSVインポートには、事前に検証された `connectionId`、`dbName`、テーブル名または安定した名前が必要
検証タイミング	処理後に `data records list` を再度確認する時期と方法を決める

制約付きの動作ルール

パッケージエクスポート、パッケージインポート、データベースCSVインポートは、推測で設定された内容やファイル名を共有してはいけない
data records list は毎回の処理後の公式な確認手段。簡潔な成功応答は最終状態ではない
data download get では、推測したパスではなく、実際の記録ファイル名を name パラメータとして使用する
エクスポートの成功には2つの有効な終わり方がある: 標準出力に出されたZIPバイトか、後から fileName で確認できる記録に基づいたファイル
大きな影響を持つインポート/エクスポート作業は、本番処理の前にスキーマ確認または --dry-run で試行する
試験的なインポートで不要な資産が作成された場合、削除は記録削除ではなく、対象となる資産の管理ワークフローで行う

運用手順

インポート/エクスポートの判断を行う前に first-level-elements から始める
ファイルをダウンロードする前、失敗を確認する前、または生成されたファイル名を確認する前に、records を読む
パッケージ作成には import-and-export export、記録が fileName を持つ場合のダウンロードには download get、アップロードには import-and-export import または single-import create を使用する
エクスポートとインポートは長時間実行または非同期で進むと予想される。CLIの応答だけでは最終確認ではない
エクスポートが既に標準出力にZIPバイトをストリーミングしている場合は、そのストリームを成果物として扱い、監査履歴のために records を再確認する
毎回の処理後に records を再確認して、ステータス、ファイル名、失敗の詳細を確認する

主要コマンド

idmp-cli schema data.first-level-elements.list
idmp-cli data first-level-elements list

idmp-cli schema data.records.list
idmp-cli data records list

idmp-cli schema data.import-and-export.export
idmp-cli data import-and-export export --ack-risk --data '{"elementIds":[123]}'

idmp-cli schema data.download.get
idmp-cli data download get --params '{"name":"export.zip"}'

idmp-cli schema data.import-and-export.import
# `data.import-and-export.import` は現在のスキーマではマルチパート形式。
# スキーマ出力をまず確認して、JSON本体を推測するのではなく、
# 正確な転送方式とフィールド（例：`jsonFile` / `taosgenFiles[]`）を使用してリクエストを構築する
idmp-cli data import-and-export import --ack-risk --data '{...}'

idmp-cli schema data.single-import.create
# `data.single-import.create` も現在のスキーマではマルチパート形式。
# スキーマ出力をまず確認して、JSON形式を推測するのではなく、
# 正確なアップロードフィールドを使用する
idmp-cli data single-import create --ack-risk --data '{...}'

例外的な状況への対応

first-level-elements が空の場合: 現在のアカウントがインポート/エクスポートのルートを見ることができるか確認してから、ファイルの問題のトラブルシューティングを行う
エクスポート呼び出しが素早く返るが、使用可能な記録が現れない場合: 標準出力に既にZIPファイルが含まれていないか確認してから再試行する
ダウンロードがファイル不見当エラーで失敗する場合: records を再度読み、name に正確なファイル名を使用するか、エクスポートが既にZIPバイトをストリーミングしている場合はダウンロードをスキップする
インポートが検証に失敗する場合: スキーマをまず確認してから、アップロード手順からの推測ではなく、records から実際の失敗原因を読む
パッケージインポート/エクスポートと単一インポート/エクスポートの結果が異なる場合: 運用者が正しいフローを選択したか確認してから再試行する

検証シナリオ

1. エクスポート元の発見

エクスポート範囲を選ぶ前に、第1階層の要素を一覧表示する:

idmp-cli data first-level-elements list

2. 記録の基準確認

何かを処理する前に、インポート/エクスポートの記録を読む:

idmp-cli data records list

3. パッケージエクスポート

既知の要素パッケージを1つエクスポートする:

idmp-cli data import-and-export export --ack-risk --data '{"elementIds":[123]}'

4. 成果物の出力先判定

記録を再度読んで、記録に基づいたファイルと、既に標準出力にストリーミングされたZIPを区別する:

idmp-cli data records list

5. 記録が fileName を持つ場合のみダウンロード

エクスポートがダウンロード可能な記録を作成した場合、報告されたファイルをダウンロードする:

idmp-cli data download get --params '{"name":"export.zip"}'

原文（English）を表示

data

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

What this skill covers

Discover which top-level elements are available for package import/export.
Review import/export records before downloading artifacts or investigating failures.
Distinguish package export, artifact download, package import, and single import/export operations.
Use records as the operator’s source of truth for status, filenames, and error messages.
Accept both valid export outcomes: a record-backed artifact or a ZIP archive streamed directly to stdout.

Recommended shortcuts

Shortcut	Purpose
`+roots`	List first-level elements visible to import/export
`+records`	List import/export records
`+download`	Download the artifact for a known record

Recommended reference

Data import/export read flows

Missing context to resolve first

Context	Why it must be resolved before import or export
Workflow type	Package export, package import, and datasource CSV import are different mutation chains.
Scope	You need the final `elementIds`, `elementTemplateIds`, or datasource scope before the write.
Expected artifact	Exports can either stream a ZIP directly to stdout or create a record that later exposes `fileName`.
Datasource context	CSV import needs a validated `connectionId`, `dbName`, and table or stable names from earlier reads.
Verification window	Decide when and how you will reread `data records list` after the write.

Constrained live behaviors

Package export, package import, and datasource CSV import must not share guessed payloads or filenames.
data records list is the authoritative confirmation after every write; a quick success response is not the final state.
data download get must use the real record artifact name as the name path parameter, not a guessed path.
A successful export can end in two valid ways: ZIP bytes on stdout or a later record-backed artifact with fileName.
High-impact import or export work should start with schema inspection or --dry-run before the real write.
If a probe import creates assets you do not want to keep, cleanup belongs to the owning asset workflow, not to record deletion.

Operator workflow

Start with first-level-elements before any export or import decision.
Read records before downloading an artifact, reviewing a failure, or confirming the generated filename.
Use import-and-export export for package creation, download get only when a record exposes fileName, and import-and-export import or single-import create for uploads.
Expect exports and imports to be long-running or asynchronous; the CLI response alone is not the final confirmation.
If export already streamed ZIP bytes to stdout, treat that stream as the artifact and still re-check records for audit history.
Re-check records after every write to confirm status, artifact name, and failure details.

Key commands

idmp-cli schema data.first-level-elements.list
idmp-cli data first-level-elements list

idmp-cli schema data.records.list
idmp-cli data records list

idmp-cli schema data.import-and-export.export
idmp-cli data import-and-export export --ack-risk --data '{"elementIds":[123]}'

idmp-cli schema data.download.get
idmp-cli data download get --params '{"name":"export.zip"}'

idmp-cli schema data.import-and-export.import
# `data.import-and-export.import` is multipart/form-data in the current schema.
# Inspect the schema output first and build the request with the exact transport and fields
# (for example `jsonFile` / `taosgenFiles[]`) instead of assuming a plain JSON body.
idmp-cli data import-and-export import --ack-risk --data '{...}'

idmp-cli schema data.single-import.create
# `data.single-import.create` is also multipart/form-data in the current schema.
# Inspect the schema output first and use the exact upload fields instead of guessing a JSON DTO.
idmp-cli data single-import create --ack-risk --data '{...}'

Exception paths

first-level-elements is empty: confirm the current account can see any import/export roots before troubleshooting files.
The export call returns quickly but no usable record appears: check whether stdout already contains a ZIP artifact before retrying.
A download fails with file-not-found behavior: re-read records, use the exact artifact name as name, or skip download when the export already streamed ZIP bytes.
An import fails validation: inspect the schema first, then read records for the real failure reason instead of guessing from the upload step.
Package and single import/export results differ: confirm the operator chose the correct flow before retrying.

Validation scenarios

1. Export root discovery

List first-level elements before choosing an export scope:

idmp-cli data first-level-elements list

2. Record baseline

Read import/export records before writing anything:

idmp-cli data records list

3. Package export

Export one known element package:

idmp-cli data import-and-export export --ack-risk --data '{"elementIds":[123]}'

4. Artifact branch detection

Re-read records and distinguish a record-backed artifact from a ZIP that was already streamed to stdout:

idmp-cli data records list

5. Download only when the record exposes fileName

Download the reported artifact when the export created a downloadable record:

idmp-cli data download get --params '{"name":"export.zip"}'

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