gate-exchange-flashswap-assistant

gate-cli の解決（バイナリパス）

gate-cli は次の順に解決します。（1） command -v gate-cli と gate-cli --version が成功すること。（2） 実行可能な場合は ${HOME}/.local/bin/gate-cli。（3） 実行可能な場合は ${HOME}/.openclaw/skills/bin/gate-cli。正規のルール：exchange-runtime-rules.md §4、または gate-runtime-rules.md §4。

gate-exchange-flashswap-assistant

一般ルール

⚠️ 停止 — 続行する前に、共有ランタイムルールを必ず読み、厳守してください。 すべてのルールを読むまで、ツールを選択したり呼び出したりしないでください。これらのルールが最優先です。 → gate-runtime-rules.md をお読みください。

• このスキルに明記された gate-cli コマンドのみを使用してください。 ここに記載されていないコマンドは、他のインターフェースで利用できる場合でも、これらのワークフローでは実行してはなりません。

スキルの依存関係

使用するgate-cliコマンド

照会操作（読み取り専用）

• gate-cli cex flash-swap order
• gate-cli cex flash-swap pairs
• gate-cli cex flash-swap orders
• gate-cli cex flash-swap preview-many-to-one
• gate-cli cex flash-swap preview-one-to-many
• gate-cli cex flash-swap preview-v1
• gate-cli cex spot account get
• gate-cli cex wallet balance small
• gate-cli cex wallet balance small-history

実行操作（書き込み）

• gate-cli cex flash-swap create-many-to-one
• gate-cli cex flash-swap create-one-to-many
• gate-cli cex flash-swap create-v1
• gate-cli cex wallet balance convert-small

認証

• 対話型のファイル設定： ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されていない場合は、gate-cli config init を実行して、APIキー、シークレット、プロファイル、デフォルト値のウィザードを完了してください（gate-cli を参照）。
• 環境変数／フラグ： 認証情報がすでに指定されている場合（ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されている場合や、サポートされている箇所で --api-key ／ --api-secret を指定する場合など）は、gate-cli config init は不要です。ユーザーにチャットでシークレットを貼り付けるよう求めないでください。
• APIキーが必要です：はい（認証済みGate Exchange MCP）
• 権限： Flash Convertの書き込み（gate-cli cex flash-swap preview ／ create または preview-v1 ／ create-v1 ／複数通貨の各種コマンド。Exchange MCPを使用する場合はMCP cex_fc_*）、現物アカウントの読み取り、ウォレットの少額残高の読み取り、およびゲートウェイが必要とする変換権限（最小限の権限でキーを設定してください）
• ポータル： キーの作成またはローテーションはチャットの外で行ってください：https://www.gate.com/myaccount/profile/api-key/manage

インストールの確認

• 必須： Gate（メイン）。CLIを利用するフローでは gate-cli も必要です（該当する場合、このスキルの setup.sh からインストールしてください）。
• インストール（MCP／IDE）： Cursor：gate-mcp-cursor-installer、Codex：gate-mcp-codex-installer、Claude：gate-mcp-claude-installer、OpenClaw：gate-mcp-openclaw-installer。
• 認証情報： ホストに GATE_API_KEY と GATE_API_SECRET がどちらも設定されており、空でない場合は、gate-cli config init を必須にしないでください。両方とも未設定または空の場合は、オペレーターに gate-cli config init の実行、またはスキルライブラリ内の対応するスキルで GATE_API_KEY ／ GATE_API_SECRET を設定するよう案内してください（ユーザーにチャットでシークレットを貼り付けるよう求めないでください）。
• 動作確認： Flash Swapまたは少額残高の呼び出しで状態を変更する前に、ランタイムが動作することを確認してください（例：gate-cli --version、またはこのスキルに適した読み取り専用の確認）。

---

ドメイン知識

このスキルの対象範囲

