gate-info-tokenonchain

gate-info-tokenonchain

一般ルール

⚠️ 停止 — 続行する前に、共有ランタイムルールを必ず読み、厳守してください。 すべてのルールを読むまで、ツールを選択または呼び出さないでください。これらのルールが最優先です。 → gate-runtime-rules.md を読んでください → gate-info ／ gate-news 固有のルール（ツールの機能低下、レポートの基準、セキュリティ、ルーティングの機能低下、scripts/ がある場合のスキルごとのバージョン確認、レガシーラッパーのルーティング）については、info-news-runtime-rules.md も読んでください。

• このスキルに明記されている MCP ツールのみを呼び出してください。 MCP サーバーに存在していても、ここに記載されていないツールを呼び出してはいけません。
• レガシー／ルーティングモード： Step 0 で __FALLBACK__ が出力された場合は、このファイルに記載されている MCP ツールのみを使用してください。Step 0 で __ROUTE_CLI__ が出力された場合は、これらの MCP ツールを呼び出さず、Step 0 に従って対応するプライマリスキルに処理を委任してください。

トークンのオンチェーン分析スキル（現行バージョン：Smart Money なし）。トークン単位の保有者分布、アクティビティ、大口送金については、オンチェーンツールと基本的なコイン情報ツールを並行して呼び出し、その後、情報を集約して構造化されたレポートを作成してください。

トリガーとなるシナリオ：ユーザーがトークンのオンチェーンデータ、保有者分布、オンチェーンアクティビティ、大口送金、オンチェーンのチップ分析などについて尋ねた場合。

スキルごとの更新： このディレクトリには scripts/update-skill.sh が含まれており、scripts/update-skill.ps1 が含まれている場合もあります。マーケットプレイスにアップロードされた ClawHub パッケージでは、アップロードページの制限により update-skill.ps1 が省略されることがよくあります。一方、GitHub / Bitbucket のソースツリーには両方が含まれています。ポリシー：info-news-runtime-rules.md §1。以下の更新のトリガー手順は gate-runtime-rules.md に加えて適用されます。スクリプトがある場合は、実行前のバージョン確認にこの手順を使用してください。

更新の確認 — ユーザーへの説明： バージョン確認中の技術的な失敗（スクリプトがない、サンドボックス、ネットワーク、終了コードが 0 以外、解析可能な Result= 行がない）は、ユーザーに説明してはいけません。info-news-runtime-rules.md に従って、実行に進んでください。要約してよいのは、成功した check ／ apply の結果のみです（update_available ／厳密な終了コード 3も含みます。これは成功パスであり、apply の前にユーザーの確認が必要です）。ネットワークから update-skill.* を自動ダウンロードしないでください。.ps1 がない場合の静的な参照先：正規のスクリプトは gate/gate-skills の skills/<name>/scripts/ にあります（frontmatter と同じ <name>）。

---

Step 0 — ラッパーのルーティング確認

このレガシースキルは、プライマリ CLI スキル gate-info-web3 の互換性エイリアスです。

更新のトリガー、MCP ツールの選択、またはレガシーの実行ワークフローを行う前に、 決定的なシェル確認を実行してください：

PRIMARY_SKILL="gate-info-web3"
HAS_PRIMARY=0
for root in \
  "$HOME/.cursor/skills" \
  "$HOME/.codex/skills" \
  "$HOME/.openclaw/skills" \
  "$HOME/.agents/skills" \
  "$HOME/.gemini/antigravity/skills"
do
  if [ -f "$root/$PRIMARY_SKILL/SKILL.md" ]; then
    HAS_PRIMARY=1
    break
  fi
done

if command -v gate-cli >/dev/null 2>&1 && [ "$HAS_PRIMARY" = "1" ]; then
  echo "__ROUTE_CLI__"
else
  echo "__FALLBACK__"
fi

判定：

• __ROUTE_CLI__ → ここで停止してください。以下の更新のトリガーやレガシー MCP のセクションを実行しないでください。 https://github.com/gate/gate-skills/blob/master/skills/gate-info-web3/SKILL.md と、そのプレイブックの契約に従ってください。必要最小限のコンテキストとして、token と chain を引き継いでください。
• __FALLBACK__ → 更新のトリガーと、このファイルに記載されているレガシー MCP ワークフローに進んでください。

