gate-exchange-trading

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 Trading

これは、1つのスキルで取引の全サイクルを完了したいユーザー向けのL2 複合スキルです。

機会を判断 -> リスクを管理 -> 注文案を作成 -> 明示的に確認 -> 実行 -> 検証／管理

純粋な調査スキルでも、純粋な執行スキルでもありません。1つのスキル内で完全な取引ワークフローを提供することを目的としています。

一般ルール

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

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

名前付き MCP ツールを呼び出す前に、現在のランタイムツール一覧に具体的なツール名が存在することを確認してください。補助ツールが存在しない場合は、その不一致を明示し、最も近い有効な代替手段の組み合わせのみを使用してください。ランキング、マクロの広範な分析、自動的な資金フロートラッキングなど、利用できない機能を過大に主張してはいけません。

また、返されたペイロードに、意図する分析上の主張を裏付けるだけの情報が含まれていることも確認してください。ツールが乏しいメタデータや空の構造を返す場合、または不足している識別情報の入力を必要とする場合は、主要な根拠ではなく、補足情報として扱ってください。

ホスト間の移植性を確保するため、文書化されている gate-cli cex … コマンドを基準としてください。

• info_* -> Gate Info MCP
• news_feed_* -> Gate News MCP
• 読み取り専用の現物／先物市場データ -> gate-cli cex spot market … / gate-cli cex futures market …（該当する場合は公開エンドポイント）
• 非公開の注文／口座／ポジション関連のフロー -> 認証済みの gate-cli（GATE_API_KEY / GATE_API_SECRET および／または gate-cli config init。ホスト上で両方の環境変数が設定されている場合、config init は不要です）

シナリオ設計では news_events_* を必須の依存関係にしないでください。これは文書化されているニュース機能の範囲に含まれていません。

実行モード

references/gate-cli.md を読み、厳密に従ってから、このスキルの取引ワークフローを実行してください。

• SKILL.md では、複合ルーティング、取引ライフサイクルのポリシー、ガードレールを定めています。
• references/gate-cli.md は、ドメインをまたぐツールの実行順序、実行ゲート、縮退動作に関する gate-cli オーケストレーション契約の正式な基準です。

---

以下については、references/scenarios.md をお読みください。

• 代表的なユーザーシナリオ
• 代表的なプロンプトの例
• 期待されるツールのルーティングパターン

認証

• 対話形式でのファイル設定： ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されていない場合は、gate-cli config init を実行して、API キー、シークレット、プロファイル、デフォルト値の設定ウィザードを完了してください（gate-cli を参照）。
• 環境変数／フラグ： 認証情報がすでに提供されている場合は、gate-cli config init は不要です。たとえば、ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されている場合や、対応している箇所で --api-key ／ --api-secret が指定されている場合です。ユーザーにシークレットをチャットへ貼り付けるよう求めてはいけません。
• API キーが必要：必ずしも必要ではありません
• 読み取り専用の分析：エンドポイントによっては、公開情報を扱う info_*、news_feed_*、および一部の公開 gate-cli cex spot market … ／ gate-cli cex futures market … 読み取りを、認証なしで実行できる場合があります
• 取引実行と非公開アカウント操作：必要な API キー権限を備えた認証済み Exchange MCP ツールが必須です
• 注：非公開の取引実行ツールを利用できないことだけを理由に、分析のみの利用を妨げないでください。要求された操作で非公開の取引／アカウントへのアクセスが必要な場合に限り、実行を妨げてください。

インストールの確認

• 必須： gate-cli（gate-cli releases からインストールするか、利用環境の Gate MCP／スキルインストーラーを使用してください）。
• 名前で呼び出す場合は、gate-cli が含まれるディレクトリを PATH に追加してください。
• 認証情報： ホストに GATE_API_KEY と GATE_API_SECRET がどちらも設定されている（空ではない）場合、gate-cli config init を必須にしないでください。両方とも未設定または空で、非公開の取引実行が必要な場合は、オペレーターに gate-cli config init を実行するか、スキルライブラリ内の該当するスキルで GATE_API_KEY ／ GATE_API_SECRET を設定するよう伝えてください（ユーザーにシークレットをチャットへ貼り付けるよう求めてはいけません）。
• 動作確認： 非公開の取引手順に進む前に、CLI が動作することを確認してください（例：gate-cli --version または公開情報を扱う gate-cli cex spot market … ／ gate-cli cex futures market … の読み取り）。

位置づけ

• 複数のスキルを切り替えずに取引したいユーザー向けです
• 単独でインストールでき、分析から取引実行への対応づけも理解できます
• 現物取引 と USDT 無期限先物 に対応しています
• 取引後の 変更／キャンセル／決済／検証 に対応しています

