gate-exchange-candydrop

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 CandyDrop

執筆言語： このスキルの手順とリファレンスの説明は、Gate スキルの標準に従い、英語で記述されています。エンドユーザーへの応答には、引き続き言語への適応（ユーザーのロケールに合わせる）が適用されます。

一般ルール

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

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

スキルの依存関係

使用する gate-cli コマンド

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

• gate-cli cex launch candy-drop activities
• gate-cli cex launch candy-drop rules

照会操作（読み取り専用、認証が必要）

• gate-cli cex launch candy-drop progress
• gate-cli cex launch candy-drop participations
• gate-cli cex launch candy-drop airdrops

実行操作（書き込み）

• gate-cli cex launch candy-drop register

認証

• 対話形式でのファイル設定： ホスト上で 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 を使用する場合です。シークレットをチャットに貼り付けるようユーザーに求めてはいけません。
• 権限： Launch:Write
• ポータル： チャット外でキーを作成またはローテーションしてください：https://www.gate.com/myaccount/profile/api-key/manage

インストールの確認

• 必須： Gate（メイン）、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 にとって有効な設定と同等です。両方とも未設定または空の場合は、gate-cli config init を実行するか、スキルライブラリ内の該当するスキルで GATE_API_KEY ／ GATE_API_SECRET を設定するよう、オペレーターに注意を促してください（シークレットをチャットに貼り付けるようユーザーに求めてはいけません）。
• 動作確認： 認証が必要な呼び出しや変更を伴う呼び出しの前に、ランタイムが動作することを確認してください（例：gate-cli --version、またはこのスキルに適した読み取り専用チェック）。登録や書き込み操作の前に、認証情報を解決してください。

実行モード

このスキルの CandyDrop ワークフローを実行する前に、references/gate-cli.md を読み、厳守してください。

• SKILL.md はルーティングと製品のセマンティクスを扱います。
• references/gate-cli.md は、アクティビティ／ルールの照会、登録の確認ゲート、進捗／記録の照会、結果の検証に関する、正式な gate-cli 実行契約です。

モジュールの概要

モジュール	説明	トリガーキーワード
アクティビティ一覧	CandyDrop のアクティビティを閲覧し、ステータス／コイン／タスクタイプで絞り込みます	candydrop, candydrop activities, activity list, ongoing candydrop, USDT candydrop
アクティビティルール	アクティビティのルール、賞金プール、タスクを確認します	activity rules, task rules, prize pool, reward rules, candydrop rules
登録	CandyDrop のアクティビティに登録します	register, join activity, candydrop register, participate candydrop
タスクの進捗	登録済みアクティビティのタスク完了状況を照会します	task progress, completion progress, progress query, task progress
参加記録	登録／参加履歴を照会します	participation records, registration records, history records, participation records
エアドロップ記録	エアドロップ／報酬の配布記録を照会します	airdrop records, reward records, received records, airdrop records

ドメイン知識

CandyDrop の概念

概念	説明
CandyDrop	ユーザーがタスク（取引、入金など）を完了し、賞金プールからエアドロップ報酬を獲得する Gate のアクティビティプラットフォームです。
アクティビティ（currency / activity_id）	特定のトークンを対象とする CandyDrop キャンペーンです。currency（トークンシンボル）または activity_id（数値 ID）で識別されます。
アクティビティのステータス	ライフサイクルは upcoming（開催予定）→ ongoing（開催中）→ ended（終了）です。
登録ステータス	registered（登録済み）または unregistered（未登録）です。
記録のステータス	参加記録の場合、ongoing（進行中）、awaiting_draw（抽選待ち）、won（当選）、not_win（落選）です。
賞金プール	各アクティビティには 1 つ以上の賞金プールがあり、それぞれに賞金総額（prize_all）、ユーザーごとの上限額（prize_limit）、タスク一覧があります。
タスク	賞金プール内の個別のチャレンジです（例：現物取引、先物取引、入金、招待）。それぞれに名前（task_name）、説明（task_desc）、専用ラベル（exclusive_label）があります。
タスクの進捗	タスクの現在の達成値です（例：取引量、入金額）。登録済みのタスク（task_status > 0）についてのみ表示されます。

タイムスタンプの形式

• API は時間フィールド（例：start_time、end_time、register_time、airdrop_time）を、YYYY-MM-DD HH:MM:SS(UTC) 形式の書式設定済み UTC 文字列として返します。
• テーブル／一覧：時刻が UTC の場合、列見出しに (UTC) を付けてください。列見出しにすでに (UTC)（ASCII または全角の句読点の違いを含む）が記載されている場合は、各セルで繰り返さないでください。API の値末尾にある (UTC) を取り除き、YYYY-MM-DD HH:MM:SS のみを表示してください（例：2026-04-13 04:04:10。2026-04-13 04:04:10(UTC) ではありません）。見出しに UTC の記載がない場合は、タイムゾーン情報が失われないよう API の文字列をそのまま使用してください。
• その他の表示形式（例：UTC の見出しがないインライン文）では、API の形式のまま使用するか、1 つの返信内で見出しに UTC を付けてセルから取り除く形式に統一できます。
• 記録のクエリパラメーター start_time / end_time は、**整数の Unix タイムスタンプ（秒）**です。正しい計算方法については references/records.md の タイムスタンプの方針を参照してください。

