gate-exchange-welfare

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 Welfare Center

一般ルール

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

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

スキルの依存関係

使用する gate-cli コマンド

クエリ操作

• gate-cli cex welfare identity
• gate-cli cex welfare beginner-tasks

実行操作

• cex_welfare_claim_task（gate-cli/cmd/cex に gate-cli の対応付けはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照してください）
• cex_welfare_claim_reward（gate-cli/cmd/cex に gate-cli の対応付けはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照してください）

認証

• 対話形式でのファイル設定： ホストで 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 MCP デプロイ環境での福利照会および申請アクセス
• ポータル： チャット外でキーを作成またはローテーションしてください：https://www.gate.com/myaccount/profile/api-key/manage

インストールの確認

• 必須： gate-cli（見つからない場合は、このスキルのディレクトリから sh ./setup.sh を実行してください。GATE_CLI_SETUP_MODE=release は任意です）。
• gate-cli を名前で呼び出す場合は、$HOME/.openclaw/skills/bin（または setup.sh がインストールするディレクトリ）を PATH に追加してください。
• 認証情報： ホストに GATE_API_KEY と GATE_API_SECRET の両方が空でない値として設定されている場合、gate-cli にとって有効な設定と同等のため、gate-cli config init を必須にしないでください。両方とも未設定または空の場合、オペレーターに gate-cli config init を実行するか、スキルライブラリ内の対応するスキルで GATE_API_KEY／GATE_API_SECRET を設定するよう促してください（ユーザーにシークレットをチャットに貼り付けるよう求めないでください）。
• 健全性チェック： CLI が想定どおりに動作するまで、認証が必要な呼び出しに進まないでください（例：gate-cli --version、またはこのスキルの読み取り専用 gate-cli cex ... コマンド）。変更を伴う操作の前に、認証情報が解決されていることを確認してください。

実行モード

references/gate-cli.md を読み、厳守してから、このスキルの福利ワークフローを実行してください。

• SKILL.md は、ルーティング、ビジネス意図のマッピング、安全ルールを定めます。
• references/gate-cli.md は、ID によるゲーティング、タスクの検索、タスクの申請、報酬の申請、および縮退時の処理に関する、権威ある gate-cli 実行仕様です。

概要

福利センターの新規ユーザー向けスキル、第2フェーズです。ユーザーから福利、新規ユーザー特典、タスクの受け取り、タスクの完了、特典の受け取りについて質問された場合は、まずユーザーが対象かどうかを確認します。その後、利用制限のあるユーザーや既存ユーザーへの案内、実際の新規ユーザー向けタスクの表示、単一タスクの受け取り、タスク完了方法の案内、または現在受け取り可能な新規ユーザー特典の一括受け取りを行います。

トリガーシナリオ：ユーザーが福利厚生、新規ユーザー特典、タスクリスト、タスクの受け取り、福利タスクの完了、新規ユーザー特典の受け取りについて言及した場合、このスキルを実行します。

---

ドメイン知識

対象者コード

• code=0：対象の新規ユーザー
• code=1001：既存ユーザー
• code=1002：リスク管理対象ユーザー
• code=1003：サブアカウント
• code=1004：エージェントユーザー
• code=1005：マーケットメーカー
• code=1006：法人ユーザー
• code=1008：未ログイン

初心者向けタスクリストの仕様

• 新規ユーザー向けリストは gate-cli cex welfare beginner-tasks で取得します。
• 登録タスクは案内タスクより先に返されます。
• ユーザーがダウンロードタスクをまだ受け取っておらず、システムがアプリは未ダウンロードと判定した場合、リストに task_type=23 かつ status=0 の ダウンロードタスク が含まれることがあります。
• task_desc に <span> などの単純な HTML が含まれる場合があります。生のタグではなく、テキスト部分のみを表示してください。

タスクタイプに関する注意

• task_type=10：登録タスク
• task_type=23：ダウンロードタスク
• 案内タスクでは、次のようなタスクシーンコードが表示されることがあります。
• 1：KYC／本人確認
• 2：現物取引
• 3：先物取引
• 8：初回入金
• 実際のペイロードでは、ほかのサポート対象のタスクシーン値が使われる場合があります。上記の対応関係以外を決めつけてハードコードせず、実際の MCP ペイロードに従ってください。

ステータスの対応関係

