gate-exchange-autoinvest

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-autoinvest

Gate Exchange Earn の高速自動投資（DCA）機能です。プランの作成、更新、停止、および関連情報の照会に対応しています。

一般ルール

⚠️ 停止 — 先に共有ランタイムルールを読み、厳密に従う必要があります。 すべてのルールを読み終えるまで、ツールを選択または呼び出してはいけません。これらのルールが最優先です。 → まず exchange-runtime-rules.md（ミラー：GitHub の exchange-runtime-rules.md）を読んでください。

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

スキルの依存関係

認証

• 対話型のファイル設定： ホスト上で 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 キーとデプロイ環境に応じて、Earn（自動投資）へのアクセス権が必要です。
• ポータル： キーの作成またはローテーションは、チャット外で行ってください：https://www.gate.com/myaccount/profile/api-key/manage

インストールの確認

• 必須： gate-cli（gate-cli のリリースから、またはお使いの環境の 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、またはこのスキルの読み取り専用の Earn／自動投資クエリ）。

リスクに関する免責事項

デジタル資産取引のリスクに関する声明： デジタル資産の取引には重大なリスクが伴います。価格は大きく変動し、市場操作の影響を受ける可能性があります。過去の実績は将来の結果を示すものではありません。このスキルが提供するのは情報提供用のツールのみであり、投資助言を構成するものではありません。投資判断はすべてユーザー自身の責任で行ってください。失っても問題のない範囲の金額のみを投資してください。リスクに関する詳しい情報は、Gate の公式ウェブサイトをご覧ください。

AI によるデータ処理

データの取り扱いに関する通知： このスキルを使用すると、取引の支援を提供するために、お客様のクエリとアカウントデータが AI システムを通じて処理されます。これには以下が含まれます。

• 取引の指示と設定
• アカウント残高とポジション情報（読み取り専用アクセス）
• コンテキストとして使用される過去の取引記録

重要：

• すべてのデータ送信は暗号化され、Gate のプライバシーポリシーに従います
• AI はデータをリアルタイムで処理します。AI が取引データを長期保存することはありません
• お客様は完全な管理権を保持します。AI が取引を実行するのは、お客様が明示的に承認した後のみです
• プライバシーの詳細については、Gate のプライバシーポリシーをご覧ください

機能モジュール

モジュール	説明	トリガーキーワード
プラン管理	自動投資プランの作成、更新、停止、ポジションの追加	create DCA、auto-invest、stop plan、add to my DCA、dollar cost averaging
情報照会	対応コイン、最小金額、実行記録、注文の詳細、プランの詳細を照会	min amount、execution history、records、plan detail

ビジネスルール

投資通貨の制限

• 投資通貨としてサポートされるのは USDT または BTC のみです（各期間に差し引かれる通貨）
• 対象のコインには、ほかの資産を指定できます

プラン作成時の制約

必須パラメーター：

• 投資対象のコイン（資産リスト）
• 期間ごとの投資額

任意のパラメーター（デフォルト値あり）：

• 投資時刻：デフォルトは毎日 10:00（変更可能）
• 資金の移動元：デフォルトは spot（現物アカウント）
• 資金の移動先：デフォルトは auto_invest（購入した資産は現物アカウントに残ります）

実行時刻の制限：

• 自動投資は毎時ちょうどの実行のみ対応しています（0～23 時）
• plan_period_hour は 0～23 の整数である必要があります
• 分と秒は指定できません。すべての実行は :00 に行われます
• ⚠️ 重要：タイムゾーン：plan_period_hour は UTC タイムゾーンを使用します
  • ユーザーが現地時刻（例：「北京時間の午前 10:00」）を指定した場合は、API に渡す前に UTC に変換してください
  • 例：北京時間 10:00（UTC+8）→ UTC 02:00 → plan_period_hour: 2 を設定
  • フォールバック：システムのタイムゾーンを検出できない場合は、ユーザーが指定した時刻をそのまま使用してください
  • 確認時には常に UTC と現地時刻の両方を表示してください（または、タイムゾーンを検出できなかったことを記載してください）
  • 詳細な変換ルールについては、references/autoinvest-plans.md → タイムゾーンの処理セクションを参照してください