• フラッシュスワップ（fc）：プレビュー後に作成することで、即座に交換します。3 つのモードがあります：1 対 1、1 対複数（1 つの売却資産を複数の購入資産に交換）、複数対 1（複数の売却資産を 1 つの購入資産に交換して集約）。
• フロー内の残高確認：このフローでは、売却側（および 1 対複数の場合は USDT 側）に限り、gate-cli cex spot account get を使用します。ここでポートフォリオ全体の情報を取得しないでください。
• 異なる 2 種類の「少額残高」処理（ユーザーへの説明が必要）：
  • フラッシュスワップ：通貨ペアごとに gate-cli cex flash-swap pairs で確認できる sell_min_amount / sell_max_amount が適用されます。最小額を下回る場合、見積もりを装うために fc プレビューを呼び出さないでください。
  • ウォレットのダスト → GT：gate-cli cex wallet balance small / gate-cli cex wallet balance convert-small は、プラットフォームがダストとして分類した残高を GT に変換します（USDT ではありません）。ルールはフラッシュスワップの最小額とは異なります。ユーザーが USDT へのフラッシュスワップを求めた場合、説明なしにこちらへ切り替えてはなりません。

主な概念

• quote_id：プレビューから取得し、作成時に必要です。有効性はレスポンス内の valid_timestamp に基づきます。固定 TTL を想定しないでください。
• sell_amount / buy_amount：API の要件に応じて、各レッグにつきいずれか 1 つを使用します。1 対複数では対象ごとに sell_amount または buy_amount を指定でき、複数対 1 では売却元ごとに sell_amount を指定します。
• 注文ステータス：status=1 は成功、status=2 は失敗です。作成のたびに確認してください。
• 精度：受取額がごく少額の場合は、精度が明確にわかるように表示してください。根拠が明確な場合に限り、概算の法定通貨額を補足できます。

このスキルのツール対象外

• このスキルでは gate-cli cex spot market tickers、gate-cli cex spot market orderbook、gate-cli cex wallet balance total を呼び出さないでください。市場の流動性、「今が良いタイミングかどうか」、資産全体の監査は、別のスキルの対象です（判断ロジックの概要を参照）。

規制およびリスクに関する注意事項

• デジタル資産の取引には大きなリスクが伴い、投資額の一部または全部を失う可能性があります。
• このスキルは、18 歳以上で完全な民事行為能力を有するユーザーを対象としています。ユーザーは、居住地域で適用される法令を遵守する必要があります。
• AI による出力およびツールの結果は一般的な情報提供のみを目的としており、投資、金融、税務、法律に関する助言や、Gate による表明または保証を構成するものではありません。
• プロンプトおよび取引関連の入力は、MCP を介して Gate API を呼び出すために処理されます。不要な個人データを収集しないでください。

---

アトミックなツール呼び出しチェーン（必須）

実行ルール： 可能な場合は、ユーザーのリクエストを以下の シナリオ #1～#21 に割り当ててください。記載されたツールの順序に従ってください。 ゲート（残高、sell_min_amount、作成前のプレビュー）を省略しないでください。

表記

• [P1] Parallel：記載されたツールを同じウェーブで呼び出します（後続のステップが出力に依存する場合を除き、順序は問いません）。
• →：逐次実行 — 前のステップを完了してから次のステップを開始します。
• [P0] Plan：MCP 呼び出しなし — 金額の解析、比率での分割、または対象コインの制限（例：ユーザーが指定したリストのみ）を行います。
• [Confirm]：アクション案を提示し、分岐内の書き込みツールを使用する前に、明示的な Y を待ちます。
• (W)：書き込みツール — シナリオがプレビューのみで終了する場合を除き、確認後にのみ使用します。

ルーティング時の注意事項（仕様より）

• 1 対複数の行 #4、#5、#11：ユーザーがフラッシュスワップ／変換／スワップを示す表現を使わず、現物の買い注文／成行買い注文のみを指示した場合は、fc ツールではなく gate-exchange-trading にルーティングしてください。
• #8、#20：ユーザーが作成を選択するまでは、プレビューのみ行います。
• #21：「USDT へのスワップ」の説明の中に、異なる製品フローであるダスト → GT を説明なしに混在させないでください。

基本シナリオ（#1–#8）