ステータス	意味	対応
0	未受け取り／タスクを受け取り可能	cex_welfare_claim_task の対象候補（gate-cli/cmd/cex に gate-cli の対応付けはありません。「MCP_LEGACY_TOOL_RESOLUTION.md」§二を参照）
1	受け取り済み／進行中	ユーザーにタスクの操作を完了するよう案内します
2	完了、特典を受け取り可能	cex_welfare_claim_reward の対象候補（gate-cli/cmd/cex に gate-cli の対応付けはありません。「MCP_LEGACY_TOOL_RESOLUTION.md」§二を参照）
3	特典の配布中	特典を処理中であることをユーザーに伝えます
4	完了／精算済み	タスクはすでに完了していることをユーザーに伝えます
5	期限切れ	タスクの期限が切れていることをユーザーに伝えます

特典ハブ

• 公式ハブ：https://www.gate.com/zh/rewards_hub
• API から信頼できる操作結果を取得できない場合は、代替手段として公式ウェブサイト／アプリの福利センターを案内してください。

---

ルーティングルール

ユーザーの意図	キーワード／パターン	ルーティング
福利／特典／タスクリストの確認	"どんな福利がある", "できるタスクは何", "新規ユーザー向けタスク", "福利の特典"	このスキルを実行 → まず対象者を確認
タスクの受け取り	"タスクを受け取る", "ダウンロードタスクを受け取る", "タスクを受領する"	このスキルを実行 → 対象者確認 → タスク一覧 → status=0 のタスクを1つ受け取る
KYC タスクの完了	"本人確認タスクを完了する", "KYC タスクを完了する"	このスキルを実行 → KYC に関する一般的な案内を返す
初回入金タスクの完了	"初回入金タスクを完了する", "入金タスクをどう完了するか"	このスキルを実行 → 入金に関する一般的な案内を返す
初回取引タスクの完了	"初回取引タスクを完了する", "初めての取引をしたい"	このスキルを実行 → gate-exchange-trading に引き継ぐ
タスクの完了（曖昧な場合）	"タスクを完了する", "福利タスクを終わらせる"	このスキルを実行 → 対象者確認 → 対応可能なタスクを一覧表示 → タスクを特定
特典の受け取り／すべての特典の受け取り	"特典を受け取る", "すべての特典を受け取る", "新規ユーザー特典を受け取る"	このスキルを実行 → 対象者確認 → タスク一覧 → status=2 のタスクをすべて受け取る
資産の確認	"残高を確認する", "USDT をいくら持っているか"	gate-exchange-assets にルーティング

---

実行

ステップ 1：ユーザーの本人確認

すべての福利厚生関連の意図について、最初に gate-cli cex welfare identity を呼び出します。

code に応じて分岐します：

• 0 → 新規ユーザー向けフロー
• 1001 → 既存ユーザー向け案内
• 1002/1003/1004/1005/1006/1008 → 対応する制限に関する案内
• その他の失敗／タイムアウト／HTTP 4xx → 劣化時のフォールバック

基本フロー：新規ユーザー向けタスクの照会または一覧表示

トリガー：新規ユーザー向けの特典／タスク／報酬について尋ねられた場合。

必須フロー：

1. gate-cli cex welfare identity を呼び出します。
2. code=0 の場合、gate-cli cex welfare beginner-tasks を呼び出します。
3. 一覧の結果が code=1007、またはタスクリストが空の場合、タスクなしのフォールバックを返します。
4. 実際の各タスクについて、次の項目を表示します：

• task_name
• HTML タグを削除した task_desc
• reward_num
• reward_unit
• status

5. 各タスクの次のステップを status に基づいて示します：

• 0：受け取り可能です
• 1：タスクのアクションを完了してください
• 2：報酬を受け取り可能です
• 3：報酬を配布中です
• 4：すでに完了しています
• 5：期限切れです

ケース 1：単一のタスクを受け取る

トリガー：ユーザーがタスクの受け取りを求めた場合。通常はダウンロードタスクです。

必須フロー：

1. gate-cli cex welfare identity を呼び出します。
2. gate-cli cex welfare beginner-tasks を呼び出します。
3. status=0 の受け取り可能なタスクを探します。
4. 対象タスクを特定します：

• ユーザーがタスク名を指定した場合、task_name で照合します。
• 受け取り可能なタスクがちょうど 1 つの場合は、そのタスクを使用します。
• 受け取り可能なタスクが複数あり、意図が曖昧な場合は、どのタスクを受け取るか尋ねます。

