gate-info-addresstracker

gate-info-addresstracker

一般规则

⚠️ 停止——继续之前，必须阅读并严格遵守共享运行时规则。 阅读完所有规则前，不得选择或调用任何工具。这些规则具有最高优先级。 → 阅读 gate-runtime-rules.md → 同时阅读 info-news-runtime-rules.md，了解 gate-info / gate-news 的专属规则（工具降级、报告标准、安全、路由降级、存在 scripts/ 时的逐技能版本检查，以及旧版包装器路由）。

• 只能调用此技能中明确列出的 MCP 工具。 即使 MCP 服务中存在此处未记录的工具，也绝不能调用。
• 旧版 / 路由模式： 当步骤 0 输出 __FALLBACK__ 时，只能使用此文件中列出的 MCP 工具。当步骤 0 输出 __ROUTE_CLI__ 时，不要调用这些 MCP 工具；应按照步骤 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/ 目录中（<name> 与 frontmatter 中的名称相同）。

---

步骤 0 — 包装器路由探测

此旧版技能是主 CLI 技能 gate-info-web3 的兼容别名。

在触发更新、选择 MCP 工具或执行任何旧版工作流之前， 运行确定性的 shell 探测：

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 / 阻塞）： 每次触发时，先运行 check，不要设置 GATE_SKILL_UPDATE_MODE=auto。该脚本只进行比较本地版本与远程版本；如果 Result=update_available，则不会覆盖文件。停止——在执行任何 apply、run 或技能执行之前，先询问用户是否要更新。在沙箱中（例如 Cursor），之后运行 apply 时使用完全 / 所有权限。这符合独立脚本 TEST_REPORT 中的阻塞式更新确认：阻塞由这些 SKILL 说明和仅检查行为共同实现（而非静默自动应用）。

严格检查（Agent / IDE — 建议在运行 check 时使用）： 使用 GATE_SKILL_CHECK_STRICT=1。当 Result=update_available 时，check 会以状态码 3 退出，并打印 GATE_SKILL_CHECK_EXIT=3——它只会停止当前 shell 步骤。硬性规则：询问用户后，结束本轮助手对话；不要在同一条消息中调用 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>/。单参数模式：当 SKILL.md 存在时，脚本会按此顺序解析 DEST；否则 DEST 为 scripts/../。仅工作区目录树需要使用双参数 check / apply，并显式指定 DEST。

Agent 选择规则（下面带围栏的示例最多运行一个；根据操作系统和 $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 使用当前版本继续；不要向用户透露检查失败的技术细节。

Agent 解析（stdout）：GATE_SKILL_UPDATE_AGENT_ACTION=…。BLOCK_UNTIL_USER_CONFIRMS_UPDATE → 在执行技能前进行步骤 2。CONTINUE_SKILL_EXECUTION → 检查脚本不会阻止执行技能。

步骤 2 — 确认或拒绝（阻塞）

运行环境： 步骤 2 使用与步骤 1 相同的 Shell 系列（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，然后在当前安装上执行。

两步确认门（严格模式 check）： 在 GATE_SKILL_CONFIRM_TOKEN 与 .gate-skill-apply-token 匹配之前，apply / run（未设置 GATE_SKILL_UPDATE_MODE=auto 时）会失败。用户拒绝 → 运行 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>/ 匹配。
• 调用方式：使用 $SKILL_ROOT/scripts/update-skill.sh（或 .ps1），其中 $SKILL_ROOT/SKILL.md 是此技能文件 — 例如 ~/.cursor/skills/<name>、~/.codex/skills/<name>、~/.openclaw/skills/<name>、~/.agents/skills/<name>、~/.gemini/antigravity/skills/<name>；不要将 ~/.cursor（或任何不含 skills/<name>/SKILL.md 的宿主根目录）视为安装目录。仅提供一个参数时，脚本会按上述顺序解析 $SKILL_ROOT，然后回退到脚本所在目录；工作区安装需要显式设置 DEST。双参数 check / apply / revoke-pending： 标准顺序是先提供绝对路径 DEST（技能根目录），再提供 name；当只有一个规范化路径包含 SKILL.md 时，update-skill.sh / update-skill.ps1 会自动调整参数顺序（例如，Agent 先传 name，再传路径）。
• ClawHub 与完整目录树： 对于未包含 update-skill.ps1 的安装，可以从 gate/gate-skills 的 skills/<name>/scripts/ 下复制该文件（仅限手动操作；Agent 不得自动下载）。

不要将原始脚本日志直接输出给用户，调试时除外。严格模式下 check 以 exit 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 服务在当前环境中可用后，才继续。

路由规则

仅适用于旧版路径——当步骤 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

---

执行工作流

仅适用于旧版路径——当步骤 0 输出 __FALLBACK__ 时，本节适用。

步骤 1：意图识别与参数提取

从用户输入中提取：

• address：链上地址（自动检测格式）
• chain（可选）：链类型（ETH/BSC/TRX/BTC 等——可根据地址格式自动推断）
• intent_depth：用户意图深度
  • basic — 仅询问“这是谁”/“持有多少”
  • deep — 请求“追踪资金”/“显示交易”/“钱去了哪里”

自动检测地址格式：

地址前缀	推断出的链
0x	Ethereum（默认；也可能是 BSC/Polygon/Arbitrum 或其他 EVM 链）
bc1 / 1 / 3	Bitcoin
T	Tron
其他	提示用户指定链

步骤 2：阶段 1 — 地址概况（必需）

步骤	MCP 工具	参数	获取的数据
1	info_onchain_get_address_info	address={address}, chain={chain}, scope="with_defi"	地址概况：余额、标签、风险评分、DeFi 头寸、盈亏

步骤 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
• 地址存在风险标记

步骤 4：阶段 2 — 深度追踪（满足条件时触发）

步骤	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 最小值	info_onchain_trace_fund_flow 最小值
< $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

步骤 5：大模型汇总

---

报告模板

仅适用于旧版路径——当步骤 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. 不得鼓励跟踪骚扰：如果用户试图出于骚扰目的追踪大量个人地址，应提示其负责任地使用