数値の形式

カテゴリー	精度	例
金額（報酬、進捗値）	小数点以下 8 桁、末尾のゼロは省略	1.23。1.23000000 ではありません
エアドロップの rewards（表示）	同じ数値形式を適用し、さらに + 行の currency を追加	4.02032 ETH。4.02032 ではありません
パーセンテージ形式のフィールド	小数点以下 2 桁、末尾のゼロも表示	5.20%。5.2% ではありません

2つのパラメーターによる検索

アクティビティの検索インターフェースでは、activity_id または currency のいずれかでアクティビティを検索できます。

• currency（例：「USDT」）：API がそのトークンの最も近い開催中のアクティビティを自動的に照合します。
• activity_id：数値 ID を指定して正確に検索します。
• 優先順位：currency が優先されます。両方が指定された場合は両方を使用します。activity_id のみが指定された場合は、その値を直接使用します。ルールまたは進捗の確認でどちらも指定されていない場合は、ユーザーに currency を尋ねます。

ルーティングルール

意図	例となるフレーズ	ルーティング先
アクティビティの一覧表示	「CandyDrop のアクティビティを表示」「開催中の candydrop イベント」「USDT candydrop」	references/activities.md を読み込む
アクティビティのルール	「CandyDrop のルールを表示」「この candydrop のタスクは何ですか」「賞金プールの詳細」	references/activities.md を読み込む
登録	「CandyDrop USDT に登録」「この candydrop アクティビティに参加」	references/register.md を読み込む
タスクの進捗	「自分の CandyDrop タスクの進捗」「自分の candydrop タスクの進捗を確認」	references/progress.md を読み込む
参加履歴	「自分の CandyDrop 参加履歴」「登録履歴」	references/records.md を読み込む
エアドロップ履歴	「自分の CandyDrop エアドロップ報酬」「エアドロップ履歴を表示」	references/records.md を読み込む
不明確	「CandyDrop」	確認する：アクティビティの一覧表示／ルール／登録／進捗／履歴のどれかを確認してからルーティングします。デフォルトで一覧表示する場合は、最小限のアクティビティ一覧のみを返信します（references/activities.md → アクティビティ一覧 — 直接回答 を参照）。

実行

1. 意図とパラメーター

• モジュール（アクティビティ一覧／アクティビティのルール／登録／タスクの進捗／参加履歴／エアドロップ履歴）を特定します。
• 登録の意図：references/register.md にルーティングします。currency が必須で、activity_id は任意です。プレビューしてから確認するフローに従う必要があります。
• 履歴の意図：references/records.md にルーティングします。currency、status、start_time、end_time、page、limit を抽出します。
• パラメーターを抽出します：currency、activity_id、status、rule_name、register_status、limit、offset、page、start_time、end_time。
• 不足している場合：ユーザーが意図を指定せずに「CandyDrop」と言った場合は、どの操作を行うか尋ねるか、デフォルトでアクティビティを表示します。一覧を表示する場合は、簡潔に出力します（タイトルと表のみ、用語集なし。references/activities.md を参照）。

2. ツールの選択

モジュール	MCP ツール	必須パラメーター	任意パラメーター
アクティビティ一覧	gate-cli cex launch candy-drop activities	—	currency、status、rule_name、register_status、limit、offset
アクティビティのルール	gate-cli cex launch candy-drop rules	currency または activity_id（少なくとも1つ）	—
登録	gate-cli cex launch candy-drop register	currency	activity_id
タスクの進捗	gate-cli cex launch candy-drop progress	currency または activity_id（少なくとも1つ）	—
参加履歴	gate-cli cex launch candy-drop participations	—	currency、status、start_time、end_time、page、limit
エアドロップ履歴	gate-cli cex launch candy-drop airdrops	—	currency、start_time、end_time、page、limit

• 登録：登録内容のプレビューを表示して確認を待ち、その後 gate-cli cex launch candy-drop register を呼び出します。
• 履歴：時間パラメーターの計算には、references/records.md のタイムスタンプ戦略に従います。

3. 応答形式