plan_period_day（プラン作成時のみ）：

• 作成時に必須です。値は 0 以外である必要があります。ワークフロー全体については、references/autoinvest-plans.md → ワークフローのステップ 6 を参照してください。
• plan_period_type に応じた値：
  • monthly：月の日付 1～30
  • weekly または biweekly：曜日 1～7（1 = 月曜日、7 = 日曜日）
  • daily、hourly、または 4-hourly：1 を使用

投資額の上限と下限：

• 最小額：gate-cli cex earn auto-invest min-amount の返却値以上である必要があります
• 最大額：gate-cli cex earn auto-invest config の返却値以下である必要があります
• プランを作成する前に：
  1. gate-cli cex earn auto-invest min-amount を呼び出して最小額を確認します
  2. gate-cli cex earn auto-invest config を呼び出して最大額を確認します
  3. ユーザーが入力した金額が有効範囲内であることを検証します

投資対象コインの制約（複数対象プランの場合）：

• 投資対象コインの最大数：プランに指定できる投資対象コインは 最大 10 個です
• コインごとの最小配分率：各投資対象コインには少なくとも 10% の配分率が必要です（比率 ≥ 10）
• 複数対象プランを作成する前に：
  1. 投資対象コインの数が 10 以下であることを確認します
  2. 各コインの比率が 10 以上であることを確認します
  3. 検証に失敗した場合は、明確に説明して直ちに拒否します

資金の移動先（購入した資産の移動先）： プランの作成後、fund_flow パラメーター（API フィールド：購入後の移動先）に応じて、購入した資産は次のいずれかに移動します。

API fund_flow	意味（英語）	Gate アプリでの一般的な表示名（ローカライズされており、異なる場合があります）
earn	Simple Earn／フレキシブル Earn	英語ロケールでは、Simple Earn／フレキシブル Earn と表示されることがよくあります
auto_invest	現物アカウント（デフォルト）	現物アカウント

• fund_flow: "earn" → 資産は自動的に Simple Earn に移動し、利息を獲得します
• fund_flow: "auto_invest" → 資産は手動管理用に 現物アカウントに残ります（デフォルト）

重要：

• ユーザーは投資戦略に応じて資金の移動先を選択してください
• 蓄積した資産で不労所得を得たい場合は、earn を推奨します
• 資産を頻繁に取引または出金する予定がある場合は、auto_invest を推奨します
• ユーザーがいずれかの言語で Simple Earn（フレキシブル Earn）または現物アカウントについて言及した場合、MCP の作成／更新を呼び出す際に、それぞれ earn または auto_invest に対応付けてください
• ユーザー向けの返信では山括弧（< または >）を使用しないでください。

プラン停止後

• プランを停止すると、自動引き落としは停止します
• 購入した資産は通常、現物アカウントに残ります

次回の購入時刻

• この機能では、次回の自動購入時刻を照会できません
• この情報を確認するには、Gate アプリまたはウェブサイトをご利用ください

gate-cli コマンド一覧

自動投資関連ツール（11 個）

#	ツール名	種類	機能
1	gate-cli cex earn auto-invest create	書き込み	新しい自動投資プランを作成します （プラン作成の制約を参照）
2	gate-cli cex earn auto-invest update	書き込み	既存のプランを更新します
3	gate-cli cex earn auto-invest stop	書き込み	プランを停止します （ほかの書き込み操作と同様、呼び出し前にユーザーの明示的な確認が必要です）
4	gate-cli cex earn auto-invest add-position	書き込み ⚠️	直ちにポジションを追加します （確認後に一度だけ呼び出してください。繰り返しの呼び出しは厳禁です）
5	gate-cli cex earn auto-invest plans	クエリ	ユーザーの自動投資プランを一覧表示します
6	gate-cli cex earn auto-invest plan-detail	クエリ	単一プランの詳細を表示します
7	gate-cli cex earn auto-invest coins	クエリ	対応している投資先コインを照会します
8	gate-cli cex earn auto-invest min-amount	クエリ	最低投資額を照会します
9	gate-cli cex earn auto-invest records	クエリ	プランの実行記録を照会します
10	gate-cli cex earn auto-invest orders	クエリ	注文の詳細を照会します
11	gate-cli cex earn auto-invest config	クエリ	自動投資の設定オプションを照会します

