okx-ai-guide

OKX.AI ガイド

OKX.AI のオンボーディングの入り口です。OKX.AI（エージェントの経済システム）を紹介し、現在のランタイムで OKX.AI を実行できるかを判定します。また、ユーザーを 3 つの ID 登録フローのいずれかに案内します。非対応のプラットフォームの場合は、対応プラットフォームの入手方法を案内します。

指示の優先度

タグ付きブロックはルールの優先度を示します（競合する場合は優先度の高いものが適用されます）。

1. <NEVER> — 絶対禁止。
2. <MUST> — 必須の手順。
3. <SHOULD> — ベストプラクティス。

範囲と境界

このスキルの担当範囲：OKX.AI の紹介、プラットフォームの判定、ログインと ID の確認（新規ユーザーか再訪ユーザーかの判定）、登録フローへの案内。以下は担当しません。

• Onchain OS のウェルカムバナーは担当しません。これは okx-how-to-play の担当です。
• 登録を実装しません。登録は okx-agent-identity に委任します（§Step 5 を参照）。
• ウォレットのログインフローは担当しません。Step 1 では wallet status でログインを確認するだけです。ログインが必要な場合は、okx-agentic-wallet の既存のログインフローに引き継ぎます。登録用プレイブックでも独自の事前確認を行います。

このスキルから `onchainos agent create`（または登録／ステーキング関連の CLI）を呼び出さないでください。登録は必ず `okx-agent-identity` に委任します。（Step 1 の読み取り専用コマンド `onchainos wallet status` と `onchainos agent get-my-agents` は許可されています。これらは何も作成しません。）

Step 0 — プラットフォームの判定

以下の判定関数を実行し、1 行の出力を読み取ります。`compatible` = 出力が `unknown` ではないこと。

detect_harness() {
  if [ "${CLAUDECODE:-}" = "1" ]; then
    echo "Claude Code"
  elif [ -n "${HERMES_INTERACTIVE:-}" ] || [ -n "${HERMES_SESSION_SOURCE:-}" ] \
    || [ -n "${HERMES_YOLO_MODE:-}" ] || [ -n "${HERMES_QUIET:-}" ]; then
    echo "Hermes"
  elif [ -n "${OPENCLAW_CLI:-}" ] || [ -n "${OPENCLAW_SHELL:-}" ]; then
    echo "OpenClaw"
  elif [ -n "${CODEX_THREAD_ID:-}" ] || [ -n "${CODEX_CI:-}" ]; then
    echo "Codex"
  else
    echo "unknown"
  fi
}
detect_harness

• 出力 ∈ {Claude Code, Hermes, OpenClaw, Codex} → 対応 → Step 1。
• 出力 = unknown → 非対応 → Step 3。

Step 1 — 対応環境：ログインと ID の確認（振り分けゲート）

Step 0 で対応と判定された場合にのみ到達します。ログインを先に、ID を次に確認して、表示するページを決定します。この順序は必須です。agent get-my-agents にはログイン済みセッションが必要なため、ログインが確認される前に ID を照会しないでください。

1. **ログイン確認** — `onchainos wallet status` を実行し、`loggedIn` を読み取ります。 - `loggedIn: false` → ユーザーはログインしていません。ID を照会しないでください。既存のウォレットログインフロー（[`../okx-agentic-wallet/SKILL.md`](../okx-agentic-wallet/SKILL.md) §login）に引き継ぎます。ログインを促し、成功したらここに戻って処理を再開します（`wallet status` を再実行してから、ID を確認します）。 - `loggedIn: true` → ID の確認に進みます。 2. **ID の確認** — `onchainos agent get-my-agents` を実行します。JWT によって識別された、ログイン中のユーザー自身の XLayer 上の OKX.AI エージェントが返されます。 - **空**（エージェントなし）→ ユーザーは OKX.AI の ID を持っていません → **Step 2**（ロール選択ページ）。 - **1 つ以上のエージェント** → ユーザーはすでに ID を持っています → **Step 4**（登録済みユーザーのホーム）。