適したシナリオ

適しているケース

• ユーザーがすでに対象資産を決めており、取引前に分析したい場合
  • BTCは今買う価値があるか確認してから、現物注文のドラフトを提示してください
  • ETHをロングしたいのですが、まずモメンタム、清算、流動性を確認してください
• ニュース、異常な値動き、新規上場をきっかけに、分析後の取引を希望する場合
  • ETHが急落しました。理由を説明し、買う価値があるか教えてください
  • 新規上場したこのコインが気になります。初回の取引プランを提示する前にリスクを確認してください
• すでに注文を出した、またはポジションを建てており、その管理を希望する場合
  • 未約定の買い注文を1%引き上げてください
  • BTCのポジションを半分決済してください

適していないケース

• 取引の目的がない、純粋な市場調査
• オプション、Alpha 取引、オンチェーンスワップ、DeFi の取引実行、コピートレード、資産運用商品
• 確認を省略する、コンプライアンスやリスク管理を回避する完全自動取引

対応範囲

このスキルでできること

1. ユーザーの目的を判別します：
   • 取引前の判断
   • 判断と取引実行
   • 注文／ポジション管理
2. 1つの取引対象に関する分析モジュールを動的に組み合わせます：
   • 市場／ニュースの状況
   • 個別コイン分析
   • テクニカル分析
   • 流動性／スリッページ／清算／板の分析
   • トークンまたはコントラクトのリスク確認
3. Trading Brief を作成します
4. リスクが許容範囲内の場合、Order Draft を作成します
5. 明示的な確認を受けた後に実行します：
   • 現物の買い／売り、条件付き指値注文のロジック、変更／キャンセル／検証
   • USDT 無期限先物の新規建て／決済／反転／変更／キャンセル
6. 実行後も処理を続けます：
   • 約定の検証
   • ポジションの検証
   • 注文／ポジションの管理

このスキルでできないこと

1. ユーザーに代わって自動で判断し、取引すること
2. 明示的な確認なしに注文すること
3. コンプライアンス、リスク、最小注文数量、または契約上の安全制約を回避すること
4. 利益を約束したり、分析を確実なものとして示したりすること
5. 対応していない商品をサポートしているように装うこと

運用原則

原則 1：取引目標を軸に進める

このスキルは、幅広い調査ではなく、取引の完了を目的に構築されています。

• ユーザーが How is the market? とだけ尋ねた場合
  • 簡易的な市場スキャンで問題ありません
  • 注文の執行に先回りして進まないでください
• ユーザーが How is the market today? Give me one trade idea と述べた場合
  • 簡易的な市場スキャンは可能です
  • ただし、執行に進む前に、ワークフローで**1つの資産＋1つの市場（現物または先物）**に絞り込む必要があります

原則 2：執行の前に判断する

ユーザーが純粋な注文／ポジション管理のみを希望している場合を除き、注文案を作成する前に、デフォルトで1回の事前取引判断を行います。

references/routing-and-analysis.md を読み、以下を確認してください。

• 意図の振り分け
• シナリオごとの分析モジュールの選択
• リスク判定
• モジュールと MCP の対応関係、および呼び出しパターン

原則 3：必要最小限の分析を行う

毎回すべてのモジュールを実行しないでください。現在の判断に必要なモジュールだけを呼び出します。

references/routing-and-analysis.md を読み、以下を確認してください。

• 意図の振り分け
• シナリオごとの分析モジュールの選択
• リスク判定
• モジュールと MCP の対応関係、および呼び出しパターン

原則 4：執行レイヤーで厳格に確認する

実際の取引操作は、必ず次の順序で行う必要があります。

1. Trading Brief を作成する
2. Order Draft を作成する
3. 直前のユーザー発話で明示的な確認を待つ
4. 確認後にのみ執行する

以下については references/execution-and-guardrails.md を読んでください。

• 現物と先物の執行ルール
• 執行 MCP の対応関係
• 注文案の要件
• 確認ルール
• ハードブロックとソフトブロック

全体的なワークフロー

ステップ 0：まず共通ランタイムルールを適用する

分析または執行の前に、次のことを行います。

• gate-runtime-rules.md を読み、従います
• 必須のランタイム、更新、または認可ゲートがある場合は、先に解決してから続行します
• 頼る前に、呼び出す予定の指定ツールが現在のランタイムに存在することを確認します

ステップ 1：タスクモードを特定する

ユーザーのリクエストを次のいずれかのモードに分類します。

1. Trade Decision
   • まず分析し、その後、取引するかどうかを判断します