補助ツール

ツール名	機能
gate-cli cex spot account get	現物口座の残高を照会します
gate-cli cex earn uni lends	資金の出所や引き落としに Earn が関係する場合に、Simple Earn／Uni の残高を確認するための任意の読み取り専用コンテキストです（実行 → 残高確認を参照）

クエリ機能の使用方法

ツールの対応表

ユーザーのリクエスト	使用するツール
自分の自動投資プランを一覧表示する	gate-cli cex earn auto-invest plans
単一プランの詳細を表示する	gate-cli cex earn auto-invest plan-detail
対応しているコインを照会する	gate-cli cex earn auto-invest coins
最低投資額を照会する	gate-cli cex earn auto-invest min-amount
プランの実行記録を表示する	gate-cli cex earn auto-invest records
注文の詳細を表示する	gate-cli cex earn auto-invest orders
自動投資の設定を照会する	gate-cli cex earn auto-invest config

よくあるクエリのシナリオ

シナリオ 1：対応しているコインを照会する

質問の例：

• 「自動投資できるコインは何ですか？」
• 「自動投資で対応している投資先コインは何ですか？」

操作：gate-cli cex earn auto-invest coins ツールを使用して照会します。自動投資に対応しているすべてのコインの一覧が返されます。

---

シナリオ 2：最低投資額を照会する

質問の例：

• 「USDT の自動投資における各期間の最低額はいくらですか？」
• 「投資通貨が BTC の場合、最低額はいくらですか？」

操作：gate-cli cex earn auto-invest min-amount ツールを使用します。投資通貨（USDT または BTC）と投資先コインを指定する必要があります。

---

シナリオ 3：実行履歴を表示する

質問の例：

• 「最近、BTC の自動投資は何回実行されましたか？」
• 「このプランの最近の実行状況を表示してください」

操作：gate-cli cex earn auto-invest records を使用して実行記録を確認し、gate-cli cex earn auto-invest orders を使用して個別の注文の詳細を確認します。

返される情報の例：

📋 Auto-Invest Execution Records

- Plan: {Plan name or ID}
- Execution count: {count}
- Latest execution: {amount} {currency} → {target coin}

---

シナリオ 4：プランが見つからない

状況：照会時に一致する自動投資プランが見つかりません。

プロンプト：一致する自動投資プランが見つかりませんでした。新しい自動投資プランを作成できます。

---

その他のクエリ機能

• すべてのプランを一覧表示：gate-cli cex earn auto-invest plans を使用して、自動投資プランをすべて確認します
• 設定を照会：gate-cli cex earn auto-invest config を使用して、利用可能な自動投資の設定とプリセットオプションを確認します

サブモジュール

モジュール	ドキュメント	目的
プラン管理	references/autoinvest-plans.md	詳細なシナリオに沿って、プランの作成、更新、停止、積み増し（ポジションの追加）を行うワークフローです
コンプライアンスとルール	references/autoinvest-compliance.md	投資通貨の制限、地域ごとのコンプライアンス、資金源のルールを説明します

ルーティングルール

ユーザーの意図	ルーティング先	主な判断事項
プランを作成する	references/autoinvest-plans.md → シナリオ 1/2	単一のターゲットか、複数のターゲットか
プランを更新する	references/autoinvest-plans.md	既存プランのパラメーターを変更します
プランを停止する	references/autoinvest-plans.md → シナリオ 9	自動引き落としを終了します
積み増し／ポジションを追加する	references/autoinvest-plans.md → シナリオ 10	1 回限りの追加購入です
プランを照会する	SKILL.md → ツールマッピング	gate-cli cex earn auto-invest plans
プランの詳細を照会する	SKILL.md → ツールマッピング	gate-cli cex earn auto-invest plan-detail
対応コインを照会する	SKILL.md → シナリオ 1	gate-cli cex earn auto-invest coins
最低金額を照会する	SKILL.md → シナリオ 2	gate-cli cex earn auto-invest min-amount
実行記録を照会する	SKILL.md → シナリオ 3	gate-cli cex earn auto-invest records
注文を照会する	SKILL.md → ツールマッピング	gate-cli cex earn auto-invest orders
制限について質問する	references/autoinvest-compliance.md	投資通貨、地域、資金調達

