dce

dce CLI

ユーザーから dce の操作、API コマンドの調査、または API タスクに適した生成済みコマンドの検索を依頼された場合に、このスキルを使用します。

ワークフロー

1. dce search "<intent>" --json で候補を検索します。必要に応じて --limit を使用します。検索は候補の発見にのみ使用します。
2. 慣れていないコマンドを実行する前に、dce commands show <path...> --json で正確なコマンドを確認します。
3. コマンド詳細で auth.required=true の場合は、実行前に dce auth status -o json を実行し、hostname と source を確認します。ホストの解決順序は、--hostname > $DCE_HOST > 選択済みホスト（dce auth use <host>）> http.default_hostname > hosts.yml 内の単一ホストです。該当するものがない場合は停止し、ユーザーに認証するかホストを選択するよう依頼します。
4. commands show でフラグ、本文、認証、HTTP パス、mutation、dry_run、出力に関するヒントを確認してから実行します。mutation が read 以外の場合、dry_run.mode が http_preview なら --<dry_run.flag> を指定してプレビューします。プレビューを利用できない場合は、実行前にユーザーから明示的な確認を得ます。

一般コマンド

• dce commands --json：生成済みコマンドの全カタログ。
• dce commands --include-hidden --json：非表示の生成済みコマンドを含めます。
• dce commands show <path...> --json：1 つのコマンドの信頼できる情報源。
• dce commands schema --json：カタログのスキーマバージョン、サーフェス、ドライラン結果の形式。
• dce search "<intent>" --json：候補コマンドを順位付けして表示します。
• dce auth status -o json：解決された hostname とその source、選択済みの selected ホスト、ログイン済みのすべてのホスト。

メンテナンスコマンド

• dce --version または dce -v：CLI のビルドバージョンを表示します。

参照資料

• コマンドの検出手順とカタログのフィールドの意味については、references/catalog.md を読みます。
• ai-lab モジュールのコマンドインデックスについては、references/modules/ai-lab.md を読みます。
• billing-center モジュールのコマンドインデックスについては、references/modules/billing-center.md を読みます。
• business-cockpit モジュールのコマンドインデックスについては、references/modules/business-cockpit.md を読みます。
• container-management モジュールのコマンドインデックスについては、references/modules/container-management.md を読みます。
• elasticsearch モジュールのコマンドインデックスについては、references/modules/elasticsearch.md を読みます。
• global-management モジュールのコマンドインデックスについては、references/modules/global-management.md を読みます。
• insight モジュールのコマンドインデックスについては、references/modules/insight.md を読みます。
• kafka モジュールのコマンドインデックスについては、references/modules/kafka.md を読みます。
• llm-studio モジュールのコマンドインデックスについては、references/modules/llm-studio.md を読みます。
• microservice-engine モジュールのコマンドインデックスについては、references/modules/microservice-engine.md を読みます。
• minio モジュールのコマンドインデックスについては、references/modules/minio.md を読みます。
• mongodb モジュールのコマンドインデックスについては、references/modules/mongodb.md を読みます。
• mysql モジュールのコマンドインデックスについては、references/modules/mysql.md を読みます。
• operations-management モジュールのコマンドインデックスについては、references/modules/operations-management.md を読みます。
• postgresql モジュールのコマンドインデックスについては、references/modules/postgresql.md を読みます。
• rabbitmq モジュールのコマンドインデックスについては、references/modules/rabbitmq.md を読みます。
• redis モジュールのコマンドインデックスについては、references/modules/redis.md を読みます。
• rocketmq モジュールのコマンドインデックスについては、references/modules/rocketmq.md を読みます。
• seaweedfs モジュールのコマンドインデックスについては、references/modules/seaweedfs.md を読みます。
• virtual-machines モジュールのコマンドインデックスについては、references/modules/virtual-machines.md を読みます。
• workbench モジュールのコマンドインデックスについては、references/modules/workbench.md を読みます。

ルール

• コマンド名からフラグやリクエストボディの形式を推測しないでください。
• 検索結果から直接実行せず、まず commands show で確認してください。
• mutation が read 以外の場合、dry_run.mode が http_preview なら、実行前にプレビューしてください。プレビューを利用できない場合は、実行前にユーザーから明示的な確認を得てください。unknown を安全な読み取りとして扱わないでください。
• ユーザーが人間に読みやすい出力を求めていない限り、機械可読なコマンド出力には -o json を優先してください。
• -o json または -o yaml を使う場合は、error.code とプロセスの終了ステータスに基づいて処理を分岐してください。error.message と error.hint は安全なユーザー向けガイダンスであり、任意の HTTP コンテキストとして利用できるのは error.http.status のみです。
• 設定されたストリームの一時停止は成功です（exit 0）。エラーとして扱うのではなく、一時停止イベントに対応する収集済みの出力フィールドを確認してください。
• 収集済みストリームでは、次のいずれかのモードを選んでください。安定した単一ドキュメントには -o json、カタログに output.streaming.policy.live がある場合はデフォルトの出力モードで --stream、ワイヤーイベントには -o raw を使用します。
• JSON リクエストボディには、commands show のボディ要件に従って --file、--set、または --set-str を使用してください。
• body.runtime_schema がある場合、通常の実行では対象のリクエストを送る前にスキーマを取得して検証します。http_preview のドライランではネットワークを使用せず、この事前検証をスキップします。
• 機密情報を扱うフラグには、flags[].input_modes にある安全なモード（--<flag>-env、--<flag>-file、または --<flag>-stdin）を優先してください。

モジュールの利用可否

カタログ（dce commands / dce search）には、dce のビルド時に組み込まれたすべてのモジュールが一覧表示されます。対象ホストに実際にインストールされているモジュールだけが表示されるわけではありません。カタログにコマンドが表示されても、そのモジュールがデプロイされているとは限りません。

モジュールパスのレベルで 404 / route-not-found が発生した場合（特定のオブジェクトではなく、API ルート自体が存在しない場合）、モジュールがインストールされていないか、パスまたはバージョンが間違っている可能性があります。このような 404 が発生した場合は、結論を出す前に必ず積極的に確認してください。dce global-management about list-g-product-versions -o json を実行します（global-management は常に存在する基本モジュールであり、必ず利用できます）。その後、次のように対応してください。

• モジュールが一覧にない → このホストにはインストールされていません。再試行したり、同じモジュール内の関連コマンドを試したり、ユーザーにその機能があると伝えたりしないでください。モジュールがインストールされていないことを明確に伝えてください。
• モジュールが一覧にある → インストール済みであり、この 404 はモジュールの欠落が原因ではありません。dce commands show <path...> --json でパスとパラメーターを再確認してください（パスまたはバージョンが間違っているか、リソースレベルの not-found の可能性があります）。モジュールが見つからないと報告しないでください。
• リソースレベルの 404（正常に動作しているモジュールで、特定の ID／名前が見つからない場合）は、そのオブジェクトが存在しないことを意味し、モジュールの欠落を示すものではありません。通常どおり対処してください。