gate-info-tokenonchain

gate-info-tokenonchain

通用规则

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

• 只能调用本技能中明确列出的 MCP 工具。 不得调用此处未记录的工具，即使它们 存在于 MCP 服务中。
• 旧版 / 路由模式： 当步骤 0 输出 __FALLBACK__ 时，只能使用本文件中列出的 MCP 工具。当步骤 0 输出 __ROUTE_CLI__ 时，不要调用这些 MCP 工具；应按照步骤 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 的补充；存在脚本时，执行前应使用此流程检查版本。

更新检查 — 用户可见性： 版本检查期间发生的技术故障（脚本缺失、沙盒、网络、非零退出代码、没有可解析的 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 及其 playbook 合约。仅传递最少上下文：token 和 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-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 使用当前版本继续；不要向用户透露检查失败的技术细节。

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（如果用户拒绝）。此流程中，不要在同一轮里将 apply 与 check 连续执行。

   • 用户同意 → 按要求使用严格模式下 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-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>/ 匹配。
• 调用方式：使用 $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 退出码为 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 密钥：否
• 凭据来源：无；此 Skill 仅使用只读的 Gate Info / Gate News MCP 访问权限。

安装检查

• 必需项：Gate-Info
• 安装：继续之前，请按照当前主机 IDE 的本地 Gate MCP 安装流程进行安装。
• 仅当所需的 Gate MCP 服务在当前环境中可用后，才继续。

路由规则

仅限旧版路径——当步骤 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（暂不支持）	"smart money buying"	告知用户；仅运行可用范围
特定地址查询	"track this address 0x..."	路由至 gate-info-addresstracker
代币基本面	"analyze SOL"	路由至 gate-info-coinanalysis
鲸鱼实体追踪	"what is Jump Trading doing"	如果可用，路由至 gate-info-whaletracker；否则告知用户

---

执行工作流

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

步骤 0：多维意图检查

• 代币级链上数据 → 此 Skill。
• 特定地址（非代币）→ gate-info-addresstracker。
• 同时查询基本面、技术指标和新闻 → gate-info-research（如果可用）。

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

• symbol（必需）：代币代码（例如 BTC、ETH、SOL）
• chain（可选）：例如 eth、sol、bsc
• scope：holders、activity、transfers 中的一个或多个（smart_money — 不可用）
• time_range（可选）：transfers/activity 默认为 24h

步骤 2：并行调用 MCP 工具

步骤	MCP 工具	参数	获取的数据	并行
1a	info_onchain_get_token_onchain	symbol, chain, scope, time_range	各范围对应的持有者 / 活动 / 转账数据	是
1b	info_coin_get_coin_info	query={symbol}, scope="basic"	代币基本信息	是

步骤 3：LLM 汇总

• 结合代币信息，为链上数据提供背景
• 识别模式和异常
• 避免对价格进行推测性预测

---

报告模板

仅限旧版路径——当步骤 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%	活动显著增长
大额转账至交易所地址	可能存在卖压
大额转账来自交易所地址	可能正在积累
用户询问 Smart Money	说明该功能不可用；提供 holders/activity/transfers 选项

---

错误处理

错误类型	处理方式
链上未找到代币	通过 info_coin_get_coin_info 检查；建议核对代币代码/链
info_onchain_get_token_onchain 调用失败	仅显示代币信息；注明链上数据不可用
info_coin_get_coin_info 调用失败	显示链上数据，不提供市场背景
范围无返回结果	跳过相应部分；注明该范围无数据
不支持该链	列出支持的链；询问用户
两个工具均调用失败	返回错误；建议稍后重试
用户请求 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. Smart Money：明确说明数据不可用，不得估算。
7. 年龄与资格：仅面向所在司法管辖区内年满 18 周岁且具有完全民事行为能力的用户。
8. 数据流：宿主 Agent 处理用户提示词；此技能会调用上文列出的只读 Gate-Info MCP 工具。大模型会总结工具输出。此技能不会调用其他第三方数据服务。