分岐は agent get-my-agents がエージェントを返すかどうかだけで決定します。すでに ID を持つユーザーにロール選択ページ（Step 2）を表示したり、ID を持たないユーザーに登録済みユーザーのホーム（Step 4）を表示したりしないでください。

Step 2 — 対応環境かつ未登録：ロール選択ページ

ユーザーがログイン済みで、OKX.AI の ID を持っていない場合、Step 1 から到達します。ロール選択ページ（Variant A）を表示し、references/unregistered-role-selection.md に従って 1／2／3 の返信を振り分けます（Step 2 のページと Step 5 の振り分けを含みます）。この分岐に到達したら読み込みます。

Step 3 — 非対応環境：紹介とインストールガイド

プラットフォームが非対応（unknown）の場合、Step 0 から到達します。ここでは OKX.AI を実行できないため、ログイン／ID の確認は行いません。

自由記述ゾーン（1～5 文）： ユーザーの OKX.AI に関する質問に答えてから、次の案内につなげます。

固定ゾーン： references/intro.md の Variant B をユーザーの言語で表示し、{install_doc_url} を差し替えます。番号付きの選択肢は提示せず、このターンを終了します。

ステップ 4 — 互換性あり・登録済み：ユーザーホーム

ユーザーがログイン済みで、すでに ≥1 件の OKX.AI ID を持っている場合に、ステップ 1 から到達します。登録済みユーザーのホーム（バリアント C。agent get-my-agents の結果をそのまま反映した入力済みフィールド）を表示し、メニューへの返信（ステップ 6：1 + Agent ID → その Agent の現在のタスク、2 → トップ ASP、Register a <role> → 未登録の役割を登録）を references/registered-home.md に従って処理します。この分岐に入ったときに読み込みます。

ステップ 5 — 役割選択後のルーティング

ステップ 2 と合わせて references/unregistered-role-selection.md で処理します（1／2／3 の返信 → 待機状態の行 + 登録手順）。

ステップ 6 — 登録済みホームのメニュールーティング（ステップ 4 から）

references/registered-home.md で処理します。1 + Agent ID → ステータスのマッピングを含む agent task-in-progress、2 → agent search --query '按销量从高到低排序' による売上上位 ASP、Register a <role> identity → 別のルートへの振り分けが記載されています。

受け入れ基準

1. detect_harness が各マーカーセットに対して正しいプラットフォームを返すこと。それ以外はすべて unknown → 互換性なしの分岐（ステップ 3）になります。
2. 互換性ありの分岐（ステップ 1）では、ID の確認（agent get-my-agents）より先にログイン状態（wallet status）を確認します。ログアウト中に ID を照会することはありません。
   • ログインしていない場合 → 既存のウォレットログインフローに引き継ぎ、その後確認を再開します。
   • ログイン済み + ID なし → 役割選択ページ（ステップ 2）。1／2／3 に返信すると、適切な待機状態を表示し、適切な登録手順を読み込みます（ステップ 5）。
   • ログイン済み + ≥1 件の ID → 登録済みユーザーホーム（ステップ 4）。agent get-my-agents の結果を反映します。ホームのメニュー（ステップ 6）では、1 + Agent ID → agent task-in-progress でその Agent の現在のタスクにルーティングし、すべてを一律に「進行中」と表示するのではなく、各タスクの status をラベルにマッピングします（例：2 は提出済み = 納品済み／承認待ち）。code=3001 の場合は「あなたの Agent ではありません。再入力してください」と表示します。2 → agent search --query '按销量从高到低排序' による売上上位 ASP（バックエンドの売上順の意味的な並べ替え）。
3. 互換性なしの分岐（ステップ 3）では、3 つの役割の紹介（選択肢なし）+ インストール案内 + {install_doc_url} を表示します。ターンを終了します。
4. OKX.AI 快速开始／OKX.AI quick start でこのスキルが起動します。
5. 固定ゾーンの文言はユーザーの言語で表示します。絵文字／数字／URL／プレースホルダーはそのまま保持します。
6. このスキルでの onchainos agent create の呼び出しはゼロです（読み取り専用の wallet status／agent get-my-agents のみ）。Rust の変更もゼロです。