• 選択したモジュールのリファレンスファイルにある応答テンプレートとフィールド名を使用してください。
• アクティビティ一覧：任意の1行タイトル＋データテーブル。閲覧や「どのようなアクティビティがありますか」という意図の場合、チュートリアル、フィールドの用語集、タスクタイプのマップの貼り付けは不要です。rule_name はセル内のみでローカライズしてください。フィールド：currency、total_rewards、start_time、end_time、rule_name、participants、user_max_rewards。
• アクティビティルール：currency、total_rewards、start_time、end_time、および各賞金プールの prize_all、prize_limit、tasks を表示します。
• 登録：確認結果（success）を表示します。
• タスクの進捗：currency、total_rewards、start_time、end_time、および各タスクの task_name、task_desc、value を表示します。
• 参加記録：currency、status、register_time、id を表示します（時刻のセルは、テーブルのヘッダーに UTC が示されている場合、末尾の (UTC) を削除してください。上記のタイムスタンプ形式を参照）。
• エアドロップ記録：currency、airdrop_time、トークン単位付きの rewards（{rewards} {currency}）のみを表示してください。フラッシュ換算額／USDT（convert_amount）は表示しないでください（references/records.md を参照）。

レポートテンプレート

各操作の後に、リファレンスに沿った簡潔で標準化された結果（例：アクティビティ一覧、ルール、登録確認、進捗、記録）を出力してください。アクティビティ一覧への回答は最小限にしてください（references/activities.md を参照）。API のフィールド名と意味上の値を使用してください。リファレンスでローカライズが求められる場合（例：rule_name のタスクタイプ）は、references/activities.md に従ってユーザーの言語で表示し、マッピング全体をユーザー向けの説明文に含めないでください。

言語への適応：常にユーザーの入力と同じ言語で応答してください。リファレンスファイルの応答テンプレートで定義されるのは、表示する構造とフィールドであり、出力する言語そのものではありません。表示ラベルはすべてユーザーの言語に翻訳してください。

必ずローカライズする（ティッカーではなく、「英語のままにする」対象でもありません）：

• アクティビティ一覧（および「タスクタイプ」として表示する箇所）の rule_name の項目には、references/activities.md のタスクタイプ対応表を使用してください。これらの文字列はトークンシンボルではなく、プロダクトのタスクカテゴリ（例：先物、Simple Earn）を示します。

翻訳しない（言語にかかわらず、そのまま保持する）：

• プロダクト名：CandyDrop
• API の通貨シンボル：USDT、GT、BTC、DOGE など
• 技術 ID とその値：id、activity_id（内部用。関連性がない限り表示しないでください）
• タイムスタンプ形式 YYYY-MM-DD HH:MM:SS と、表示が必要な場合の (UTC) という文字列（例：ヘッダーに UTC がない場合）。そのような場合はタイムゾーン情報を削除しないでください。
• API エラーラベル：INVALID_PARAM_VALUE、SERVER_ERROR
• 数値、パーセンテージ、しきい値の単位 USD

その他の表示ラベルはすべて、ユーザーの言語に翻訳してください。

エラー処理

API エラーラベル

API は label フィールドを含む構造化エラーを返します。以下のように変換してください。

API ラベル	ユーザー向けメッセージ
INVALID_PARAM_VALUE	「リクエストパラメーターが無効です。入力内容を確認して、もう一度お試しください。」
SERVER_ERROR	「システムが混み合っています。しばらくしてからもう一度お試しください。」
Activity not found	「アクティビティが見つかりません。通貨またはアクティビティ ID を確認してください。」
currency is required	「通貨名（例：USDT）を指定してください。」
Device token is required	「登録にはデバイストークンが必要です。Gate アプリまたはウェブサイトからお試しください。」

空の結果の処理

シナリオ	アクション
アクティビティ一覧が空	"条件に一致するCandyDropアクティビティがありません。フィルターを変更するか、後でもう一度ご確認ください。"
参加記録が空	"CandyDropの参加記録がありません。開催中のアクティビティを確認して、始めてみましょう。"
エアドロップ記録が空	"エアドロップ報酬が見つかりません。報酬は通常、アクティビティ終了後に配布されます。"
コンプライアンス上の制限	"コンプライアンス上の制限により、お住まいの地域ではCandyDropをご利用いただけません。"
APIエラー／401	"CandyDropのデータを取得できません。ログインしてから、もう一度お試しください。"

安全ルール

確認が必要

• 登録は書き込み操作です。 gate-cli cex launch candy-drop register を呼び出す前に、必ず登録内容のプレビューを表示し、ユーザーの明示的な確認を待ってください。
• プレビュー形式：アクティビティの通貨、アクティビティ ID（判明している場合）。
• 続行するには「confirm」、中止するには「cancel」と返信するようユーザーに求めてください。
• 明示的な確認を受け取った後にのみ、API を呼び出してください。

コンプライアンス

• API がコンプライアンス上の制限または地域制限のエラーを返した場合は、親しみやすいメッセージ「コンプライアンス上の制限により、お住まいの地域ではCandyDropをご利用いただけません。」を表示してください。再試行してはいけません。

データの整合性

• currency と activity_id は、ユーザーが指定したとおりに保持してください。
• アクティビティのデータ、報酬額、タスクの進捗を捏造してはいけません。
• 実際の API 応答で返されたデータのみを表示してください。