gate-info-addresstracker

gate-info-addresstracker

一般ルール

⚠️ 停止 — 続行する前に、共有ランタイムルールを必ず読み、厳守してください。 すべてのルールを読むまでは、ツールを選択または呼び出さないでください。これらのルールが最優先です。 → 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 に従って対応するプライマリスキルに処理を委任してください。

オンチェーン調査スキルです。ユーザーがオンチェーンアドレスを入力すると、システムはまずアドレス情報ツールを呼び出してプロフィールを取得し、その後、ユーザーの意図や調査の深さ（簡単な問い合わせか、資金追跡か）に応じて、取引履歴および資金フロー追跡ツールも呼び出すかどうかを判断します。

トリガーとなるシナリオ：ユーザーがオンチェーンアドレス（0x...／bc1...／T...形式）を提示するか、アドレスの追跡／照会を明示的に希望している場合。

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

更新確認 — ユーザーへの通知： バージョン確認中の技術的な失敗（スクリプトがない、サンドボックス、ネットワーク、ゼロ以外の終了コード、解析可能な 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 およびそのプレイブックの契約に従ってください。引き継ぐコンテキストは最小限とし、address と 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-addresstracker/scripts/update-skill.sh" check "gate-info-addresstracker"

PowerShell：

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

結果の意味： 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 — 確認または拒否（ブロッキング）

ランタイム： ステップ 2 では、ステップ 1 と同じシェルファミリー（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 の標準出力にある 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-addresstracker/scripts/update-skill.sh" apply "gate-info-addresstracker"

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

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

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

ステップ 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 の失敗の場合も、ランタイムのルールに従い、適切であれば実行してください。

---

MCP の依存関係

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

必須の MCP サーバー

MCP サーバー	ステータス
Gate-Info	✅ 必須

使用する MCP ツール

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

• info_onchain_get_address_info
• info_onchain_get_address_transactions
• info_onchain_get_transaction
• info_onchain_trace_fund_flow

認証

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

インストールの確認

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

ルーティングルール

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

ユーザーの意図	キーワード／パターン	アクション
アドレス情報の照会	"who owns this address" "check 0x..."	このスキルを実行します（基本モード）
資金の流れを追跡	"track" "fund flow" "where did this money go"	このスキルを実行します（詳細追跡モード）
トークンのオンチェーン分析	"ETH chip analysis" "what are smart money buying"	gate-info-tokenonchain にルーティングします
アドレスのリスク確認	"is this address safe" "is this a blacklisted address"	gate-info-riskcheck にルーティングします
単一トランザクションの照会	"what is this transaction" "decode this tx"	info_onchain_get_transaction を直接呼び出します
エンティティ／機関の追跡	"Jump Trading holdings" "this institution's address"	gate-info-whaletracker にルーティングします

---

実行ワークフロー

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

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

ユーザー入力から以下を抽出します：

• address：オンチェーンアドレス（形式を自動検出）
• chain（任意）：チェーンの種類（ETH/BSC/TRX/BTC など。アドレス形式から自動推定できます）
• intent_depth：ユーザーの意図の深さ
  • basic — 「これは誰ですか」／「保有量はいくらですか」と尋ねているだけの場合
  • deep — 「資金を追跡して」／「トランザクションを表示して」／「資金はどこへ行ったのか」と求めている場合

アドレス形式の自動検出：

アドレスのプレフィックス	推定されるチェーン
0x	Ethereum（デフォルト。BSC/Polygon/Arbitrum など、ほかの EVM チェーンの場合もあります）
bc1 / 1 / 3	Bitcoin
T	Tron
その他	チェーンを指定するようユーザーに求めます

Step 2：フェーズ 1 — アドレスのプロフィール（必須）

Step	MCP ツール	パラメーター	取得データ
1	info_onchain_get_address_info	address={address}, chain={chain}, scope="with_defi"	アドレスのプロフィール：残高、ラベル、リスクスコア、DeFi ポジション、PnL

Step 3：判断分岐

get_address_info response
    │
    ├── User only wants a simple query (intent_depth = basic)
    │   └── → Output address profile report directly (skip to Step 5)
    │
    └── User requests deep tracking (intent_depth = deep)
        └── → Proceed to Step 4 parallel calls

自動的に詳細モードへ移行する条件：

• アドレスに既知のラベル（例：取引所、ハッカー、クジラ）が付いている → 調査する価値がある可能性が高い
• アドレスの残高が $1M を超えている
• アドレスにリスクフラグが付いている

Step 4：フェーズ 2 — 詳細追跡（条件付きで実行）

Step	MCP ツール	パラメーター	取得データ	並列
2a	info_onchain_get_address_transactions	address={address}, chain={chain}, min_value_usd=10000, limit=20	大口トランザクション（> $10k）	はい
2b	info_onchain_trace_fund_flow	start_address={address}, chain={chain}, depth=3, min_value_usd=100000	資金の流れの追跡（深さ 3 レベル、> $100k）	はい

両方のツールを並列で呼び出します。min_value_usd のしきい値は、アドレスの規模に応じて調整されます。

しきい値の適応ロジック：

アドレスの総残高	info_onchain_get_address_transactions の min_value	info_onchain_trace_fund_flow の min_value
< $100K	$1,000	$10,000
$100K – $1M	$10,000	$100,000
$1M – $100M	$100,000	$1,000,000
> $100M	$1,000,000	$10,000,000

Step 5：LLM による集約

---

レポートテンプレート

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

基本モード

## Address Analysis Report

> Address: `{address}`
> Chain: {chain}
> Query time: {timestamp}

### 1. Address Profile

