gate-info-research

gate-info-research

通用规则

⚠️ 停止——继续之前，必须阅读并严格遵守共享运行时规则。 在读完所有规则之前，不要选择或调用任何工具。这些规则具有最高优先级。 → 阅读 gate-runtime-rules.md → 同时阅读 info-news-runtime-rules.md，了解 gate-info 和 gate-news 的共享规则（工具降级、报告标准、安全性、路由）。

• 只能调用此技能中明确列出的 MCP 工具。 不得调用此处未说明的工具，即使它们存在于 MCP 服务中。

CLI 和 playbook 约定

1. gate-cli v0.5.2 下必须存在旧版命令。当启用 shortcuts_enabled（参见步骤 0.5，cli_version >= 0.7.6）时，优先使用 playbook 中的 shortcut / additional_shortcut 区块（info +coin-overview、+market-overview 等）；如果失败或 CLI 版本较旧，则回退到 playbook YAML 中的旧版 commands。
2. 只能按照 playbooks/gate-info-research.yaml 中列出的方式调用 gate-cli info … / gate-cli news …。当预检 route 为 CLI 时，此主技能不会调用 Gate MCP 工具（MCP 仅用于旧版封装技能）。
3. 数据收集命令始终传入 --format json。不要在同一管道中混用 JSON 和美化输出。
4. 如果无法高置信度地解析必需字段（例如 single_coin 的 symbol），请向用户确认。切勿根据项目名称猜测代币代码。
5. 允许跨领域调用：当触发 research_plus_news playbook 时，gate-info-research 可以调用 gate-cli news …。不得接管主要意图为新闻 / 事件 / 社区的用户查询；这类查询应路由至 gate-news-intel。
6. 面向用户的最终报告可以使用用户的语言；此 SKILL.md 为便于发现和索引而保持英文（参见仓库 CLAUDE.md 规则 1）。

---

步骤 0 — 预检

严格遵循 skills/_shared/preflight.md 中的共享约定。概要：

1. 运行 gate-cli preflight --format json；解析 .route、.status、.user_message。
2. 分支处理：CLI → 继续；MCP_FALLBACK → 输出 __FALLBACK__ 并停止；BLOCK → 回显 user_message 并停止。
3. 当 status == "ready_with_migration_warning" 时，记住此状态——步骤 3 会在报告末尾追加一条迁移提示。
4. 步骤 0.5 — 版本门控：根据同一份 PREFLIGHT_JSON，按照 skills/_shared/cli-version-routing.md 设置 cli_version 和 shortcuts_enabled（当 >= 0.7.6 时，shortcuts_enabled=true）。

在步骤 0 返回 route == "CLI" 之前，不要运行第一条数据收集命令。

---

---

步骤 1 — 意图路由

将用户的查询映射到且仅映射到一个 playbook id。请从 playbooks/gate-info-research.yaml 读取 playbook 定义。以下映射为权威映射。

Playbook id	选择条件	必需槽位	覆盖的旧版技能
single_coin	“分析 SOL”“BTC 怎么样”“ETH 值得关注吗”，未明确提出额外维度。	symbol	gate-info-coinanalysis
market_overview	“现在的市场怎么样”“整体市场如何”“哪些板块热门”，未指定具体币种。	—	gate-info-marketoverview
multi_coin	“比较 BTC 和 ETH”“BTC vs SOL vs ARB”，2–20 个代码。	symbols	gate-info-coincompare
trend	“对 BTC 做技术分析”“SOL RSI / MACD”“BTC 价格方向 / 技术分析观点”。	symbol	gate-info-trendanalysis
macro	“NFP 对 BTC 的影响”“CPI 对市场的影响”“美联储利率决议与加密货币”。	—	gate-info-macroimpact
research_plus_news	“分析 SOL，并查看近期新闻和情绪”“分析加情绪 / 新闻”。	symbol	多个旧版技能分派

槽位提取规则

• symbol 是代码（BTC、ETH、SOL）。如果用户提供项目名称（“Solana”“Arbitrum”），请确认或询问。
• symbols 是列表；去除重复项；保持显示大小写一致。
• time_range 是用户指定的宽泛新闻上下文时间范围。按命令收窄枚举——超集为 1h / 24h / 7d / 30d，但各命令接受的范围可能更窄。在将用户提供的 time_range 传递给任何命令之前，必须根据该命令在 playbook 中的 arg_enums 限定范围（CLAUDE.md 规则 9）：search-news 接受 1h / 24h / 7d / 30d，search-ugc 接受 1h / 24h / 7d / 30d / all，get-social-sentiment 和 get-latest-events 仅接受 1h / 24h / 7d（CLI 会因 30d 返回 INVALID_ARGUMENTS）。对于 get-latest-events 的更长时间范围，请改用 --start-time / --end-time（unix-ms）。
• period（由 markettrend get-technical-analysis --period 和 get-kline --period 使用的分析窗口）。服务端枚举：1h / 4h / 24h / 3d / 5d / 7d / 10d / all。默认值为 3d。旧版别名 1d → 使用 24h；1w → 使用 7d。不要传入 1d 或 1w——CLI 会返回 INTEL_RESULT_ERROR: invalid period。
• timeframe 有两种变体：
  • get-kline --timeframe 枚举：1m / 5m / 15m / 1h / 4h / 1d（必填，无默认值）。
  • get-market-snapshot --timeframe 和 get-indicator-history --timeframe 枚举：15m / 1h / 4h / 1d（get-market-snapshot 默认值为 1h；get-indicator-history 必填）。这两个命令不接受 1m / 5m。