---

トリガー時の更新（実行を伴う場合）

デフォルト（PD／ブロッキング）： トリガーごとに、GATE_SKILL_UPDATE_MODE=autoを指定せず、まずcheckを実行します。スクリプトはローカルとリモートを比較するだけです。Result=update_availableの場合、ファイルは上書きされません。停止し、apply、run、またはスキルの実行を行う前に、ユーザーに更新するかどうかを確認してください。サンドボックス（Cursorなど）で後から**applyを実行する場合は、すべての権限を使用してください。これは、独立したスクリプトのTEST_REPORTにおけるブロッキング更新確認の仕様に合致します。ブロッキングは、サイレントな自動適用によるものではなく、これらのSKILLの指示とcheckのみ**の動作によって実現されます。

厳密なチェック（エージェント／IDE — check時に推奨）： GATE_SKILL_CHECK_STRICT=1を使用します。Result=update_availableの場合、checkは終了コード3で終了し、GATE_SKILL_CHECK_EXIT=3を出力します。停止するのはそのシェルステップだけです。厳守事項：ユーザーに確認を求めた後は、このアシスタントのターンを終了してください。同じメッセージ内でapply、run、またはMCPを呼び出してはいけません。**runは事前のユーザーステップなしで適用します。ブロッキングフローのチャットではrunを使用せず、check → ユーザーが確認 → apply**の順に進めてください。

ステップ1 — チェック

インストール先のルート： check／applyは**$DEST/SKILL.mdを読み込みます。一般的な$SKILL_ROOT：$HOME/.cursor/skills/<name>/、$HOME/.codex/skills/<name>/、$HOME/.openclaw/skills/<name>/、$HOME/.agents/skills/<name>/、$HOME/.gemini/antigravity/skills/<name>/。引数が1つの場合、SKILL.mdが存在すれば、スクリプトはこの順にDESTを解決します。それ以外の場合、DESTは‌scripts/../です。ワークスペース内のツリーのみを対象とする場合は、DESTを明示して、引数2つでcheck／apply**を実行する必要があります。

エージェントの選択ルール（以下のコード例は最大1つだけ実行し、OSと$SKILL_ROOT/scripts/内のファイルに応じて選択してください）：

• macOS／Linux／WSL／Git Bash： update-skill.shが存在する場合は、Bashの例のみを使用してください。
• Windows（ネイティブPowerShell）： update-skill.ps1が存在する場合は、PowerShellの例のみを使用してください。
• Windowsで.ps1がない場合（一般的なClawHubのインストール）：update-skill.shのみが存在する場合は、WSLまたはGit Bash（bash）で、Bashの例と同じ形式のコマンドを試してください。bashを利用できない場合、または実行に失敗した場合は、ステップ1を何も通知せずにスキップし（スクリプトのstderrや「バージョンチェックに失敗しました」というメッセージをユーザーに表示しないでください）、実行に進んでください。
• どちらのスクリプトも存在しない場合： ステップ1を何も通知せずにスキップし、実行に進んでください。**GATE_SKILL_CONFIRM_TOKEN**を捏造したり、apply／revoke-pendingを実行したりしないでください。

Bash（ブロッキング — 自動適用なし。Cursorの例）：

GATE_SKILL_CHECK_STRICT=1 bash "$HOME/.cursor/skills/gate-info-tokenonchain/scripts/update-skill.sh" check "gate-info-tokenonchain"

PowerShell：

$env:GATE_SKILL_CHECK_STRICT = '1'
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.cursor\skills\gate-info-tokenonchain\scripts\update-skill.ps1" check "gate-info-tokenonchain"

結果の意味： skipped = 対応不要です。update_available = リモートのほうが新しい状態です。ブロッキングフローでは、ユーザーが同意するまで適用しないでください。 check_failed = 比較できませんでした。info-news-runtime-rules.mdに従い、現在のバージョンで続行してください。技術的なチェック失敗の詳細をユーザーに伝えてはいけません。