実行

1. 意図の検出：ユーザーのリクエストを分析し、操作の種類（作成／更新／停止／積み増し／照会／コンプライアンス）を判断します
2. ルートの選択：
   • プランのライフサイクル操作（作成／更新／停止／積み増し）→ references/autoinvest-plans.md を読み込み、ワークフローに従います
   • 照会操作 → ツールマッピング表を使用し、対応する MCP ツールを直接呼び出します
   • コンプライアンスに関する質問 → references/autoinvest-compliance.md を読み込み、ルールと制限を確認します
3. パラメーターの検証：
   • 書き込み操作の場合：投資通貨（USDT/BTC のみ）、金額の範囲、実行時刻、および プランの作成 では プラン作成の制約 に従った plan_period_day を検証します
   • 照会の場合：ユーザーのリクエストから必要なパラメーターを抽出します
4. 残高の確認（書き込み操作の場合）：
   • gate-cli cex spot account get を呼び出し、資金が十分か確認します
   • Simple Earn を資金源とする場合、該当するときは gate-cli cex earn uni lends を呼び出します
5. 確認（書き込み操作の場合）：
   • 操作の概要（アクション案）を表示します
   • ユーザーが明示的に確認するまで待ちます
   • プランの停止（gate-cli cex earn auto-invest stop）：アクション案 と 停止 を表示します。この同じアシスタントターンではツールを呼び出さないでください。ユーザーの次のメッセージに明示的な確認が含まれた後にのみ、停止を呼び出します（references/autoinvest-plans.md → シナリオ 9）。
6. MCP ツールの呼び出し：
   • MCP ツール セクション（Auto-Invest 関連ツールまたはサポートツールの表）にある対応ツールのみを実行します
   • 検証済みのパラメーターを渡します
7. 応答の書式設定：
   • サブモジュールのドキュメントにある応答テンプレートを使用します
   • プラン ID、金額、通貨、ターゲット、実行間隔などの重要な情報を含めます

ドメイン知識

Auto-Invest（DCA）とは？

ドルコスト平均法（DCA） とは、市場の状況にかかわらず、一定の金額を定期的に投資する投資戦略です。この方法には次の利点があります。

• 購入を時間的に分散し、タイミングリスクを軽減します
• 市場の変動を通じて購入価格を平均化します
• 投資における感情的な判断をなくします
• 長期的な資産形成戦略に適しています

Auto-Invest と手動取引の比較

項目	Auto-Invest（DCA）	手動取引
実行	自動、スケジュール設定	手動、オンデマンド
規律	高い（感情に左右されない）	変動（感情に左右される）
タイミング	時間をかけて分散	1 時点
用途	長期的な資産形成	アクティブ取引
必要なスキル	低い	高い

投資通貨

• 投資通貨：各期間にアカウントから差し引かれる通貨（USDT または BTC のみ）
• 対象コイン：購入したい暗号資産（サポートされているコインであればどれでも可）
• 例：100 USDT（投資通貨）を投資 → BTC（対象コイン）を購入

実行頻度のオプション

期間の種類	説明	最小間隔
毎時	N 時間ごと	1 時間
毎日	指定した時刻に毎日	1 日
毎週	指定した曜日に毎週	7 日
隔週	2 週間ごと	14 日
毎月	指定した日に毎月	約 30 日

資金フローのオプション

プランの作成後、購入した資産は次のいずれかの送金先に送られます：

オプション	フィールド値	送金先	中国語 UI（一般的な表示）	説明	用途
シンプルアーン	fund_flow: "earn"	シンプルアーン	アプリ内のローカライズされたラベル	資産は利息を得るためにシンプルアーンへ自動的に送金されます	おすすめ： 不労所得を求める方、リターンの最大化を目指す長期保有者
現物アカウント	fund_flow: "auto_invest"	現物アカウント	アプリ内のローカライズされたラベル	資産は手動管理のため現物アカウントに残ります（デフォルト）	おすすめ： アクティブトレーダー、頻繁に資産を出金または送金する予定のユーザー