#	ユーザーの意図（要約）	モード	シグナル	原子的な処理チェーン
1	固定数量（例：1 BTC）を USDT にスワップする	1→1	S1	[P1] gate-cli cex flash-swap pairs（売却資産）· gate-cli cex spot account get（売却資産）→ 利用可能残高が売却数量以上であり、売却数量が sell_min_amount 以上であることを確認 → gate-cli cex flash-swap preview-v1（sell_asset, sell_amount, buy_asset）→ レート、受取見込み額、有効期限を表示 → アクション案 → [Confirm] → (W) gate-cli cex flash-swap create-v1（quote_id、一致する数量）→ status を確認 → 結果を報告
2	1つの資産の利用可能残高全額を USDT にスワップする（例：SOL の利益確定）	1→1	S1	[P1] gate-cli cex spot account get（資産）· gate-cli cex flash-swap pairs（資産）→ sell_amount = 利用可能残高に設定し、sell_min_amount 以上であることを確認 → gate-cli cex flash-swap preview-v1 → アクション案 → [Confirm] → (W) gate-cli cex flash-swap create-v1 → status を確認
3	入金後、資産 A を USDT にスワップする	1→1	S1	[P1] gate-cli cex spot account get（A）· gate-cli cex flash-swap pairs（A）→ 残高と最小値／最大値を確認 → gate-cli cex flash-swap preview-v1（A→USDT）→ アクション案 → [Confirm] → (W) gate-cli cex flash-swap create-v1 → status を確認
4	1つの資産（例：3000 USDT）を複数の対象資産にフラッシュスワップし、対象ごとに使用額を指定する（例：それぞれ1000 USDTを BTC、ETH、SOL に）	1→N	S2	[P1] gate-cli cex spot account get（USDT）· gate-cli cex flash-swap pairs（各対象資産）→ USDT が使用額の合計以上であること、各レッグの sell_amount がそのペアの sell_min_amount 以上であることを確認 → gate-cli cex flash-swap preview-one-to-many（各レッグのパラメーター）→ レッグごとの見積もりを表示し、失敗を強調 → アクション案 → [Confirm] → (W) gate-cli cex flash-swap create-one-to-many（パラメーター、プレビューに失敗したレッグを除外）→ 各レッグの status を確認
5	1つの資産を比率で分割する（例：1000 USDT の半分を BTC、半分を ETH に）	1→N	S2	[P0] ユーザーの指定した比率からレッグごとの sell_amount を計算 → [P1] gate-cli cex spot account get（USDT）· gate-cli cex flash-swap pairs（各対象資産）→ gate-cli cex flash-swap preview-one-to-many → アクション案 → [Confirm] → (W) gate-cli cex flash-swap create-one-to-many → status を確認
6	複数の指定資産を1つの対象資産にスワップする（例：BTC、ETH、DOGE → USDT）、残高全額を使用	N→1	S3	[P1] gate-cli cex spot account get（各ソース資産）· gate-cli cex flash-swap pairs（各ソース資産）→ 残高が sell_min_amount 未満、または残高がゼロのレッグを除外し、スキップしたレッグをユーザーに伝える → gate-cli cex flash-swap preview-many-to-one（残りのレッグ）→ アクション案 → [Confirm] → (W) gate-cli cex flash-swap create-many-to-one → 各レッグの status を確認
7	最近のフラッシュスワップ履歴を一覧表示する	クエリー	S4	[P1] gate-cli cex flash-swap orders（例：limit=20）→ 表を整形：時刻／売却／購入／数量／status
8	プレビューのみ：資産 X（例：SOL）で USDT をいくら受け取れるか確認し、後で決める	1→1	S1	[P1] gate-cli cex flash-swap pairs（X）· gate-cli cex spot account get（X）→ gate-cli cex flash-swap preview-v1（全額または一部の数量）→ レート、受取見込み額、有効期限のみを表示 → ユーザーが Y の場合 → アクション案 → [Confirm] → (W) gate-cli cex flash-swap create-v1、N の場合 → 停止（書き込みなし）

拡張シナリオ（#9～#13）