• indicators（用于 trend）默认值为 rsi,macd,ma30,ma200——仅限小写。大写形式（RSI、MACD）可以通过 CLI 验证，但服务端会静默返回空行。不支持的窗口（ma20、ma50）也会返回空行——请使用服务端已填充的数据集合：rsi、macd、macd_difference、ma7、ma30、ma120、ma200、ema7、ema30、ema200、boll_upper_band、boll_middle_band、boll_lower_band。完整字段列表请参阅 skills/gate-info-research/references/cli-reference.md（get-indicator-history 章节）。
• 如果缺少必需槽位，请停止并询问用户。

第 1 步的跨技能路由

用户信号	路由至
“这枚币 / 合约 / 地址安全吗”，“貔貅盘 / 黑名单 / 有风险吗”（安全优先）。	gate-info-risk（主要；第 1 轮上线）。
“这个地址是谁”，“聪明钱”，“巨鲸”，“DeFi TVL”，“协议指标”，“交易所储备”。	gate-info-web3（主要）
“BTC 为什么暴跌”，“最新消息”，“社区观点”，“Reddit”，“YouTube”。	gate-news-intel（主要）

---

第 2 步 — 数据收集

执行所选操作手册。每条命令都必须包含 --format json。同一 parallel_group 中的命令并行运行；Agent 等待该组完成后，再进入下一组或进行综合分析。

快捷路由（gate-cli >= 0.7.6）

当 shortcuts_enabled 且操作手册定义了 shortcut（或为 research_plus_news 定义了 additional_shortcut）时：

1. 根据 cli-version-routing.md 解析完整快捷方式列表：先处理 extends 上级项（先 info，后 news），然后按固定键顺序处理子项（shortcut → additional_shortcut → info_shortcut）。验证每个区块的 guards（例如，multi_coin：2 <= len(symbols) <= 5）。
2. 按顺序运行每个快捷方式区块；将所有区块的 replaces_command_ids 累积到操作手册级别的 skip_ids 并集中（包括 ID 匹配时的上级 news_addons，例如 research_plus_news）。
3. 如果某个区块的快捷方式失败（退出码非零和 / 或 stderr 为 {"error":…}）：若 fallback_on_error 为真，则仅将该区块所替代 ID 对应的旧版命令加入队列。info / news 调用不应有 stdout status（与 preflight 不同）。
4. 如果 payload 的顶层 stdout 中包含 partial / missing_sections，则标记受影响的报告子章节；除非所需数据为空，否则不要自动重新运行旧版命令。
5. 所有快捷方式均成功后：运行合并后的 extends 分组（commands、news_addons、additional_commands 等）中 id ∉ skip_ids 的条目，以及操作手册指定的 post_shortcut_optional_ids 和 coin_addon。

多快捷方式示例（research_plus_news：先 +coin-overview，再 +brief）见 cli-version-routing.md。

快捷方式字段映射：cli-version-routing.md。market_overview 快捷方式：不提供涨幅榜 / 跌幅榜 / 热门榜 — 使用 benchmark_snapshots + trend_anchor，并说明快捷方式路径无法提供排名（操作手册的 synthesis_note）。

2.A single_coin

快捷方式（>= 0.7.6）：gate-cli info +coin-overview --symbol {symbol} --format json 可替代下方三个 info 条目。可选新闻附加项保持不变。

命令	必需参数	备注
gate-cli info coin get-coin-info	--query {symbol} --scope full	基本面、板块、代币经济、投资者。
gate-cli info marketsnapshot get-market-snapshot	--symbol {symbol} --scope full	价格、24 小时 / 7 天涨跌、OI、资金费率、情绪数据包。
gate-cli info markettrend get-technical-analysis	--symbol {symbol}	多时间周期看涨 / 看跌 / 中性。
gate-cli news feed search-news (可选)	--coin {symbol} --limit 5 --sort-by importance --time-range 24h	头 5 条新闻。
gate-cli news feed get-social-sentiment (可选)	--coin {symbol} --time-range 24h	社交情绪倾向 + 提及量。