重要事項：

• この設定により、購入したコインが各自動投資の実行後にどこへ送られるか（購入後の送金先）が決まります。
• earn はシンプルアーンに、auto_invest は現物アカウントに対応します。API の値はアプリ内のローカライズされた文字列に対応しています。ドキュメントとアプリの表示が異なる場合は、アプリ内の表示に従ってください。
• earn オプションを使うと、蓄積した資産から追加の不労所得を得られます。
• auto_invest オプションを使うと、いつでも取引、出金、送金を行えます。
• 指定がない場合のデフォルトは auto_invest です。

安全ルール

デフォルト：確認なしで書き込みを行わない

ユーザーが現在のアクション案に対して明示的に確認するまでは、書き込みツール（gate-cli cex earn auto-invest create、gate-cli cex earn auto-invest update、gate-cli cex earn auto-invest stop、gate-cli cex earn auto-invest add-position）を呼び出さないでください。許可されるのは読み取り／照会操作のみです。たとえば、プランの一覧／詳細、対応コイン、最小／最大設定、実行記録と注文、残高の確認（gate-cli cex spot account get、gate-cli cex earn uni lends）などです。

書き込み操作に必須の確認

すべての書き込み操作（作成、更新、停止、ポジション追加）では、必ず次の確認ワークフローに従ってください。

1. アクション案を表示：実行前に操作の詳細をすべて提示します
2. 確認を待つ：ユーザーに「続行するには確認してください」と明示的に尋ねます
3. 確認後にのみ実行：ユーザーの明示的な同意がなければ続行しません

プランの停止（gate-cli cex earn auto-invest stop）：アクション案（プラン ID、名前、効果：今後の引き落としが停止すること）を表示し、確認を求めて応答を終了します。MCP を呼び出せるのは、ユーザーの次のメッセージで明示的な確認があった後のみです。ユーザーがすでにプラン ID を指定していても、最初の案を提示する応答と同じアシスタント応答内で停止を呼び出してはいけません。

古い確認

ユーザーがアクション案を確認した後で重要な詳細（金額、対象、実行頻度、プラン ID、資金フロー、plan_period_hour、plan_period_day など）を変更した場合、以前の確認は無効として扱ってください。更新したアクション案を提示し、書き込みツールを呼び出す前に新たな明示的な確認を取得してください。

ポジション追加の安全対策（重要）

⚠️ gate-cli cex earn auto-invest add-position ツールは非常に慎重な取り扱いが必要です：

• ユーザーの確認ごとに必ず 1 回だけ呼び出してください
• 同じリクエストに対して複数回呼び出してはいけません（引き落としが重複する原因になります）
• 呼び出し前に必ず金額をユーザーに確認してください
• 呼び出し前に残高を確認してください

悪い例 ❌：

User: "Add more to my plan"
Assistant: [Calls add_position multiple times to show different amounts]

良い例 ✅：

User: "Add more to my plan"
Assistant: "How much would you like to add? Your current plan is 100 USDT per period."
User: "Add 50 USDT"
Assistant: [Shows draft] "Confirm to add 50 USDT?"
User: "Yes"
Assistant: [Calls add_position ONCE]

パラメータの検証

書き込みツールを呼び出す前に、必ず次の項目を検証してください。

検証項目	ルール	失敗した場合の対応
投資通貨	USDT または BTC である必要があります	拒否し、制限について説明します
金額	[min, max] の範囲内である必要があります	最小値／最大値を照会してから拒否し、有効な範囲を示します
実行時刻	0～23 の整数（時刻ちょうど）である必要があります	拒否し、時刻単位の制限について説明します
plan_period_day（作成時）	0 は不可です。範囲は plan_period_type ごとに異なります（Create Plan Constraints を参照）	許可される範囲を示して拒否します。references/autoinvest-plans.md の Workflow ステップ 6 を参照してください
残高	初回分の期間に必要な額を満たしている必要があります	不足額を示し、入金または金額の引き下げを提案します