エージェントによる解析（標準出力）： GATE_SKILL_UPDATE_AGENT_ACTION=…。**BLOCK_UNTIL_USER_CONFIRMS_UPDATEの場合は、実行前にステップ2へ進みます。CONTINUE_SKILL_EXECUTION**の場合、チェック用スクリプトによるブロックはありません。

ステップ 2 — 確認または拒否（ブロッキング）

ランタイム： ステップ 1 と同じシェルファミリーをステップ 2 でも使用してください（Bash または PowerShell）。ステップ 1 をスキップした場合は、apply または revoke-pending を実行しないでください。

update_available の場合：

1. 停止 — まだ実行に進まないでください。

2. ユーザーに知らせてください（例：新しいバージョンが利用可能であること。必要に応じて要約してください）。

3. ユーザーの返信を待ってください — ブロッキングステップです。

   厳守事項（Cursor / Agent）： check が update_available、BLOCK_UNTIL_USER_CONFIRMS_UPDATE、または厳密な exit 3 を報告した場合は、確認を求めた後、このターンを終了してください。apply（同意した場合）または revoke-pending（拒否した場合）を実行するのは、ユーザーの次のメッセージを受け取った後だけです。このフローでは、check と同じターン内で apply を続けて実行しないでください。

   • ユーザーが同意した場合 → 必要に応じて、厳密な check の stdout にある GATE_SKILL_CONFIRM_TOKEN を指定して apply を実行し、その後、実行に進みます。
   • ユーザーが拒否した場合 → revoke-pending を実行し、その後、現在のインストールで実行に進みます。

2 段階ゲート（厳密な check）： GATE_SKILL_UPDATE_MODE=auto を設定せずに実行する apply / run は、GATE_SKILL_CONFIRM_TOKEN が .gate-skill-apply-token と一致するまで失敗します。ユーザーが拒否した場合 → revoke-pending を実行します。

GATE_SKILL_CONFIRM_TOKEN="<paste from check stdout>" bash "$HOME/.cursor/skills/gate-info-tokenonchain/scripts/update-skill.sh" apply "gate-info-tokenonchain"

bash "$HOME/.cursor/skills/gate-info-tokenonchain/scripts/update-skill.sh" revoke-pending "gate-info-tokenonchain"

$env:GATE_SKILL_CONFIRM_TOKEN = '<paste from check stdout>'
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.cursor\skills\gate-info-tokenonchain\scripts\update-skill.ps1" apply "gate-info-tokenonchain"

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.cursor\skills\gate-info-tokenonchain\scripts\update-skill.ps1" revoke-pending "gate-info-tokenonchain"

ステップ 1 が厳密なチェックではなかった場合（保留中のトークンなし）：GATE_SKILL_CONFIRM_TOKEN を指定しなくても apply を実行できます。

skipped または check_failed の場合： 更新ステップはありません。実行に進んでください。

オプション — GATE_SKILL_UPDATE_MODE=auto

CI / 無人自動化専用： check に GATE_SKILL_UPDATE_MODE=auto を設定すると、リモートのほうが新しい場合、スクリプトは直ちに適用します。ユーザー確認は不要で、ブロッキング更新確認テストとは互換性がありません。ブロッキング PD フローを再現する場合、check で auto を使用しないでください。

パラメーター

• name：上記の Frontmatter name。gate-skills の skills/<name>/ と一致する必要があります。
• Invoke：このスキルの $SKILL_ROOT/SKILL.md がある場所に応じて、$SKILL_ROOT/scripts/update-skill.sh（または .ps1）を使用してください。例：~/.cursor/skills/<name>、~/.codex/skills/<name>、~/.openclaw/skills/<name>、~/.agents/skills/<name>、~/.gemini/antigravity/skills/<name>。インストール先として ~/.cursor（または skills/<name>/SKILL.md を含まないホストルート）を扱わないでください。引数が 1 つの場合、スクリプトはその順序で $SKILL_ROOT を解決し、見つからなければスクリプトのディレクトリを使用します。ワークスペースへのインストールでは DEST を明示的に指定する必要があります。2 引数の check / apply / revoke-pending： 正規の順序は、最初に絶対パスの DEST（スキルルート）、次に name です。update-skill.sh / update-skill.ps1 は、正規化後のパスのうち SKILL.md を含むものが 1 つだけの場合、引数を自動的に入れ替えます（例：エージェントが name、パスの順に渡す場合）。
• ClawHub と完全なツリー： update-skill.ps1 がないインストールでは、gate/gate-skills から skills/<name>/scripts/ にコピーできます（手動のみ。エージェントは自動ダウンロードしてはいけません）。

