okx-activity について
OKX のキャンペーン活動への登録や参加を案内するスキルで、現在は OKX.AI Trading Hackathon を対象とします。参照ガイドに各フローを振り分け、事前確認、明示的な承認、安全確認を求めます。
主な機能
- 01ハッカソン登録と参加資格の依頼を振り分け
- 02活動別の参照ガイドを使用
- 03CLI 実行前の事前確認
- 04登録時の明示的な承認
- 05JWT の保護とユーザー識別子のマスキング
活用シーン
- 01OKX.AI Trading Hackathon への登録
- 02ハッカソンの参加要件の確認
- 03ハッカソン登録と競技会参加登録の区別
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ okx/ onchainos-skills --skill okx-activityインストール後、Claude Code で/okx-activityを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
_shared/preflight.mdreferences/hackathon-core.mdhackathon-faq.mdhackathon-registration.md詳細
OKX Activity — OKX キャンペーンへの登録と参加
各アクティビティのフロー、CLI リファレンス、FAQ、ゲートは、このスキルの references/ にある <activity>-*.md プレフィックスのファイルに記載されています。この SKILL.md はルーティングのみを行います。テンプレート、CLI フラグ、アクティビティごとの文面は含まれないため、アクティビティを追加しても既存のルールは変わりません。
事前チェック
最初の onchainos コマンドを実行する前に、../okx-agentic-wallet/_shared/preflight.md を一度読んでください。存在しない場合は、代わりに _shared/preflight.md を読んでください。
必須 — セッション中に最初の onchainos コマンドを実行する前に、すべてのアクティビティについて実行します。読み取り専用の一覧取得呼び出しも対象です。
インテントのルーティング
| ユーザーのインテント | アクティビティ | リファレンス |
|---|---|---|
| ハッカソンへの登録、申し込み、参加、エントリー、または出場(言語を問わない) | OKX.AI Trading Hackathon | hackathon-core.md、続いて hackathon-registration.md |
| ハッカソンの参加要件または参加資格について(言語を問わない。登録手続き中ではない場合) | OKX.AI Trading Hackathon | hackathon-core.md、続いて hackathon-faq.md |
アクティビティに関するユーザー向けメッセージを作成する前に必ず、そのアクティビティの *-core.md を読み込んでください(必須)。このファイルには、そのアクティビティのゲート、出力ルール、送信ゲートが記載されています。フローと FAQ のファイルにはこれらが繰り返し記載されていないため、先に -registration.md/-faq.md を開くのは近道ではなく、ゲートの省略にあたります。このファイル、記憶、または CLI の --help 出力だけをもとに、フロー、テンプレート、参加資格に関する回答を独自に作らないでください。
リクエストで指定されたアクティビティが上記に記載されていない場合(リファレンスファイルが存在しない場合)は、そのアクティビティはまだこのスキルではサポートされていないと伝えてください。別のアクティビティのフローを流用したり、そのアクティビティ用の CLI サブコマンドを推測したりしないでください。
コマンド一覧
このスキルでは onchainos <activity> サブコマンド(hackathon → onchainos hackathon)を使用します。正確な構文は記憶ではなく CLI から確認してください。 サブコマンド一覧は onchainos hackathon --help、サブコマンドのフラグは onchainos hackathon <subcommand> --help を実行して確認してください。パラメーターの全一覧、戻り値フィールドのスキーマ、実行例は hackathon-registration.md に記載されています。
誤ったスキルの使用を防ぐ
ここでのアクティビティでは、そのアクティビティが定める対象(hackathon → 既存の Trading ASP エージェント)に参加します。competition join(okx-growth-competition)では、ウォレットアカウントを通常のトレーディングコンペティションに登録します。システムも対象も異なります。登録するものが異なり、どちらの呼び出しも取り消せないため、一方を他方の代わりに使用することは絶対にしないでください。
1つのリクエストに両方の手がかり(たとえば「hackathon」と「competition」または「cup」の両方)が含まれている場合は、コマンドを実行する前に、どちらを指しているのかユーザーに確認してください。
セキュリティ
- すべてのアクティビティ登録は取り消せません。一覧表示、更新、状態確認、取り消しを行うサブコマンドはありません。必須:送信前にユーザーから明示的な確認の返信を得てください。ユーザーに代わって確認プロンプトに回答したり、対象をすでに指定している単発のリクエストを、事前に確認済みとみなしたりしてはいけません。すべてのゲートは、該当アクティビティの
-registration.mdに記載されています。 - JWT をログに記録、出力、またはフラグとして渡すことは絶対にしないでください。JWT はクライアントレイヤーからキーチェーンを通じて注入されます。漏えいすると、攻撃者がユーザーになりすまして操作できるようになります。アクティビティのフローで新たなシークレットが作成されることはありません。
- 実行したコマンドをそのまま表示する場合は、ユーザー識別子(OKX UID など)を必ずマスクしてください(
--uid <hidden>)。これらが CLI から返されることはなく、会話内に未加工の値を貼り付けることもありません。 - アクティビティを内部アクティビティ ID で識別することは、どのような形式でも絶対にしないでください。名前で指定してください。CLI はその ID を返しません。他の場所から取得することも避けてください。
- エージェント ID の作成は、アクティビティのフローに含まれることはありません。それは
okx-aiの役割です。このスキルでは、すでに存在する対象への参加のみを扱います。
全般的な注意事項
- ユーザーの言語で返信してください。 このスキルの参考資料にあるテンプレートはすべて、構成のガイドとして英語で作成されています。送信前に翻訳し、レイアウトと項目は変更せず、すべての URL を 1 バイトも変えずに、引き続きリンクとして保持してください。
- 各アクティビティの
-core.mdには、それぞれ独自のゲート、出力ルール、納品前チェックリストがあります。これらはこのファイルへの追加要件であり、このファイルの要件に代わるものではありません。
アクティビティの追加(メンテナー向け)
references/<activity>-core.md(ゲート、読み進める順序、出力ルール、納品前チェックリストを記載)と、フローおよび FAQ を記載したreferences/<activity>-*.mdを追加します。- そのアクティビティが対応するユーザーの意図ごとに、完全な Markdown リンクを記載した「Intent Routing」の行を 1 つずつ追加します。
- 新しいアクティビティのトリガーを、このファイルの
descriptionに追加します。