2.B market_overview

快捷方式（>= 0.7.6）：gate-cli info +market-overview --format json（可选 --benchmark BTC,ETH,SOL）。

命令	必需参数
gate-cli info marketsnapshot get-market-overview	（无标志）
gate-cli info coin get-coin-rankings	--ranking-type popular --limit 20
gate-cli info coin get-coin-rankings	--ranking-type top_gainers --time-range 24h --limit 10
gate-cli info coin get-coin-rankings	--ranking-type top_losers --time-range 24h --limit 10

2.C multi_coin

快捷方式（>= 0.7.6，仅限 2–5 个代码）：推导 symbols_csv = join(uppercase(symbols), ",")，然后执行 gate-cli info +coin-compare --symbols {symbols_csv} --format json。按照 cli-version-routing.md 映射 compare_matrix[] 负载（而不是 comparison_matrix）。

运行一次（旧版路径或超过 5 个代码）：

• gate-cli info marketsnapshot batch-market-snapshot --symbols {s1} --symbols {s2} … --scope full（--symbols 标志是可重复的 stringArray）。

然后并行地对每个代码运行：

• gate-cli info coin get-coin-info --query {symbol} --scope basic
• gate-cli info markettrend get-technical-analysis --symbol {symbol} （可选）

2.D trend

快捷方式（>= 0.7.6）：gate-cli info +trend-analysis --symbol {symbol} --format json（轻量级 TA；深度 K 线/指标历史记录请使用下方旧版路径）。

• gate-cli info markettrend get-technical-analysis --symbol {symbol} --period {period|3d}
• gate-cli info markettrend get-kline --symbol {symbol} --timeframe {timeframe|1d} --size 120 --with-indicators true
• gate-cli info markettrend get-indicator-history --symbol {symbol} --timeframe {timeframe|1d} --indicators rsi --indicators macd --indicators ma30 --indicators ma200 --limit 120

2.E macro

• gate-cli info macro get-macro-summary
• gate-cli info macro get-economic-calendar --start-date {today} --end-date {today+14d} --importance high
• gate-cli info macro get-macro-indicator --indicator {indicator|CPI} --country {country|US} --mode series --size 12 （可选）
• 如果用户指定了币种，还需运行：gate-cli info marketsnapshot get-market-snapshot --symbol {symbol} --scope basic。

2.F research_plus_news

当 shortcuts_enabled（>= 0.7.6）时：

1. 继承的 single_coin 快捷方式：gate-cli info +coin-overview --symbol {symbol} --format json。
2. 子快捷方式：gate-cli news +brief --coin {symbol} --time-range {time_range|24h} --format json。
3. 构建 skip_ids = 两个区块的 replaces_command_ids 的并集（包括父级 single_coin news_addons ID news_brief、social_sentiment）。
4. 仅运行 id ∉ skip_ids 的旧版命令——通常是 additional_commands 中可选的 ugc_scan。不要重新运行三个被替换的新闻命令或父级 news_addons。

仅限旧版（shortcuts_enabled == false 或失败的快捷方式按区块执行 fallback_on_error）：

• 信息：single_coin 的旧版三条命令（get-coin-info、get-market-snapshot、get-technical-analysis）。

• 新闻：使用下方的 additional_commands（不要同时运行 single_coin 的 news_addons——ID 重复）：

• gate-cli news feed search-news --coin {symbol} --limit 10 --sort-by importance --time-range {time_range|24h}

• gate-cli news feed get-social-sentiment --coin {symbol} --time-range {time_range|24h} — 发送前将 time_range 限制为 1h / 24h / 7d

• gate-cli news feed search-ugc --coin {symbol} --time-range {time_range|7d} --platform all --limit 20 （可选）

• gate-cli news events get-latest-events --coin {symbol} --time-range {time_range|7d} --limit 15 （可选） — 发送前将 time_range 限制为 1h / 24h / 7d

失败策略

• 如果必需命令失败或返回错误负载，则中止操作手册，并向用户展示可采取操作的 CLI 错误。
• 如果可选命令失败，则继续执行，并在步骤 3 中将对应部分标记为无数据。
• 切勿编造数字；切勿用推断值填补缺失维度。

---

步骤 3 — 综合分析

将 JSON 负载汇总为固定的 6 部分报告。各部分顺序为必需项，且与产品需求规范一致。

报告模板

## {subject} — Research report

### 1. Executive summary
- Core view (neutral framing: **stronger / softer / needs monitoring**; not investment advice)
- Up to 3 supporting data points
- Up to 2 main risk observations

### 2. Fundamentals and market position
{Positioning, sector, valuation (MC / FDV), funding / investors, unlocks. Sources: `info coin get-coin-info`.}