デバッグ時を除き、生のスクリプトログをユーザー向けの返信に出力しないでください。厳密な check の終了コード 3 の場合、ステップ 2 が解決するまで実行に進まないでください。check_failed または apply の失敗の場合でも、ランタイムルールに従い、適切であれば実行してください。

---

既知の制限事項

• Smart Money：このバージョンでは、info_onchain_get_smart_money と、info_onchain_get_token_onchain の scope=smart_money は利用できません。ユーザーに伝え、holders / activity / transfers のみを使用してください。
• エンティティのプロファイリング：ツールが利用可能になるまでは、info_onchain_get_entity_profile によるクジラのエンティティプロファイリングはサポートされません。
• オンチェーンデータのカバレッジは、アップストリームのチェーンサポート（例：BlockInfo）に依存します。

---

MCP の依存関係

レガシーパスのみ — このセクションは、ステップ 0 で __FALLBACK__ が出力された場合に適用されます。

必須の MCP サーバー

MCP サーバー	状態
Gate-Info	✅ 必須

使用する MCP ツール

クエリ操作（読み取り専用）

• info_onchain_get_token_onchain
• info_coin_get_coin_info

認証

• API キーが必要：いいえ
• 認証情報のソース：なし。このスキルでは、読み取り専用の Gate Info / Gate News MCP アクセスのみを使用します。

インストールの確認

• 必須：Gate-Info
• インストール：続行する前に、現在のホスト IDE 用のローカル Gate MCP インストールフローを使用してください。
• 現在の環境で必要な Gate MCP サーバーが利用可能になってから続行してください。

ルーティングルール

レガシーパスのみ — Step 0 で __ROUTE_CLI__ が出力された場合、ルーティングは gate-info-web3 に委譲されます。

ユーザーの意図	キーワード	アクション
トークン保有者の分布	"ETH holders" "BTC holding distribution" "top holders"	scope=holders で実行
オンチェーンアクティビティ	"on-chain activity" "active addresses" "transaction count"	scope=activity で実行
大口送金	"large transfers" "whale movements" "unusual transfers"	scope=transfers で実行
オンチェーンの全体像	"on-chain analysis for SOL" "ETH on-chain data"	holders,activity,transfers で実行
スマートマネー（未対応）	"smart money buying"	ユーザーに伝え、利用可能なスコープのみ実行
特定のアドレスに関する照会	"track this address 0x..."	gate-info-addresstracker にルーティング
コインのファンダメンタルズ	"analyze SOL"	gate-info-coinanalysis にルーティング
クジラのエンティティ追跡	"what is Jump Trading doing"	利用可能な場合は gate-info-whaletracker にルーティングし、そうでなければユーザーに伝える

---

実行ワークフロー

レガシーパスのみ — このセクションは Step 0 で __FALLBACK__ が出力された場合に適用されます。

Step 0：多角的な意図の確認

• トークンレベルのオンチェーン情報 → このスキル。
• 特定のアドレス（トークンではない） → gate-info-addresstracker。
• ファンダメンタルズ + テクニカル分析 + ニュースをまとめて確認 → gate-info-research（利用可能な場合）。

Step 1：意図の認識とパラメーターの抽出

• symbol（必須）：トークンのティッカー（例：BTC、ETH、SOL）
• chain（任意）：例：eth、sol、bsc
• scope：holders、activity、transfers のいずれか1つ以上（smart_money — 利用不可）
• time_range（任意）：transfers/activity のデフォルトは 24h

Step 2：MCP ツールを並列で呼び出す