#	ユーザーの意図（言い換え）	シグナル	アトミックチェーン
9	コイン（例：APT）がフラッシュスワップに対応しているか、またはペアの制限があるか	S4	[P1] gate-cli cex flash-swap pairs(通貨) → 空の場合：非対応です。現物取引スキルを提案します → 行がある場合：ペアと最小値／最大値を表示します
10	最新のフラッシュスワップは成功したか	S4	[P1] gate-cli cex flash-swap orders(limit=1) → 最新の order_id を取得します → gate-cli cex flash-swap order(order_id) → status（1 は成功／2 は失敗）と約定内容を報告します
11	USDT をフラッシュスワップして、対象通貨を指定した購入数量（例：0.1 BTC と 1 ETH）にする	S2	[P0] 各レッグのパラメーターに sell_amount ではなく buy_amount を設定します → [P1] gate-cli cex spot account get(USDT) · gate-cli cex flash-swap pairs(各対象通貨) → gate-cli cex flash-swap preview-one-to-many → 消費する USDT の合計と利用可能額を確認します（例：total_consume_amount または同等のフィールド） → 各レッグのアクション案 → [確認] → (W) gate-cli cex flash-swap create-one-to-many → 各 status を確認します
12	USDT 以外の通貨を使う 1 対 1 のレッグ（例：2 ETH → BTC）	S1	[P1] gate-cli cex spot account get(ETH) · gate-cli cex flash-swap pairs(ETH) → 数量が最小値以上で、かつ最小値／最大値の範囲内であることを確認します → gate-cli cex flash-swap preview-v1(ETH を売却、BTC を購入、…) → アクション案（「USDT 経由」ではなく、単一ホップのフラッシュスワップであることを明記します） → [確認] → (W) gate-cli cex flash-swap create-v1 → status を確認します
13	複数の指定アルトコインを USDT にする。ユーザーが残高を把握していない場合がある	N→1	S3

ダスト、少額、分割シナリオ（#14～#21）

#	ユーザーの意図（言い換え）	シグナル	アトミックチェーン
14	「少なすぎる」／フラッシュの最小数量を下回っている可能性がある（例：PEPE）	S5	[P1] gate-cli cex flash-swap pairs(資産) · gate-cli cex spot account get(資産) → 利用可能数量が sell_min_amount 未満の場合：gate-cli cex flash-swap preview（またはプレビューのバリエーション）は呼び出さず、残高／最小数量／不足分を表示 → gate-cli cex wallet balance small → 資産がダストリストに含まれる場合は、ダストから GT への経路 S7 を説明します。それ以外の場合は、蓄積または現物売却を提案します（トレーディングコパイロット） → 利用可能数量が最小数量以上の場合は、シナリオ #1形式の S1 チェーンを続行
15	少額の合計を複数の銘柄に分割する（例：30 USDT を DOGE と SHIB に分割）	S2	[P0] 不明確な場合は、各注文への USDT の配分をユーザーに確認 → [P1] gate-cli cex spot account get(USDT) · gate-cli cex flash-swap pairs(各対象) → 各注文が sell_min_amount 以上であることを確認します。未満の場合は調整を依頼 → gate-cli cex flash-swap preview-one-to-many → 失敗した注文を強調表示し、アクション草案を提示 → [確認] → (W) gate-cli cex flash-swap create-one-to-many(確認済みのパラメーター)
16	単一資産の数量が sell_max_amount を超えている（バッチ分割が必要）	S6	[P1] gate-cli cex spot account get(資産) · gate-cli cex flash-swap pairs(資産) → sell_max_amount を読み取り、各バッチが上限以下になるよう計画 → バッチ k の場合： gate-cli cex flash-swap preview-v1 → アクション草案を提示 → [確認] → (W) gate-cli cex flash-swap create-v1 → status を確認 → バッチ k+1 の前に gate-cli cex spot account get を再照会 → 次のバッチ用に新しいプレビュー（新しい quote_id）を取得
17	複数のティッカー → USDT。「交換可能なものはすべて交換」	N→1	S3
18	フラッシュの最小数量と、現在の残高が条件を満たしているかを尋ねる	S4	[P1] gate-cli cex flash-swap pairs(資産) · gate-cli cex spot account get(資産) → sell_min_amount、sell_max_amount、利用可能数量、合否を報告 → ユーザーが続けて「すべて交換」と指定した場合は、シナリオ #1 または #2 を実行
19	ユーザーがセッション内で明示的なコインリストを提示（貼り付け／列挙）し、交換可能なものをすべて USDT に交換する	N→1	S3
20	少額のプレビューのみ（例：5 USDT → SAT）。すぐに約定させる必要はない	S1	[P1] gate-cli cex flash-swap pairs(対象) · gate-cli cex spot account get(USDT) → 売却側の USDT が sell_min_amount 未満の場合：S5 の経路を使用し、プレビューは行わない → それ以外の場合は gate-cli cex flash-swap preview-v1 → 受取額を表示し、精度に関する注意を添える。デフォルトでは自動作成は行わない
21	ウォレットのダストを GT に変換して整理する	S7	[P1] gate-cli cex wallet balance small() → 変換可能なダストのリストを表示 → アクション草案を提示：変換後の GT と gate-cli cex wallet balance convert-small を明記し、currencies または is_all を確認 → [確認] → (W) gate-cli cex wallet balance convert-small → 必要に応じて gate-cli cex wallet balance small-history

