SKILLOfficialdevelopment

preset-cli

プラグイン: preset-cli-skills
ソース: GitHub で見る ↗

説明

Preset公式の`sup`コマンドラインツール（PyPiパッケージ名：`superset-sup`）を、シェルスクリプト、自動化スクリプト、CI/CD（継続的インテグレーション・デリバリー、開発から本番までの自動化パイプライン）、およびエージェント駆動（自動判断で動作するシステム）のワークフローで活用します。 **使用範囲：** CLIワークフロー専用です。MCP単独での作業や、直接HTTP/SDK（ソフトウェア開発キット）のコード実装には使用しないでください。

原文を表示

Drive Preset's `sup` CLI (PyPI package `superset-sup`) for shell, scripting, CI/CD, and agent-driven Preset workflows. Use only for CLI workflows; Do not use for MCP-only work or for direct HTTP/SDK code paths.

ユースケース

シェルスクリプトで自動処理する
CI/CDパイプラインで実行する
エージェント駆動のワークフローで活用する

本文（日本語訳）

preset-cli

sup CLIを通じて、シェルスクリプト、CI/CD（継続的統合・デプロイ）、およびエージェント駆動型のワークフローの基盤として機能します。

常に守ること

CLIのインターフェースのみを使用し、ユーザーが MCP または直接 API を要望している場合はそちらを優先してください。
自動化やエージェントの処理には --json をデフォルトとしてください。
SUP_PRESET_API_TOKEN / SUP_PRESET_API_SECRET をコマンドラインや共有出力に含めず、環境変数か sup config auth を使用してください。秘密情報をコマンドラインに貼り付けないでください。
データ変更（プッシュ、同期、上書き、--force オプション）は preset-cli-mutations にルーティングしてください。
記録や出力からトークンと認証情報を削除してください。

判断ルール

実行前に CLI / MCP / 直接 API の意図を分類し、MCP または直接 API が要望されている場合はそちらに委譲してください。
メタデータ読み取りと明示的に要望されたデータ取得操作（例：sup sql、sup chart data）は、既知のワークスペースで直接実行し、出力を制限してください。sup sql の場合、この直接実行は 1 つの SELECT ステートメントのみに限定されます。変更操作、1 つの SELECT ステートメント以外の SQL、信頼できない出所の SQL、未確認のワークスペース、または大量出力を伴う場合は安全性ポリシーを先に確認してください。
出力形式は利用者に応じて選択してください：自動化には --json、ファイル出力には --csv、人間向けにはデフォルトの Rich 表示、シェルパイプラインには --porcelain を使用してください。
このドキュメントに記載されていないコマンドグループの場合は、コマンドの対応状況を確認してからコマンドを構築してください。
データ変更意図の場合は、このドキュメントで続行せず preset-cli-mutations を読み込んでください。ユーザーが既知のワークスペースに貼り付けた SQL であっても、SELECT 以外の SQL は安全性ポリシーによって確認段階を通す必要があります。

ワークフローの実行順序

インストール、認証、ワークスペースの情報を確認する。
出力形式を選択する。
リスクレベルを分類する（メタデータ読み取り、データ取得読み取り、データ変更）。
その操作に関する詳細な参照ドキュメントを読み込む。
安全な読み取り専用コマンドのみを実行する。
出力を共有する前に機密情報を削除する。

参照ドキュメント

インストール、エントリーポイント、OAuth、環境変数：references/install-and-auth.md
設定優先順位と参照解決：references/config-precedence.md
ワークスペース選択と --workspace-id オーバーライド：references/workspace-and-config.md
登録済みコマンドの対応状況とルーティング：references/command-coverage.md
出力形式と終了動作：references/output-formats.md
アセット読み取り・エクスポートの対象範囲：references/assets-read.md
アセットリスト用フィルタマトリクス：references/asset-filter-matrix.md
一時的な SQL ルーティング：references/sql-and-query.md
SQL・データ取得読み取りの安全性：references/sql-data-safety.md
保存済みクエリの読み取り：references/saved-query-reads.md
詳細なコマンド実行例：references/command-examples.md
CLI と API ルーティングの判断基準：references/cli-vs-api.md
承認ゲートと認証情報削除：references/safety-policy.md

原文（English）を表示

preset-cli

Use as the foundation for shell, scripting, CI/CD, and agent-driven Preset workflows through the sup CLI.

Always

CLI surface only; stay on MCP or direct API if that's what the user requested.
Default to --json for automation and agent consumption.
Keep SUP_PRESET_API_TOKEN / SUP_PRESET_API_SECRET out of command lines and shared output; use env vars or sup config auth, never paste secrets on the command line.
Route push, sync, overwrite, and --force to preset-cli-mutations.
Redact tokens and credential-bearing output in transcripts.

Decision Rules

Classify CLI vs MCP vs direct API intent before acting; if MCP or direct API was requested, defer to that plugin.
Run metadata reads and explicitly requested data-returning reads (e.g. sup sql, sup chart data) on familiar workspaces directly with bounded output; for sup sql, this direct path requires a pure single-statement SELECT. Load safety policy before mutations, SQL that is not a pure single-statement SELECT, untrusted-source SQL, unfamiliar workspaces, or broad outputs.
Choose output format based on the downstream consumer: --json for automation, --csv for files, default Rich for humans, --porcelain for shell pipelines.
If a command group is not named on this card, load command coverage before composing commands.
For mutating intent, stop and load preset-cli-mutations rather than continuing on this card. Non-SELECT SQL is confirmation-gated by the safety policy even when it is pasted by the user for a familiar workspace.