### 3. Market and trend
**Snapshot**
| Field | Value | Read |
|------|------|------|
| Price | ... | ... |
| 24h / 7d change | ... | ... |
| Funding | ... | ... |
| Sentiment / fear-greed | ... | ... |

**Technicals**
- Short term (1h / 4h): {bull / bear / neutral}
- Medium term (1d / 1w): {bull / bear / neutral}
- Key support / resistance: ...

Sources: shortcut aggregates (`agg_coin_overview`, `agg_market_overview`, etc.) or legacy commands (`get-market-snapshot`, `get-technical-analysis`, `get-kline`, `get-indicator-history`, `get-market-overview`, `get-coin-rankings`, `batch-market-snapshot`, `get-macro-summary`, `get-economic-calendar`, `get-macro-indicator`) as applicable. Map shortcut JSON fields per [cli-version-routing.md](../_shared/cli-version-routing.md).

### 4. Recent news and market tone
- **Factual events** (from `news feed search-news` / `news events get-latest-events`): ...
- **Community tone** (from `news feed get-social-sentiment` / `news feed search-ugc`): ...

Keep facts and community tone in separate subsections. If no news commands ran, mark **no data** for this section.

### 5. Risk notes
- Data-backed risk bullets (e.g. elevated RSI, near-term unlock, extreme funding, related incidents)
- Cite the originating command for each item

### 6. What to watch next
- Macro / unlock / protocol events in the next 7–14 days
- Technical triggers (e.g. “if price loses X, bias turns weaker”)

> This report is based on public data and tool output; it is not investment advice.

决策阈值（应用于第 3 和第 5 部分）

条件	报告中的标记
RSI > 70（get-indicator-history 的最新一行）	"RSI 超买 — 短期回调风险升高"
RSI < 30	"RSI 超卖 — 可能反弹"
24 小时成交量 > 7 天平均成交量的 2 倍	"成交量显著激增"
24 小时成交量 < 7 天平均成交量的 0.5 倍	"成交量明显下降"
funding_rate > 0.05%（来自 get-market-snapshot）	"资金费率偏高 — 多头拥挤"
funding_rate < -0.05%	"资金费率为负 — 空头拥挤"
恐惧与贪婪指数 > 75	"极度贪婪 — 请谨慎行事"
恐惧与贪婪指数 < 25	"极度恐惧 — 可能存在机会"
未来 30 天内即将解锁的代币数量 > 流通供应量的 5%（来自 get-coin-info）	"即将有大量代币解锁 — 可能带来抛售压力"

迁移提示（仅当步骤 0 状态为 ready_with_migration_warning 时）

在面向用户的最终报告末尾，逐字附上 skills/_shared/report-style.md 中迁移提示下定义的单行引用块（以 ⚙️ 开头并提及 gate-cli migrate --dry-run 的那一行）。不得改写。

---

跨技能路由 + 安全规则

路由

遵循 skills/_shared/routing.md 中的共享矩阵。研究技能专属的后续处理：

后续意图	目标
"是否安全"、"蜜罐"、"黑名单"、"合规性"	gate-info-risk（主要）
"追踪这个地址"、"聪明钱"、"巨鲸"	gate-info-web3（主要）
"为什么暴跌"、"社区观点"	gate-news-intel（主要）
"只需要技术分析"	重新进入 trend 操作手册
"只需要最新新闻动态"	使用 time_range 24h 重新进入 research_plus_news

安全规则

遵循 skills/_shared/report-style.md 中的共享约定。研究专属提醒：

1. 不提供买入／卖出建议——允许使用的最强措辞是更强／更弱／需要监控（中性）。
2. 不提供具体目标价格。
3. 每个部分至少引用一个来自步骤 2 的命令 ID（来源在 playbook 的 report_sections[*].source_commands 中列出）。
4. 缺少数据时 → 标记为无数据；绝不捏造。

---

参考资料

文件	何时加载……
skills/gate-info-research/references/scenarios.md	不确定该选哪个 playbook ID。每一行都将具体提示词映射到一个 playbook 及其预期行为。
skills/gate-info-research/references/cli-reference.md	需要了解此技能使用的任何 gate-cli info 或 gate-cli news 命令的完整标志表（类型／必填／默认值）。
skills/gate-info-research/references/troubleshooting.md	命令失败、槽位含义不明确，或报告完整性规则可能即将遭到违反。
skills/_shared/preflight.md	步骤 0 约定（逐字片段 + 5 种状态矩阵）。
skills/_shared/cli-version-routing.md	步骤 0.5 版本检查及快捷执行／JSON 字段映射。
skills/_shared/routing.md	跨技能路由矩阵。
skills/_shared/report-style.md	所有主要技能共用的安全与报告格式规则。
skills/_shared/update-workflow.md	技能更新检查／应用工作流。