gate-info-coincompare

gate-info-coincompare

通用规则

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

• 只能调用本技能中明确列出的 MCP 工具。 即使 MCP 服务中存在其他工具，只要本文档未说明，就不得调用。
• 旧版 / 路由模式： 当步骤 0 输出 __FALLBACK__ 时，只能使用本文档列出的 MCP 工具。当步骤 0 输出 __ROUTE_CLI__ 时，不要调用这些 MCP 工具；应根据步骤 0 指示委托给映射的主技能。

并排比较技能。用户输入 2–5 种币，系统并行调用每种币的市场快照和基本面工具，然后由大模型汇总多维数据，生成包含综合分析的比较表。

触发场景：用户提到两种或更多种币，并使用“比较”“对比”“vs”“哪个更好”“区别”“正面对比”等关键词。

逐技能更新： 此目录包含 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-research 的兼容别名。

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

PRIMARY_SKILL="gate-info-research"
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-research/SKILL.md 及其操作手册约定。仅传递最少上下文：symbols[]。
• __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-coincompare/scripts/update-skill.sh" check "gate-info-coincompare"

PowerShell：

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

结果含义：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-coincompare/scripts/update-skill.sh" apply "gate-info-coincompare"

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

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

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

如果第 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 失败，仍应根据运行时规则在适当情况下运行执行阶段。

---

MCP 依赖项

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

必需的 MCP 服务

MCP 服务	状态
Gate-Info	✅ 必需

使用的 MCP 工具

查询操作（只读）

• info_coin_get_coin_info
• info_coin_get_coin_rankings
• info_coin_search_coins
• info_marketsnapshot_batch_market_snapshot
• info_marketsnapshot_get_market_snapshot
• info_markettrend_get_technical_analysis

身份验证

• 是否需要 API 密钥：否
• 凭据来源：无；此技能仅使用只读 Gate Info / Gate News MCP 访问。

安装检查

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

路由规则

仅限旧版路径 — 当步骤 0 输出 __ROUTE_CLI__ 时，路由将交由 gate-info-research 处理。

用户意图	关键词／模式	操作
多种代币对比	"compare BTC and ETH" "SOL vs AVAX" "Layer2 coin comparison"	执行此技能的完整工作流
单种代币分析	"analyze SOL for me"	路由至 gate-info-coinanalysis
仅查询价格	"what's BTC price"	直接调用 info_marketsnapshot_get_market_snapshot
板块概览	"how is the DeFi sector doing"	路由至 gate-info-marketoverview
排名列表	"top 10 coins by market cap"	info_coin_get_coin_rankings 尚不可用 — 提示用户列出要比较的具体代币

---

执行工作流

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

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

从用户输入中提取：

• symbols[]：代币列表（2-5 个），例如 [BTC, ETH, SOL]
• 如果用户提及项目名称（例如 Solana、Avalanche），则映射为代币代码
• 如果用户提及板块但未指定代币（例如“哪些 Layer2 代币比较好”），则提示其列出 2-5 个具体代币

限制：最少 2 个，最多 5 个。如果超过 5 个，提示用户缩小范围。如果只有 1 个代币，请用户至少再提供一个，或路由至 gate-info-coinanalysis。

步骤 2：为每种代币并行调用 2 个 MCP 工具

对列表中的每个 symbol，并行执行：

步骤	MCP 工具	参数	获取的数据	并行
1a	info_marketsnapshot_get_market_snapshot	symbol={symbol}, timeframe="1d", source="spot"	市场数据：实时价格、K 线摘要、市值、FDV、恐惧与贪婪指数	是
1b	info_coin_get_coin_info	query={symbol}	基本面：项目信息、板块、融资、代币经济学	是

对 3 种代币而言，这会产生 6 次并行工具调用，且彼此之间没有依赖关系。当 info_marketsnapshot_batch_market_snapshot 和 info_coin_search_coins 可用时，优先使用它们；否则按上述方式逐个调用。

步骤 3（可选）：技术面比较

如果用户明确要求进行技术面比较，或代币数量不超过 3 个，可选择并行调用：

步骤	MCP 工具	参数	获取的数据	并行
2	info_markettrend_get_technical_analysis	symbol={symbol}	技术指标：RSI、MACD、均线排列、支撑位／阻力位	是

步骤 4：由大模型生成交叉比较报告

按代币归类所有工具响应，并由大模型使用以下模板生成并列比较报告。

---

报告模板

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

## Coin Comparison: {symbol_1} vs {symbol_2} [vs {symbol_3} ...]

### 1. Key Metrics Comparison

| Metric | {symbol_1} | {symbol_2} | {symbol_3} |
|--------|-----------|-----------|-----------|
| Price | ${price_1} | ${price_2} | ${price_3} |
| 24h Change | {change_24h_1}% | {change_24h_2}% | {change_24h_3}% |
| 7d Change | {change_7d_1}% | {change_7d_2}% | {change_7d_3}% |
| Market Cap | ${mcap_1} | ${mcap_2} | ${mcap_3} |
| Market Cap Rank | #{rank_1} | #{rank_2} | #{rank_3} |
| FDV | ${fdv_1} | ${fdv_2} | ${fdv_3} |
| 24h Volume | ${vol_1} | ${vol_2} | ${vol_3} |
| Fear & Greed Index | {fg_1} | {fg_2} | {fg_3} |