次回購入時刻の推測禁止

• 次回の自動購入時刻を計算または表示しないでください
• ユーザーから尋ねられた場合は、リアルタイムのスケジュールを Gate アプリまたはウェブサイトで確認するよう案内してください
• この情報は API では提供されません

エラー処理

エラー条件	検出方法	対応
対象コインが多すぎる	ユーザーが 10 個を超える対象コインを指定	直ちに拒否します：「プランに設定できる対象コインは最大 10 個です。{N} 個のコインが指定されています。対象数を減らしてください。」
コインの配分が少なすぎる	いずれかの対象コインの比率が 10 未満	直ちに拒否します：「各対象コインには少なくとも 10% の配分が必要です。コイン {X} の配分はわずか {Y}% です。各コインが少なくとも 10% になるよう比率を調整してください。」
残高不足	gate-cli cex spot account get で残高が金額を下回っている	続行しないでください。不足額をユーザーに通知します：「現在の残高は {X} {currency} ですが、{Y} {currency} が必要です。追加入金するか、投資額を減らしてください。」
無効な投資通貨	ユーザーが USDT/BTC 以外の通貨を指定	直ちに拒否します：「投資通貨として対応しているのは USDT または BTC のみです。USDT または BTC を選択してください。」
最小額未満	ユーザーの金額が gate-cli cex earn auto-invest min-amount を下回っている	最小額ツールを呼び出してから、次のように通知します：「最小額は {min} {currency} です。投資額を増やしてください。」
最大額超過	ユーザーの金額が gate-cli cex earn auto-invest config の最大額を超えている	設定ツールを呼び出してから、次のように通知します：「最大額は {max} {currency} です。投資額を減らしてください。」
無効な実行時刻	ユーザーが分／秒、または 0～23 の範囲外の時刻を指定	拒否します：「自動投資の実行は時刻ちょうど（0～23）のみ対応しています。0～23 の時刻を選択してください。」
無効な plan_period_day	作成時に 0 が指定された、または plan_period_type に対して範囲外	作成ツールを呼び出さず、有効な範囲を示します。月次は 1～30、週次／隔週は 1～7（1 = 月曜日）、日次／時間単位／4 時間単位は 1（references/autoinvest-plans.md の Workflow ステップ 6）
プランが見つからない	照会結果に一致するプランがない	次のように通知します：「一致する自動投資プランが見つかりませんでした。新しいプランを作成できます。」（シナリオ 4 を参照）
MCP ツールが見つからない	MCP サービスで必要なツールを利用できない	次のように説明します：「自動投資機能には、更新済みの MCP サービスが必要です。gate-mcp が正しく設定されていることを確認してください。」
API エラー（401/403）	認証失敗	次のように案内します：「認証エラーです。API キーの権限に Earn（自動投資）へのアクセスが含まれているか確認してください。」認証処理については exchange-runtime-rules.md を参照してください。
API エラー（4xx/5xx）	その他の API エラー	エラーメッセージを報告し、再試行またはサポートへの問い合わせを提案します
必須パラメータの不足	ツールのスキーマで、デフォルト値のないパラメータが必須とされている	推測しないでください。ユーザーに次のように尋ねます：「{parameter_name} を指定してください（例：{example}）。」

パラメータの適正管理

• ツールのパラメータが必須で、スキーマにデフォルト値がない場合は、ユーザーに値を尋ねてください
• パラメータの値を決して推測したり、作り出したりしないでください
• ツールを呼び出す前に、必ずビジネスルールに照らしてパラメータを検証してください

判断ロジックの概要