---

ワークフロー

Step 1: 意図を判定し、シグナル S1～S7 を選択する

まず、Atomic Tool Call Chains のシナリオ #1～#21 に該当するか確認し、記載どおりにチェーンを実行してください（並列か逐次か、プレビューゲート、書き込み前の確認を順守）。

該当する行がない場合は、フォールバックとしてリクエストを分類します。Judgment Logic Summary を参照し、対象外に該当する場合は、適切なスキル名を示して停止してください。fc またはウォレット変換ツールは呼び出さないでください。

対象範囲内で、表に記載されていない場合は、1 つ以上のシグナルを割り当てます。S1 1 対 1 フラッシュ、S2 1 対多フラッシュ、S3 多対 1 統合、S4 クエリまたは履歴、S5 最小額未満またはダストの診断、S6 sell_max_amount による分割、S7 ダストから GT への変換。

抽出する主なデータ：

• signal：S1 | S2 | S3 | S4 | S5 | S6 | S7（組み合わせ可。例：S5 の後に S1）
• sell_assets、buy_asset、金額、およびユーザーがプレビューのみを求めているかどうか
• user_confirmed_flash_language：ユーザーがフラッシュスワップ／変換／スワップの説明を使っているか、それともスポットの購入のみを表す言い方か（ルーティング表を参照）

Step 2: ゲートウェイの読み取りを並列実行する（フラッシュ経路 S1～S3、S5、S6）

次を指定して gate-cli cex flash-swap pairs を呼び出します。

• currency（または MCP に応じた同等のフィルター）：各売却資産（および必要に応じて対象資産）

次を指定して gate-cli cex spot account get を呼び出します。

• 関連する各通貨（売却側および 1 対多の場合の USDT）の利用可能残高を読み取るために必要なパラメーター

抽出する主なデータ：

• ペアごとの sell_min_amount、sell_max_amount
• available 残高
• プレビュー前に各レッグが最小額ゲートを通過するかどうか

S5 のルール：フラッシュレッグの available が sell_min_amount 未満の場合、そのレッグに対して gate-cli cex flash-swap preview（またはプレビューのバリエーション）を呼び出さないでください。残高と最小額との差を示す明確な表を提示し、S7 が適用されるか確認するために、必要に応じて gate-cli cex wallet balance small を呼び出します。

S6 のルール：金額が sell_max_amount を超える場合は、逐次バッチを計画します。各バッチについて、次のバッチのプレビューに進む前に、専用のプレビュー、Action Draft、Y、作成、作成後の残高更新が必要です。計画するバッチ数には妥当な上限（例：20）を設けるか、ユーザーがキャンセルした時点で停止してください。上限なくループしないでください。

Step 3: プレビュー（モードに応じてプレビューツールを 1 つ選択）

1 対 1（S1） — sell_asset、buy_asset、および sell_amount または buy_amount を指定して gate-cli cex flash-swap preview-v1 を呼び出します。

1 対多（S2） — レッグごとの金額を含む params 配列を指定して gate-cli cex flash-swap preview-one-to-many を呼び出します。レッグごとのプレビューエラーを明示してください。

多対 1（S3） — 最小額未満または残高ゼロのレッグを除外した後、残りのレッグの params を指定して gate-cli cex flash-swap preview-many-to-one を呼び出します。実行予定とスキップの概要を提示してください。

抽出する主なデータ：

• 成功したレッグごとの quote_id
• レート、受取金額、valid_timestamp
• ユーザーに表示する各レッグのエラー

Step 4: Action Draft と明示的な確認（すべての書き込み）