### 2. Fundamentals Comparison

| Dimension | {symbol_1} | {symbol_2} | {symbol_3} |
|-----------|-----------|-----------|-----------|
| Sector | {category_1} | {category_2} | {category_3} |
| Total Funding | ${funding_1} | ${funding_2} | ${funding_3} |
| Key Investors | {investors_1} | {investors_2} | {investors_3} |
| Circulating Ratio | {circ_ratio_1}% | {circ_ratio_2}% | {circ_ratio_3}% |
| Upcoming Unlocks | {unlock_1} | {unlock_2} | {unlock_3} |

### 3. Technical Comparison (if available)

| Dimension | {symbol_1} | {symbol_2} | {symbol_3} |
|-----------|-----------|-----------|-----------|
| Overall Signal | {signal_1} | {signal_2} | {signal_3} |
| RSI(14) | {rsi_1} | {rsi_2} | {rsi_3} |
| MACD | {macd_1} | {macd_2} | {macd_3} |
| MA Alignment | {ma_1} | {ma_2} | {ma_3} |

### 4. Comparative Summary

{LLM generates a 3-5 sentence cross-comparison analysis covering:}
- Strengths and weaknesses of each coin across dimensions
- Which coin has stronger recent performance and which is weakening
- Whether fundamentals and market data align
- Differentiated risks to watch

### 5. Dimension-by-Dimension Winners

| Dimension | Best Performer | Weakest Performer | Notes |
|-----------|---------------|-------------------|-------|
| Short-term Gains | {best_1} | {worst_1} | ... |
| Market Cap / FDV Ratio | {best_2} | {worst_2} | ... |
| Funding Background | {best_3} | {worst_3} | ... |
| Technical Signals | {best_4} | {worst_4} | ... |

### ⚠️ Risk Warnings

{Risk differentials identified in the comparison, e.g.:}
- {symbol_x} has only {x}% circulating supply — significantly higher unlock pressure than peers
- {symbol_y} RSI is in overbought territory — higher short-term pullback risk than {symbol_z}
- {symbol_w} 24h volume is disproportionately low relative to market cap — liquidity disadvantage

> The above analysis is a data-driven side-by-side comparison and does not constitute investment advice. Please make decisions based on your own risk tolerance.

---

判断逻辑

条件	评估
代币之间的 24h 涨跌幅差异 > 10%	标记为“短期表现显著分化”
某种代币的 FDV／市值比率 > 其他代币的 2 倍	标记为“FDV 相对偏高 — 解锁风险较高”
流通率 < 30%	标记为“流通率较低 — 存在未来抛压风险”
24h 成交量／市值 < 1%	标记为“流动性较低 — 大额交易存在滑点风险”
RSI 差异 > 30（一种代币超买，另一种超卖）	标记为“技术面状态相反 — 应分别评估”
任何工具返回空结果／错误	将对应列标记为“数据不可用”；其余代币照常显示
两种代币来自完全不同的板块	提醒用户：“跨板块比较仅供参考 — 核心价值驱动因素差异显著”

错误处理

错误类型	处理方式
币种不存在	提醒用户名称可能有误；排除该币种，继续比较其余币种
仅提供 1 个币种	转至 gate-info-coinanalysis（单币种分析）
提供的币种超过 5 个	提示用户缩小范围至 5 个或更少，或建议分批比较
某个币种的工具超时	跳过该币种对应的维度；在表格中标记为“暂时不可用”
所有工具均失败	返回错误消息；建议用户稍后重试
用户输入地址	转至 gate-info-addresstracker

---

跨技能路由

用户后续意图	转至
“深入分析 SOL”	gate-info-coinanalysis
“详细展示 SOL 的技术指标”	gate-info-trendanalysis
“这些币种最近有什么新闻？”	gate-news-briefing
“SOL 的合约安全吗？”	gate-info-riskcheck
“为什么 ETH 上涨了，SOL 却没有？”	gate-news-eventexplain
“链上数据对比如何？”	gate-info-tokenonchain

---

可用工具与降级说明

PRD 定义的工具	实际可用工具	状态	降级策略
info_marketsnapshot_batch_market_snapshot	info_marketsnapshot_get_market_snapshot	已降级	对每个币种并行调用 get_market_snapshot，不会影响速度
info_coin_search_coins	info_coin_get_coin_info	已降级	使用带有币种符号查询的 get_coin_info 作为替代
info_markettrend_get_technical_analysis	info_markettrend_get_technical_analysis	✅ 就绪	—

---

安全规则

1. 不提供投资建议：对比分析必须以数据为依据，并包含“非投资建议”免责声明
2. 不提供排名建议：不得给出“买 A 而不是 B”之类的结论，只呈现数据差异
3. 不预测价格：不得给出具体目标价或涨跌预测
4. 数据透明：标注每个维度的数据来源和更新时间
5. 标明缺失数据：任何维度缺少数据时，都要明确标记“数据不可用”，不得编造数据
6. 跨行业提醒：对比的币种属于不同行业时，提醒用户其基本逻辑存在差异