2. Trade Draft / Execute
   • ユーザーはすでに取引を希望しており、分析、注文案の作成、執行を求めています
3. Order / Position Management
   • ユーザーは既存の注文またはポジションの管理を希望しています

ステップ 2：取引対象を1つに絞り込む

執行に進む前に、次の項目を明確にするようにします。

• 資産：BTC／ETH／SOL／新規コイン／先物契約
• 市場：現物または USDT 無期限先物
• 方向：買い／売り／ロング／ショート／決済

情報がまだ不十分な場合：

• 簡易的な市場スキャンは可能です
• ただし、注文案を作成する前に、ワークフローで資産と市場をそれぞれ1つに絞り込む必要があります

ステップ 3：事前取引分析パッケージを作成する

リクエストに必要なモジュールだけを呼び出します。

• 市場概況／ニュースブリーフィング
• 上場／取引所の発表に関する背景情報
• 個別コイン分析
• テクニカル分析
• イベントの説明
• リスクチェック
• アドレスの追跡（ユーザーが実際にアドレスを提示し、追跡を希望している場合のみ）
• 流動性／スリッページ／モメンタム／清算／ベーシス／オーダーブックの分析

ステップ 4：Trading Brief を作成する

Trading Brief は、執行前に必須となる中間成果物です。次の内容を含める必要があります。

1. ユーザーが何をしようとしているか
2. 現在の市場／資産についての判断
3. 主なリスク
4. 注文案の作成に進むべきかどうか

結果の状態は次の3つのみです。

• GO = 注文案の作成に進むのに十分安全です
• CAUTION = 無視できないリスクがありますが、警告後に注文案の作成を続けてもかまいません
• BLOCK = 注文案の作成に進んではいけません

ステップ 5：Order Draft を作成する

次の条件をすべて満たす場合にのみ、注文案を作成します。

• ユーザーに実際の取引意図がある
• 取引対象が十分に明確である
• ハードブロックが発動していない

ステップ 6：明示的な確認を待つ

ユーザーから明確で即時の確認が得られない場合：

• 実行しない
• 分析／下書き／問い合わせモードのみを維持する

ステップ 7：実行して検証する

実行後は、必ず以下を返します：

• 実行が成功したかどうか
• 約定／注文／ポジションの主な結果
• 約定の確認、注文の変更、キャンセル、決済など、妥当な次のアクション

市場の特定ルール

デフォルトの動作

• リクエストに long / short / leverage / contract / perp / futures / open / close が明確に含まれる場合
  • USDT 無期限先物に振り分ける
• リクエストに buy coin / sell coin / spot / buy BTC / sell ETH が明確に含まれる場合
  • 現物に振り分ける
• ユーザーが市場を指定せずに buy BTC と言った場合
  • デフォルトで現物にする
• ユーザーが trade this move と言った場合
  • 現物か USDT 無期限先物かを尋ねる

推奨される応答の流れ

実行前

1. Trading Brief
2. 許可されている場合：Order Draft
3. 確認を待つ

実行後

1. Execution Result
2. 必要に応じて：Next Actions

注文／ポジション管理に関する特別ルール

ユーザーが以下を求めた場合：

• 注文の変更
• 注文のキャンセル
• 約定の確認
• 半分を決済
• 全て決済
• 反対売買

スキルは調査プロセス全体を再実行する必要はありませんが、以下は必須です：

• 対象となる注文またはポジションを正しく特定する
• 該当する実行ルールを適用する
• リスクの高い操作には、確実な確認を求める

リスクポリシー

拒否条件

以下の場合は、直ちに停止する必要があります：

• ユーザーが確認を省略するよう求めた場合
• ユーザーがコンプライアンスまたはリスク管理を回避するよう求めた場合
• 商品がサポート対象外の場合
• 資産が取引可能でない場合
• トークンのセキュリティチェックで重大な悪意あるリスクが検出された場合

警告条件

以下の場合は、警告したうえで続行を許可します：

• 流動性が低い
• スリッページが大きい
• 資金調達率が極端である
• ポジションの偏り／清算リスクが高まっている
• 大きなイベントが発生したばかりで、方向性が不安定である
• コインが新規上場であるか、まだ価格形成中である

警告条件に該当する場合：

• 警告を Trading Brief に明確に記載する
• それでもユーザーが続行を希望する場合は、下書きの作成を許可する
• 確認は引き続き必須とする

読む順序

1. references/routing-and-analysis.md を読む
2. references/execution-and-guardrails.md を読む
3. 現在のタスクに必要なモジュールのみを実行する。デフォルトでスタック全体を実行しない