Step	MCP ツール	パラメーター	取得データ	並列
1a	info_onchain_get_token_onchain	symbol, chain, scope, time_range	スコープごとの保有者 / アクティビティ / 送金データ	はい
1b	info_coin_get_coin_info	query={symbol}, scope="basic"	コインの基本情報	はい

Step 3：LLM による集約

• コイン情報を用いてオンチェーンデータを文脈化する
• パターンと異常を特定する
• 投機的な価格予測を避ける

---

レポートテンプレート

レガシーパスのみ — このセクションは Step 0 で __FALLBACK__ が出力された場合に適用されます。

## {symbol} On-Chain Analysis

> Generated: {timestamp} | Chain: {chain or "All supported chains"}
> Note: Smart Money analysis not yet available in this version.

### Token Overview

| Metric | Value |
|--------|-------|
| Token | {symbol} ({name}) |
| Market Cap | ${market_cap} |
| Circulating Supply | {circulating_supply} |

### Holder Distribution (if scope includes holders)

{Tables + LLM concentration assessment}

### On-Chain Activity (if scope includes activity)

{Metrics + LLM trend assessment}

### Large Transfers (if scope includes transfers)

{Table + LLM flow assessment}

### On-Chain Health Score

{Dimensions scored /10 + overall}

### Key Insights

{2–3 data-driven bullets}

> On-chain data does not predict future prices. This does not constitute investment advice.

---

判断ロジック

条件	評価
上位 10 保有者の集中度 > 70%	集中リスクが高い
上位 10 保有者の集中度 < 30%	保有者基盤が広く分散
アクティブアドレスが前週比で 20% 超減少	ネットワークアクティビティの低下
アクティブアドレスが前週比で 30% 超増加	アクティビティが大幅に増加
取引所アドレスへの大口送金	売り圧力の可能性
取引所アドレスからの大口送金	蓄積の可能性
ユーザーがスマートマネーについて質問	利用できないことを伝え、holders/activity/transfers を提案

---

エラー処理

エラーの種類	対応
オンチェーンでトークンが見つからない	info_coin_get_coin_info で確認し、symbol/chain を提案
info_onchain_get_token_onchain が失敗	コイン情報のみを表示し、オンチェーン情報が利用できないことを伝える
info_coin_get_coin_info が失敗	市場のコンテキストなしでオンチェーンデータを表示
スコープの結果が空	該当セクションを省略し、そのスコープのデータがないことを伝える
chain がサポートされていない	サポート対象の chain を列挙し、ユーザーに確認する
両方のツールが失敗	エラーを返し、後でもう一度試すよう提案
ユーザーが smart_money をリクエスト	利用できないことを伝え、他のスコープを提案

---

スキル間ルーティング

ユーザーのフォローアップの意図	ルーティング先
「このコインを分析して」	gate-info-coinanalysis
「このアドレスを追跡して」	gate-info-addresstracker
「このトークンは安全ですか？」	gate-info-riskcheck
「テクニカル分析をして」	gate-info-trendanalysis
「何かニュースはありますか？」	gate-news-briefing
「コミュニティの意見はどうですか？」	gate-news-communityscan
「これに関する DeFi データはありますか？」	gate-info-defianalysis

---

安全ルール

1. オンチェーンデータを捏造しない：MCP が返したデータのみを報告してください。
2. アドレスのプライバシー：アドレスを短縮し（例：0x1234...abcd）、個人情報を暴露しないでください。
3. 取引シグナルを提示しない：情報提供のみを目的としており、売買の助言ではありません。
4. 取引所のラベル：可能な限り正確に表示しますが、誤っている場合があります。
5. データの遅延：該当する場合は、インデックス作成の遅延に言及してください。
6. スマートマネー：推測で補うのではなく、利用できないことを明確に伝えてください。
7. 年齢と利用資格：ユーザーの法域において、18歳以上であり、完全な行為能力を有する方を対象としています。
8. データフロー：ホストエージェントがユーザーのプロンプトを処理し、このスキルは上記の読み取り専用の Gate-Info MCP ツールを使用するよう指示します。LLM がツールの出力を要約します。このスキルは、追加のサードパーティ製データサービスを呼び出しません。