Workflow Order

Establish install, auth, and workspace context.
Choose output format.
Classify risk (metadata read vs data-returning read vs mutation).
Load the focused reference for the operation.
Run only the safe / read command.
Redact output before sharing.

Retrieve

Install, entry points, OAuth, env vars: references/install-and-auth.md
Config precedence and source resolution: references/config-precedence.md
Workspace selection and --workspace-id override: references/workspace-and-config.md
Registered command coverage and routing: references/command-coverage.md
Output formats and exit behavior: references/output-formats.md
Asset read/export entity scope: references/assets-read.md
Asset list filter matrix: references/asset-filter-matrix.md
Ad-hoc SQL routing: references/sql-and-query.md
SQL/data-returning read safety: references/sql-data-safety.md
Saved query reads: references/saved-query-reads.md
Detailed command examples: references/command-examples.md
CLI vs API routing decision: references/cli-vs-api.md
Approval gates and credential redaction: references/safety-policy.md

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

常に守ること

CLIのインターフェースのみを使用し、ユーザーが MCP または直接 API を要望している場合はそちらを優先してください。

自動化やエージェントの処理には --json をデフォルトとしてください。

SUP_PRESET_API_TOKEN / SUP_PRESET_API_SECRET をコマンドラインや共有出力に含めず、環境変数か sup config auth を使用してください。秘密情報をコマンドラインに貼り付けないでください。

データ変更（プッシュ、同期、上書き、--force オプション）は preset-cli-mutations にルーティングしてください。

記録や出力からトークンと認証情報を削除してください。

判断ルール

実行前に CLI / MCP / 直接 API の意図を分類し、MCP または直接 API が要望されている場合はそちらに委譲してください。

メタデータ読み取りと明示的に要望されたデータ取得操作（例：sup sql、sup chart data）は、既知のワークスペースで直接実行し、出力を制限してください。sup sql の場合、この直接実行は 1 つの SELECT ステートメントのみに限定されます。変更操作、1 つの SELECT ステートメント以外の SQL、信頼できない出所の SQL、未確認のワークスペース、または大量出力を伴う場合は安全性ポリシーを先に確認してください。

出力形式は利用者に応じて選択してください：自動化には --json、ファイル出力には --csv、人間向けにはデフォルトの Rich 表示、シェルパイプラインには --porcelain を使用してください。

このドキュメントに記載されていないコマンドグループの場合は、コマンドの対応状況を確認してからコマンドを構築してください。

データ変更意図の場合は、このドキュメントで続行せず preset-cli-mutations を読み込んでください。ユーザーが既知のワークスペースに貼り付けた SQL であっても、SELECT 以外の SQL は安全性ポリシーによって確認段階を通す必要があります。

ワークフローの実行順序

インストール、認証、ワークスペースの情報を確認する。

出力形式を選択する。

リスクレベルを分類する（メタデータ読み取り、データ取得読み取り、データ変更）。

その操作に関する詳細な参照ドキュメントを読み込む。

安全な読み取り専用コマンドのみを実行する。

出力を共有する前に機密情報を削除する。

参照ドキュメント

インストール、エントリーポイント、OAuth、環境変数：references/install-and-auth.md

設定優先順位と参照解決：references/config-precedence.md

ワークスペース選択と --workspace-id オーバーライド：references/workspace-and-config.md

登録済みコマンドの対応状況とルーティング：references/command-coverage.md

出力形式と終了動作：references/output-formats.md

アセット読み取り・エクスポートの対象範囲：references/assets-read.md

アセットリスト用フィルタマトリクス：references/asset-filter-matrix.md

一時的な SQL ルーティング：references/sql-and-query.md

SQL・データ取得読み取りの安全性：references/sql-data-safety.md

保存済みクエリの読み取り：references/saved-query-reads.md

詳細なコマンド実行例：references/command-examples.md

CLI と API ルーティングの判断基準：references/cli-vs-api.md

承認ゲートと認証情報削除：references/safety-policy.md

Always

CLI surface only; stay on MCP or direct API if that's what the user requested.

Default to --json for automation and agent consumption.

Keep SUP_PRESET_API_TOKEN / SUP_PRESET_API_SECRET out of command lines and shared output; use env vars or sup config auth, never paste secrets on the command line.

Route push, sync, overwrite, and --force to preset-cli-mutations.

Redact tokens and credential-bearing output in transcripts.

Decision Rules

Classify CLI vs MCP vs direct API intent before acting; if MCP or direct API was requested, defer to that plugin.

Run metadata reads and explicitly requested data-returning reads (e.g. sup sql, sup chart data) on familiar workspaces directly with bounded output; for sup sql, this direct path requires a pure single-statement SELECT. Load safety policy before mutations, SQL that is not a pure single-statement SELECT, untrusted-source SQL, unfamiliar workspaces, or broad outputs.

Choose output format based on the downstream consumer: --json for automation, --csv for files, default Rich for humans, --porcelain for shell pipelines.

If a command group is not named on this card, load command coverage before composing commands.

For mutating intent, stop and load preset-cli-mutations rather than continuing on this card. Non-SELECT SQL is confirmation-gated by the safety policy even when it is pasted by the user for a familiar workspace.