条件	アクション	使用するツール
ユーザーがプランの作成を希望している	references/autoinvest-plans.md のシナリオ 1/2 に進む	検証（plan_period_day を含む）→ gate-cli cex spot account get（資金源が Earn の場合は gate-cli cex earn uni lends も実行）→ gate-cli cex earn auto-invest min-amount → gate-cli cex earn auto-invest config → 確認 → gate-cli cex earn auto-invest create
ユーザーがプランの更新を希望している	references/autoinvest-plans.md に進む	gate-cli cex earn auto-invest plans（ID がない場合）→ 確認 → gate-cli cex earn auto-invest update
ユーザーがプランの停止を希望している	references/autoinvest-plans.md のシナリオ 9 に進む	gate-cli cex earn auto-invest plans（ID がない場合）→ アクション案を提示（ターン終了）→ ユーザーの次のメッセージで確認 → gate-cli cex earn auto-invest stop
ユーザーが追加購入（ポジション追加）を希望している	references/autoinvest-plans.md のシナリオ 10 に進む	gate-cli cex earn auto-invest plans（ID がない場合）→ gate-cli cex earn auto-invest plan-detail（金額がない場合）→ gate-cli cex spot account get → 確認 → gate-cli cex earn auto-invest add-position（1 回のみ）
ユーザーがプラン一覧を希望している	直接照会	gate-cli cex earn auto-invest plans
ユーザーがプランの詳細を希望している	直接照会	gate-cli cex earn auto-invest plan-detail
ユーザーが「対象のコインはどれですか？」と尋ねている	シナリオ 1	gate-cli cex earn auto-invest coins
ユーザーが「最小金額はいくらですか？」と尋ねている	シナリオ 2	gate-cli cex earn auto-invest min-amount
ユーザーが「実行履歴はありますか？」と尋ねている	シナリオ 3	gate-cli cex earn auto-invest records
ユーザーが「注文の詳細はありますか？」と尋ねている	直接照会	gate-cli cex earn auto-invest orders
ユーザーが投資通貨の制限について尋ねている	references/autoinvest-compliance.md に進む	USDT/BTC のみというルールを説明する
ユーザーが資金源について尋ねている	references/autoinvest-compliance.md に進む	Spot と Earn の選択肢を説明する
照会でプランが見つからない	シナリオ 4	ユーザーに伝え、新しいプランの作成を提案する
残高が不足している	エラー処理	不足額を表示し、処理を続行しない
パラメーターが無効である	エラー処理	ビジネスルールに照らして検証し、説明を添えて拒否する

レポートテンプレート

プラン作成成功時

✅ Auto-invest plan created

- Invest currency: {USDT|BTC}
- Amount per period: {amount}
- Cadence: {cadence description}
- Target(s): {target coin(s) with ratios if multi-target}
- Fund source: {spot|earn}
- Fund flow: {auto_invest|earn} (spot account|Simple Earn)

プラン更新成功時

✅ Auto-invest plan updated

- Plan: {id or name}
- Updated: {changed fields and new values}

プラン停止成功時

✅ Auto-invest plan stopped

- Plan: {id or name}
- Status: Automatic deductions ceased
- Note: Purchased assets remain in {account type}

追加購入成功時

✅ Top-up executed

- Plan: {id or name}
- Amount: {amount} {invest_currency}
- Target allocation: {per Business Rules}

照会への応答（プラン一覧）

📋 Your Auto-Invest Plans

{For each plan:}
**Plan {N}: {plan_name}**
- Investment: {amount} {currency} per {cadence}
- Target(s): {coin(s)}
- Execution count: {period} times
- Status: Active

{If no plans:}
You have no active auto-invest plans. Create one to start DCA investing.

照会への応答（対応コイン）

📋 Supported Auto-Invest Coins

{List coins returned by `gate-cli cex earn auto-invest coins`}

You can use any of these coins as targets in your auto-invest plan.

照会への応答（最小金額）

📋 Minimum Investment Amount

- Investment currency: {USDT|BTC}
- Target(s): {coin(s)}
- Minimum per period: {min_amount} {currency}

エラー応答

❌ {Error type}

{Explanation of what went wrong}

{Actionable suggestion to resolve}

参考ドキュメント

ドキュメント	内容
references/scenarios.md	16 のシナリオ（プランのライフサイクル、照会、コンプライアンス）を網羅したシナリオ一覧
references/autoinvest-plans.md	プランのライフサイクルに関する操作とシナリオ（作成、更新、停止、追加購入）
references/autoinvest-compliance.md	コンプライアンスのルールと制限（投資通貨、地域、資金調達）