5. 選択した welfare_task_id を指定して cex_welfare_claim_task（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）を呼び出します。
6. 成功した場合、受け取ったタスク名を伝え、報酬を受け取る前にタスクを完了するようユーザーに案内します。

status が 0 ではないタスクに対して、cex_welfare_claim_task（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）を呼び出してはいけません。

ケース 2：本人確認タスクを完了する

トリガー：ユーザーが KYC／本人確認の新規ユーザー向けタスクの完了を求めた場合。

必須の対応：

• 福利厚生関連の書き込みツールを呼び出してはいけません。
• たとえば、次のような一般的な KYC 案内を返します：

Please complete identity verification in Gate web or the Gate App first. After the verification is approved and the newcomer task becomes claimable, come back to the welfare center to claim the reward.

ケース 3：初回入金タスクを完了する

トリガー：ユーザーが初回入金の新規ユーザー向けタスクの完了を求めた場合。

必須の対応：

• 福利厚生関連の書き込みツールを呼び出してはいけません。
• しきい値を捏造せず、一般的な入金案内を返します：

Please complete your first deposit in Gate web or the Gate App using the deposit flow shown there. Deposit requirements, supported assets, and any threshold conditions follow the Rewards Hub display. After the deposit is credited and the task becomes claimable, come back to claim the reward.

ケース 4：初回取引タスクを完了する

トリガー：ユーザーが初回取引の新規ユーザー向けタスクの完了を求めた場合。

→ gate-exchange-trading/references/execution-and-guardrails.md を読みます。

必須の対応：

• gate-exchange-trading に引き継ぎます。
• ユーザーがまだ取引対象を指定していない場合は、取引スキルでシンボル／売買の方向／数量を確認し、そのスキル独自のアクション案と確認ルールに従います。

ケース 5：タスク完了の意図が曖昧な場合

トリガー：ユーザーが「タスクを完了して」など、同等のことだけを述べた場合。

必須フロー：

1. gate-cli cex welfare identity を呼び出します。
2. gate-cli cex welfare beginner-tasks を呼び出します。
3. status が 0 または 1 のタスクから、実行可能なタスクの一覧を作成します。
4. 実行可能なタスクが複数ある場合は、どのタスクを完了するかユーザーに尋ねます。
5. 実行可能なタスクがちょうど 1 つの場合：

• status=0 → ケース 1 を使用します
• タスク名または task_type が KYC を示す場合 → ケース 2 を使用します
• タスク名または task_type が初回入金を示す場合 → ケース 3 を使用します
• タスク名または task_type が取引を示す場合 → ケース 4 を使用します
• それ以外の場合は、一般的な完了方法を案内し、報酬ページへのフォールバックを提示します

ケース 6：報酬を受け取る

トリガー：ユーザーが報酬の受け取り、またはすべての報酬の受け取りを依頼した場合。 必須フロー：

1. gate-cli cex welfare identity を呼び出します。
2. gate-cli cex welfare beginner-tasks を呼び出します。
3. status=2 のタスクを絞り込みます。
4. 該当するタスクがない場合は、現在受け取り可能な新規ユーザー向け報酬はないことをユーザーに伝えます。
5. 一般的な「報酬を受け取る」という意図の場合、status=2 のすべてのタスクを順に処理し、1つずつ cex_welfare_claim_reward を呼び出します（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照してください）。
6. 受け取りに成功するたびに：

• 受け取り応答の coupon_full_name を優先します。
• coupon_full_name が空の場合は、タスクの reward_num と reward_unit を使用します。

7. タスクから has_m_n_task=true が返された場合、そのタスクの報酬配布を完了しないでください。代わりに、手動で受け取るために Gate のウェブ／アプリの報酬ハブを利用するようユーザーに案内します。

---

応答テンプレート

既存ユーザー向けの案内

Please visit Gate web at https://www.gate.com/zh/rewards_hub or open the Gate App to view welfare activities, exclusive benefits, and reward redemption items.

新規ユーザー向けタスクリスト

Your newcomer welfare tasks:

- {task_name}
 Description: {task_desc_without_html}
 Reward: {reward_num} {reward_unit}
 Status: {mapped_status}
 Next step: {claim task / complete task / claim reward / distributing / completed / expired}

タスク受け取り成功

Successfully claimed {task_name}. Complete the task first, then you can claim {reward_num} {reward_unit}.

報酬受け取り成功

You have claimed these newcomer rewards:

- {task_name}: {coupon_full_name_or_reward_num_reward_unit}
- {task_name}: {coupon_full_name_or_reward_num_reward_unit}

M-select-N 報酬のフォールバック

This reward must be claimed from Gate web at https://www.gate.com/zh/rewards_hub or from the Gate App welfare center.

---

エラー処理

例外の種類	対応方法
既存ユーザー（code=1001）	報酬ハブの案内を表示します
リスク管理対象のユーザー（code=1002）	「お客様のアカウントは一時的に福利厚生活動に参加できません。詳細についてはカスタマーサービスにお問い合わせください。」
サブアカウント（code=1003）	「サブアカウントではこの福利厚生活動に参加できません。メインアカウントでログインしてください。」
エージェントユーザー（code=1004）	「エージェントユーザーはこの福利厚生活動に参加できません。」
マーケットメイカー（code=1005）	「マーケットメイカーユーザーはこの福利厚生活動に参加できません。」
法人ユーザー（code=1006）	「法人ユーザーはこの福利厚生活動に参加できません。」
タスクデータなし（code=1007）	「現在、有効な新規ユーザー向け福利厚生タスクはありません。報酬ハブでほかのアクティビティをご確認ください。」
未ログイン（code=1008）	「まずGateアカウントにログインしてください。」
ID確認／リストのタイムアウト、またはMCPが利用不可	「福利厚生情報を一時的に利用できません。しばらくしてからもう一度お試しいただくか、https://www.gate.com/zh/rewards_hub に直接アクセスしてください。」
タスク受け取り：無効なアクティビティ（51501009）	タスクは無効になったか、利用できなくなったことをユーザーに伝えます
タスク受け取り：すでに受け取り済み／条件未達（51501010）	タスクは再度受け取れないか、条件をまだ満たしていないことをユーザーに伝えます
タスクまたは報酬の受け取り：リスク判定により拒否（51501026）	アカウントは一時的に福利厚生センターの対象外であることをユーザーに伝えます
報酬受け取り：再度更新が必要（51501027）	タスクリストを更新／再確認してから、もう一度お試しいただくようユーザーに依頼します
報酬受け取り：タスクの期限切れ（51501034）	報酬の受け取り期間が終了したことをユーザーに伝えます
報酬受け取り：記録が存在しない（51501004）	報酬記録は利用できなくなったことをユーザーに伝え、タスクリストの更新を提案します
標準の label と message を含むHTTP 4xx	ゲートウェイエラーの概要を表示して処理を中止します。HTTP 200 だけを成功と判断しないでください

---

スキル間連携

ユーザーの追加依頼	ルーティング先
ユーザーが最初の取引を行いたい	gate-exchange-trading
ユーザーが現物取引のみの操作に絞った	gate-exchange-spot
ユーザーが一般的な資産残高について尋ねる	gate-exchange-assets
ユーザーが福利厚生の完了案内以外で一般的なKYCのステータス／詳細について尋ねる	gate-exchange-kyc

---

安全ルール

1. 最初に本人確認ゲートを通過：新規ユーザー向けのタスク詳細を表示する前、タスクを獲得する前、または報酬を獲得する前に、必ず gate-cli cex welfare identity を呼び出してください。
2. 許可されたツールのみ使用：このスキルで説明されている4つのMCPツールのみを使用してください。
3. 業務コードを正とする：成功または失敗は、HTTP 200 だけではなく、レスポンスの code で判定してください。
4. 実データのみ使用：タスク名、説明、報酬の数値、報酬単位、報酬タイトルを決して捏造しないでください。
5. タスクの説明を整える：ユーザーにテキストを提示する前に、task_desc から生のHTMLタグを削除してください。
6. タスク獲得の前提条件：現在のタスクリストにある status=0 のタスクに対してのみ、cex_welfare_claim_task を呼び出してください（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）。
7. 報酬獲得の前提条件：現在 status=2 と表示されているタスクに対してのみ、cex_welfare_claim_reward を呼び出してください（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）。
8. M-select-N の処理：has_m_n_task=true の場合、報酬を獲得したと報告しないでください。公式の報酬ハブ／アプリに案内してください。
9. 無関係な取引操作の書き込みは禁止：入金の実行と取引の実行は、このスキルの対象外です。適切なプロダクトスキルに案内してください。
10. 安全なフォールバック：MCPのデータが利用できない、または整合性がない場合、推測せずに https://www.gate.com/zh/rewards_hub に案内してください。