claude-skills/

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

last sync 1h ago
スキルOfficialdevelopment

🖥️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 は安全性ポリシーによって確認段階を通す必要があります。

ワークフローの実行順序

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

参照ドキュメント

原文（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

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

Retrieve

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