| Metric | Value |
|--------|-------|
| Address Label | {label} (e.g., Exchange Hot Wallet / Whale / Unknown / Hacker-linked) |
| Risk Score | {risk_score}/100 ({Low Risk/Medium Risk/High Risk}) |
| First Transaction | {first_tx_time} |
| Total Transactions | {tx_count} |
| Current Balance | ${total_balance_usd} |

### 2. Asset Holdings

| Token | Amount | Value (USD) | Share |
|-------|--------|-------------|-------|
| {token_1} | {amount} | ${value} | {pct}% |
| {token_2} | ... | ... | ... |
| ... | ... | ... | ... |

**Holding Characteristics**: {LLM analyzes the holding structure, e.g., "Highly concentrated in ETH", "Diversified across multiple DeFi tokens", "Possible market maker"}

### 3. DeFi Positions (if available)

| Protocol | Type | Amount | Status |
|----------|------|--------|--------|
| {protocol} | {Lending/LP/Staking} | ${value} | {Healthy/Near Liquidation} |
| ... | ... | ... | ... |

### 4. PnL Summary (if available)

| Metric | Value |
|--------|-------|
| Realized PnL | ${realized_pnl} |
| Unrealized PnL | ${unrealized_pnl} |
| Win Rate | {win_rate}% |

詳細追跡モード（基本モードに追加）

### 5. Large Transaction History

> Filter: Amount > ${min_value_usd} | Most recent {count} transactions

| Time | Type | Amount | Counterparty | Counterparty Label |
|------|------|--------|--------------|-------------------|
| {time} | {In/Out/Contract Interaction} | ${value} | `{counterparty}` | {label/unknown} |
| ... | ... | ... | ... | ... |

**Transaction Pattern Analysis**:
{LLM analyzes transaction records and identifies patterns:}
- Frequent interactions with an exchange → likely depositing/withdrawing
- Large one-way outflows → possibly liquidating
- Interacting with many new addresses → possibly dispersing funds
- Regular fixed-amount transfers → possibly payroll/OTC

### 6. Fund Flow Tracing

> Trace depth: {depth} levels | Minimum amount: ${min_value_usd}

{address}（起点） ├── ${amount} → {addr_1}（{label_1}） │ ├── ${amount} → {addr_1a}（{label}） │ └── ${amount} → {addr_1b}（{label}） ├── ${amount} → {addr_2}（{label_2}） │ └── ${amount} → {addr_2a}（{label}） └── ${amount} → {addr_3}（{label_3}）

**Fund Flow Analysis**:
{LLM analysis based on tracing results:}
- Ultimate destination of funds (exchange? mixer? DeFi protocol?)
- Any suspicious patterns (split transfers, circular transfers, obfuscation paths)
- Associated known entities

### ⚠️ Risk Warnings

{If the address has risk flags, prominently display:}
- ⚠️ This address is flagged as: {risk_label}
- ⚠️ Associated addresses involved in: {risk_detail}

---

判定ロジック

条件	評価
risk_score > 70	高リスクアドレス — ユーザーに注意を促す
risk_score 40-70	中リスク — いくつかのリスク要因があることを伝える
risk_score < 40	低リスク
単一トークンへの保有集中度 > 80%	「保有が高度に集中」と警告する
DeFi 貸付のヘルスファクター < 1.2	清算間近
過去24時間の大規模な資金流出が残高総額の > 50%	「直近の大規模な資金流出」と警告する
資金フローにミキサーアドレスが含まれる	「ミキサー関与 — 高リスク」と警告する
資金フローに OFAC 制裁対象アドレスが含まれる	「制裁対象アドレスとの関連あり」と警告する
trace_fund_flow が空を返す	新しいアドレス、または十分な規模の取引がない可能性があります — 通常どおり処理する

---

エラー処理

エラーの種類	対応
無効なアドレス形式	形式を確認するようユーザーに促し、正しい形式の例を示す
チェーンを特定できない	チェーンを指定するようユーザーに促す（「このアドレスはどのチェーン上にありますか？ ETH/BSC/TRX/BTC...」）
info_onchain_get_address_info が空を返す	アドレスが新しい、またはオンチェーンでの活動がない可能性があることをユーザーに伝える
info_onchain_trace_fund_flow を利用できない（P1 フェーズ）	ユーザーに「資金追跡はまだ開発中です」と伝え、取引履歴のみを表示する
info_onchain_get_address_transactions がタイムアウトする	limit を減らして再試行するか、アドレスのプロフィールのみを表示する
すべてのツールが失敗する	エラーメッセージを返し、後でもう一度試すようユーザーに提案する

---

スキル間のルーティング

ユーザーの追加質問の意図	ルーティング先
「このアドレスは安全ですか？」	gate-info-riskcheck
「このトークンのオンチェーンデータ」	gate-info-tokenonchain
「このアドレスを所有している機関は？」	gate-info-whaletracker
「XX コインを分析してください」	gate-info-coinanalysis
「なぜ大規模な資金流出が起きたのですか？」	gate-news-eventexplain

---

安全性に関するルール

1. プライバシー保護：オンチェーンアドレスを特定の自然人と結び付けないでください（機関のアドレスとして公開されている場合を除く）
2. リスク警告の明示：高リスクアドレスには、理由を添えて目立つ明確なリスクラベルを付けてください
3. 断定的な表現を避ける：「犯罪者のアドレス」や「汚れた資金」のような表現は使わず、「高リスクとしてフラグ付けされている」や「不審な活動との関連がある」などの客観的な表現を使ってください
4. データソースの透明性：データソースのラベル（BlockInfo / Nansen / Arkham）には、必ず出典を明記してください
5. データの欠落を明示：資金追跡は段階的に展開されます。利用できない場合は、その旨を明示してください
6. ストーキングを助長しない：ユーザーが嫌がらせ目的で多数の個人アドレスを追跡しようとする場合は、責任ある利用を促してください