売却／購入資産、金額、適用レートまたは受取見込み額、見積もりの有効期間、複数レッグの状況を記載した Action Draft を提示します。S7 の場合、操作は USDT フラッシュスワップではなく、gate-cli cex wallet balance convert-small によるダストから GT への変換であることを明記してください。

実行する場合は明示的な Y、キャンセルする場合は N を待ちます。Y がない限り、書き込みツールを呼び出してはいけません。

抽出する主なデータ：

• user_confirmation：Y | N
• パラメーターが直近のプレビューと一致するかどうか（一致しない場合は再プレビュー）

Step 5: フラッシュスワップの作成を実行する（Y の後、リクエストごとに作成ファミリーを 1 つ）

次のいずれか 1 つを使用します。

プレビューの quote_id と一致する売却／購入金額を含む本文フィールドを指定して、gate-cli cex flash-swap create-v1 を呼び出します。

各レッグの quote_id と金額を含む params を指定して、gate-cli cex flash-swap create-one-to-many を呼び出します。プレビューに失敗したレッグは除外してください。

各レッグの quote_id と金額を含む params を指定して、gate-cli cex flash-swap create-many-to-one を呼び出します。プレビューに失敗したレッグは除外してください。

抽出する主なデータ：

• 注文ごとの status と ID
• API が返すエラー

ステップ 6：注文結果を確認する

作成した注文ごとに、status を読み取ります。必要に応じて、注文 ID を指定して gate-cli cex flash-swap order を呼び出し、詳細を確認します。

抽出する主要データ：

• 各レッグの成功／失敗
• 提供されている場合は最終受取額

ステップ 7：照会と履歴の手順（S4）

履歴や「最新の注文」を確認するには、適切な limit／フィルターを指定して gate-cli cex flash-swap orders を呼び出します。

特定の ID の詳細が必要な場合や、一覧から最新の ID を取得した場合は、order_id を指定して gate-cli cex flash-swap order を呼び出します。

対応ペアや最小値／最大値に関する質問には、必要に応じて gate-cli cex flash-swap pairs と gate-cli cex spot account get を使用します。

ダストの履歴を確認するには、MCP 経由で任意のフィルターを指定して gate-cli cex wallet balance small-history を呼び出します。

抽出する主要データ：

• 人が読みやすい表：時刻、売買の方向、金額、ステータス

ステップ 8：ダストを GT に変換する手順（S7）

gate-cli cex wallet balance small を呼び出します（このツールの仕様の範囲外で「口座内のすべてのダストを一覧表示」する代替手段はありません）。

変換可能な一覧を提示します。実行案には、ユーザーが確認したとおりの currencies または is_all を指定する必要があります。

Y の後、確認済みのパラメーターを指定して gate-cli cex wallet balance convert-small を呼び出します。

抽出する主要データ：

• 変換結果またはエラー。必要に応じて gate-cli cex wallet balance small-history で追加確認

---

判定ロジックの概要

シグナルの定義

シグナル	意味	主なツール
S1	1 対 1 のフラッシュ	gate-cli cex flash-swap pairs、gate-cli cex spot account get、gate-cli cex flash-swap preview-v1、gate-cli cex flash-swap create-v1
S2	1 対多のフラッシュ（ユーザーがフラッシュ／変換／スワップを指定している場合。単純な現物買いではない）	gate-cli cex flash-swap preview-one-to-many、gate-cli cex flash-swap create-one-to-many
S3	多対 1 の集約	gate-cli cex flash-swap preview-many-to-one、gate-cli cex flash-swap create-many-to-one
S4	照会：履歴、対応状況、最小値の確認、注文ステータス	gate-cli cex flash-swap orders、gate-cli cex flash-swap order、gate-cli cex flash-swap pairs、gate-cli cex wallet balance small-history
S5	フラッシュの最小値未満／残高が不安定	最小値に達するまで読み取りのみ。任意で gate-cli cex wallet balance small → S7 を提案
S6	sell_max_amount を超える金額	S1／S2／S3 と同じ作成ツール群を使用しますが、バッチごとに最新のプレビューと確認を行い、順次実行します
S7	ダストを GT に変換	gate-cli cex wallet balance small、gate-cli cex wallet balance convert-small

対象外のリクエストの振り分け（このスキルのツール一覧は使用しないでください）

ユーザーの意図	振り分け先
調査、「理由」、スリッページ、板の厚さ、流動性、チャート	gate-info-research または gate-exchange-trading（ここではティッカー／オーダーブックを扱いません）
フラッシュ／変換の指定がない現物買い／売りの依頼（成行／指値、「少し買う」、「DCA」、「bid」など）	gate-exchange-trading
先物／マージン取引	gate-exchange-trading または先物／マージン関連のスキル
口座間の振替（現物 ↔ 先物、サブアカウント）	gate-exchange-transfer
ポートフォリオ全体、マージンリスク、清算に関する状況	gate-exchange-assets-manager または gate-exchange-assets
Earn／ステーキング	gate-exchange-simpleearn または関連する Earn スキル
オンチェーン DEX スワップ	DEX スキル（例：gate-dex-trade）

モードの判定

• 1 対 1：売却資産が 1 つ、購入資産が 1 つで、複数資産への分割を示す表現がない。
• 1 対多：売却資産が 1 つ、購入資産が複数。ユーザーは「複数を買う」だけでなく、フラッシュスワップ／変換を指定する必要があります。
• 多対 1：複数の売却資産を 1 つの購入資産にまとめる場合、または「集約する」、「すべてを USDT に変換する」などの表現がある場合。
• 不明な場合：ユーザーが1 つの元資産 → 複数の変換先を希望しているのか、複数の元資産 → 1 つの変換先を希望しているのかを確認します。

---

報告テンプレート

フラッシュスワップの実行案（fc create の前）

• モード（1 対 1／1 対多／多対 1）
• 各レッグ：売却する資産と数量 → 購入する資産と受取予定数量（プレビューから取得）
• 見積もりの有効性：valid_timestamp を参照します（秒数を推測しないでください）
• リスクの説明：即時に実行され、最終結果は API から返されます
• 確認：実行する場合は Y、キャンセルする場合は N と返信してもらいます

S5 診断（プレビューなし）

• 資産、利用可能残高、sell_min_amount、不足額
• 次の選択肢：資産を貯める、トレーディングコパイロットで現物取引を行う、または GT への交換経路（S7）のためにダストリストを確認する

GT へのダスト交換の実行案

• 操作が USDT へのフラッシュ交換ではなく、少額残高を GT に交換することを明示します
• ユーザーが確認したコイン、または is_all をそのまま指定します
• Y／N

実行後

• 各レッグのステータスと数量
• リマインダー：デジタル資産の取引は一般に取り消せません。フラッシュスワップは即時に約定します

---

安全ルール

確認

• 事前に実行案を提示し、明示的な Y を受け取るまでは、gate-cli cex flash-swap create（または create-v1／複数通貨の create バリエーション）も gate-cli cex wallet balance convert-small も実行しないでください。
• 期限切れまたは古い quote_id は絶対に使用しないでください。ユーザーの返答が遅れた場合は、プレビューをやり直してください。
• 最低数量に満たない残高を取り繕う目的だけで fc preview を呼び出さないでください。

比例性

• MCP ツールには必要最小限のパラメーターのみ渡してください。無関係な会話内容をツール入力として送信しないでください。

---

エラー処理

状況	対応
gate-cli cex flash-swap pairs が失敗する	制限が不明であることを伝え、プレビューの前に警告します。最小値／最大値を推測しないでください
プレビューがエラーを返す	create を実行しないでください。メッセージを表示し、数量の調整または現物取引の経路を提案します
create が失敗する	自動再試行しないでください。プレビューをやり直すよう提案します
gate-cli cex spot account get が失敗する	残高が不明であることを警告し、残高を捏造しないでください
gate-cli cex wallet balance small が失敗する	convert を呼び出さないでください。ダストリストを利用できないことを説明します
gate-cli cex wallet balance convert-small が失敗する	エラーを表示し、無言で再試行しないでください
実行案の提示後、ユーザーが N と回答する	中止し、書き込み操作を行わないでください

---

参考資料

• マッピングされたシナリオの規範的なツール呼び出し順序：上記の Atomic Tool Call Chains（シナリオ #1～#21）
• 人が読めるシナリオとプロンプトの例：references/scenarios.md
• 共通の曖昧さ解消：存在する場合は、スキルのルートから gate-skills-disambiguation.md を読み込んでください