gate-news-intel

gate-news-intel

通用规则

⚠️ 停止 — 继续之前，必须阅读并严格遵循共享运行时规则。 阅读完所有规则之前，切勿选择或调用任何工具。这些规则具有最高优先级。 → 阅读 gate-runtime-rules.md → 对于 gate-info 和 gate-news 的共享规则，还需阅读 info-news-runtime-rules.md。

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

CLI 和操作手册约定

1. 主要边界：新闻、事件、公告及社交媒体/UGC 情报。可选的 info 调用仅出现在明确加入市场或币种背景的操作手册中（intel_plus_market、market_wide_intel）。
2. 旧版命令必须存在于 gate-cli v0.5.2 中。启用 shortcuts_enabled（>= 0.7.6）时，优先使用操作手册中的 shortcut / info_shortcut 代码块；失败或 CLI 版本较旧时，回退到旧版 commands。当预检 route 为 CLI 时，不要使用此技能中的 Gate MCP。
3. 数据收集命令始终传入 --format json。
4. 区分事实与观点：将事实（有日期的事件、官方公告、新闻电讯）与社区 / UGC / X / 社交媒体内容区分开（始终注明来源类型：UGC、X、Reddit、YouTube、情绪指数）。
5. 综合顺序（PRD 5.6.7）：
   • “为什么价格下跌 / 暴跌？” → 先呈现因果事件链（第 2 节），然后可选呈现市场 / 币种背景（第 4 节）。
   • “社区如何看待……？” → 先呈现第 3 节（社区 / UGC / X / 情绪），再呈现整体市场概览（第 4 节）。
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__ 并停止（旧版 MCP 回退不属于此仓库的主要技能）；BLOCK → 原样输出 user_message 并停止。

3. 当 status == "ready_with_migration_warning" 时，记住该状态 — 步骤 3 会在报告末尾追加一条迁移提示。

4. 步骤 0.5 — 版本门槛：根据 PREFLIGHT_JSON.cli_version，按照 skills/_shared/cli-version-routing.md 设置 shortcuts_enabled。保存 cli_version，供步骤 1 使用（market_move_explain 需要 >= 0.7.2 才能使用 explain-market-move）。

当 route == "CLI" 前，不要运行 news / info 数据收集。

---

步骤 1 — 意图路由

将用户查询映射到 playbooks/gate-news-intel.yaml 中恰好一个操作手册 ID。

操作手册 ID	适用情况	必填字段
news_brief	针对指定资产查询标题 /“最近发生了什么”	symbol
event_explain	纯事件时间线 / 详情查询，不涉及价格变动归因	symbol
market_move_explain	“X 为什么上涨 / 暴跌 / 拉升 / 下跌”、价格变动归因、市场变动原因	symbol、query
exchange_listings	上市、退市、维护、公告	—
community_intel	“社区观点”、Reddit、YouTube、X、社交媒体 / 情绪（以社交媒体为主）	symbol
intel_plus_market	用户需要新闻 + 市场或币种背景	symbol
market_wide_intel	不带交易代码的宽泛问题：“加密货币领域正在发生什么”	—

与版本相关的路由

market_move_explain 要求 gate-cli v0.7.2+（这是首次提供 explain-market-move 的版本）。此信息记录在操作手册的 cli_baseline 字段中。所有其他操作手册仍与 v0.5.2 兼容。

如果路由到 market_move_explain，但 cli_version < 0.7.2：改用 event_explain，并在报告页脚中包含以下提示：

explain-market-move requires gate-cli v0.7.2+. Falling back to event_explain with manual news/event stitching. Upgrade gate-cli for server-side Tavily-powered attribution with AI summary.

槽位提取

• symbol：代币代码（BTC、ETH 等）。如果操作手册要求但用户未提供，则询问用户。
• query：用户原始的自然语言问题，例如“Why did BTC surge?”。market_move_explain 必填；需从用户输入中原样提取。
• time_range：旧版叶节点的默认值为 24h / 7d / 30d；新闻快捷方式（+brief、+event-explain、+community-scan）仅接受 1h / 24h / 7d——调用前需根据操作手册快捷方式的 arg_enums 限定范围（参见 _shared/cli-version-routing.md）。market_move_explain：30m / 1h / 2h / 4h / 24h（默认值为 2h）。
• event_id：仅当用户提到要通过 get-event-detail 查询的具体事件时使用。
• topic_query：用于 market_wide_intel 网页搜索。

Coin 回退规则（market_move_explain）

用户触发 market_move_explain 但未明确指定 Coin 时：

1. 问题中明确指定 Coin：提取并使用该 Coin（例如，“ETH why crash” → ETH）。
2. 上下文中的 Coin：如果对话中有唯一的 Coin，则使用该 Coin。
3. 宽泛市场问题，未指定 Coin：默认使用 BTC，并附加提示：“No coin specified; defaulting to BTC as the broad-market representative asset.”
4. 指代不明确（“this coin”“that altcoin”）：询问用户具体指的是哪种 Coin。
5. 询问事件影响，未指定 Coin：询问用户要分析哪种 Coin。
6. 传统金融（例如“US stocks”“China A-shares”“S&P 500”）：将其作为 coin 值传入。
7. 非加密货币且指代不明确：询问用户，或路由到相应领域技能。

当 Coin 默认为 BTC 时，最终报告中必须显示该提示（市场变动模板的第 1 节）。

第 1 步的跨技能路由

用户信号	路由至
“是否安全 / honeypot / blacklist”	gate-info-risk（主要）
“追踪此地址 / 链上 / TVL / 储备”	gate-info-web3（主要）
“分析此 Coin / 基本面 / 技术面 / 宏观”（优先研究）	gate-info-research（主要）

---

第 2 步 — 数据收集

执行选定的操作手册。相同的 parallel_group → 并发执行；不同组之间需等待。

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

当 shortcuts_enabled 时，按 skills/_shared/cli-version-routing.md 执行 playbook shortcut 区块：

Playbook	快捷方式
news_brief	news +brief
event_explain	news +event-explain；当 when: event_id_present 时使用 --event-id，否则使用 --coin。旧版 social_sentiment 仍会运行（不会被替换）。将 market_interpretation 映射到 X，而不是情绪指数。
market_wide_intel	info +market-overview 仅替换旧版 market_overview；open_web 始终运行
community_intel	news +community-scan
intel_plus_market	先运行 news +brief，再运行 info +coin-overview（shortcut → info_shortcut；参见 playbook shortcut_block_order）

v0.7.6 中，market_move_explain 没有 +market-move-explain 快捷方式——保留 gate-cli news events explain-market-move 多步骤路径。

exchange_listings：基础调用仅使用 limit + format；如果用户提供了 symbol，且 CLI 支持，则添加 --coin {symbol}（get-exchange-announcements --help）。

event_explain：当 shortcuts_enabled 且已设置 event_id 时，通过快捷方式 args_when 传入 --event-id——不要同时运行旧版 get-event-detail。当快捷方式已禁用且已知 event_id 时，仅运行旧版 get-event-detail。对于价格变动归因，路由到 market_move_explain。

market_move_explain：分为两组执行（使用以下完整 CLI 路径——explain-market-move 位于 news events 下，而非 news feed）：

• A 组（并行，核心数据）：gate-cli news events explain-market-move（基于 Tavily 的新闻／事件证据和 AI 摘要）+ gate-cli info marketsnapshot get-market-snapshot（当前价格、涨跌幅、成交量）+ gate-cli info marketdetail get-orderbook（买／卖盘墙、深度失衡）。
• B 组（A 组完成后并行）：gate-cli info markettrend get-technical-analysis（跨时间框架的 TA 信号）+ gate-cli info coin get-coin-info（基本面）+ 社区命令（gate-cli news feed search-x + gate-cli news feed get-social-sentiment），仅当 symbol != BTC 时运行。对于 BTC，跳过社区命令——Tavily 已能捕获宏观／地缘政治信号。

收集数据后，Agent 必须使用所有已收集的数据自行完成最终归因综合分析。不要将任何单个工具的输出视为权威结论。优先考虑 relevance_score 较高的事件作为主要驱动因素，并与快照和订单簿中的价格／成交量数据交叉验证。

信息命令失败：在 intel_plus_market 和 market_move_explain 中，信息／社区命令均为可选项——如果失败，将相应部分标记为不可用，并仍然提供报告。

---

第 3 步 — 综合分析

根据 playbook 选择报告模板：

• market_move_explain：使用下方的 6 部分市场变动分析模板。
• 所有其他 playbook：使用下方的 5 部分情报简报模板。

情报简报模板（除 market_move_explain 外的所有 playbook）

按以下顺序生成五个部分：

## Intel briefing -- {subject}

### 1. Event / news takeaway
- 3-5 bullets; separate **verified facts** from **unconfirmed** items

### 2. Key facts and timeline
- Time-ordered, verifiable items from `search-news` / `get-latest-events` / `get-event-detail` where used

### 3. Community / UGC / X / Reddit / YouTube
- **Must** cover, when the playbook includes them: UGC (`search-ugc`), X (`search-x`), and sentiment where applicable (`get-social-sentiment`)
- Label every bullet with **source type** (e.g. UGC / X / sentiment index) -- do not state opinion as on-chain fact

### 4. Market or coin background (if any)
- Only when the playbook includes `info` or `get-market-overview` in `market_wide_intel`; if not used, state **no extra market context**

### 5. Conclusion and what to watch
- Not investment advice; list follow-up items

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

市场变动分析模板（仅限 market_move_explain）

按以下顺序生成六个部分：

## Market move analysis -- {coin} ({time_range})

[If coin was defaulted to BTC, append: "No coin specified; defaulting to BTC as the broad-market representative asset."]

### 1. Summary
[One concise attribution sentence. Synthesize: explain-market-move outer summary,
supporting_events summaries, market snapshot change%, and TA signals.
Prefer events with higher relevance_score as primary drivers.
Do NOT copy-paste the entire Tavily summary verbatim -- distill the key narrative.]

### 2. Primary drivers
[2-4 latest_news items from explain-market-move. For each: title, how it likely drove
the move (from its summary field), source URL, relevance_score.
Sort by relevance_score descending. If relevance_score < 0.5, note it as weak signal.
The outer summary in explain-market-move is a concatenation of these items'
Tavily AI answers; cross-reference with individual item summaries for accuracy.]

### 3. Supporting context
[1-2 supporting_events from the internal event pool, with first_seen_time.
Pay special attention to supporting_events[].summary -- these come from the internal
event pool and are NOT included in the outer summary, making them independent evidence.
Market snapshot: current price, change%, volume.
Order book: notable bid/ask walls or depth imbalances that explain the move magnitude.]

### 4. Technical signals
[Key TA indicators from get-technical-analysis. Trend direction, support/resistance
levels, RSI/MACD crossovers if available. Coin fundamentals from get-coin-info
(market cap rank, supply, sector).]

### 5. Community perspective
[Non-BTC only. X highlights from search-x, sentiment score from get-social-sentiment.
Label each item with source type (X / sentiment index).
If BTC, state: "Community data omitted for BTC; macro/geopolitical signals are
captured in Sections 2 and 3."]

### 6. What to watch
[Follow-up catalysts, key price levels, upcoming events that could confirm or
reverse the current move.]

[If data_status.is_partial: append "Partial data notice: {note if available}.
Missing sources: {missing_sources if listed}."]

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

market_move_explain 的综合分析规则

• Agent 必须自行完成最终归因——不要将任何单个工具的输出视为权威结论。
• 交叉参考：explain-market-move 中外层的 summary 是 Tavily AI 答案的拼接。supporting_events[].summary 字段是来自内部事件池的独立证据。Agent 在归因时应同时参考两者。
• latest_news 条目包含 relevance_score（0-1）。优先将高于 0.5 的条目作为主要驱动因素；将相关性较低的条目视为背景信息并注明。
• 根据市场快照中的价格／成交量数据验证由新闻驱动的叙事——如果发生了大幅变动，但没有匹配的事件证据，应说明原因尚无法解释。

迁移提示

如果 Step 0 的结果为 ready_with_migration_warning，请从 skills/_shared/report-style.md 中逐字附上迁移引用块行（以 ⚙️ 开头）。

---

跨技能路由 + 安全规则

路由

遵循 skills/_shared/routing.md。不要将 research / web3 / risk 类主要意图纳入此技能。新闻情报专属的后续请求（简报已发送后，用户提出后续问题）：

后续意图	目标
"深入研究这枚币" / "值得关注吗" / "基本面 / 技术面 / 宏观面"	gate-info-research
"事件中的地址" / "链上有什么" / "协议 TVL / 储备金 / 聪明钱"	gate-info-web3
"这个代币安全吗" / "蜜罐" / "黑名单" / "合规性"	gate-info-risk
用户更改 symbol 或时间范围，并希望获取同类情报	使用新的参数重新进入同一操作手册

安全规则

遵循 skills/_shared/report-style.md。新闻情报专属规则：

1. 不提供买卖建议；不提供价格目标。
2. 如果触发了 community_intel 或其他操作手册中的相关命令，社区和 UGC 是第 3 节的核心内容（不是脚注）。
3. 绝不捏造事件或引语——如果没有内容，标记为 无数据。

---

参考资料

文件	加载时机
skills/gate-news-intel/references/scenarios.md	在简报 / 事件 / 社区 / 上市 / 市场整体中进行选择时。
skills/gate-news-intel/references/cli-reference.md	news 和可选 info 命令的标志表。
skills/gate-news-intel/references/troubleshooting.md	可选标志、get-exchange-announcements 筛选条件、空的 event_id。
skills/_shared/preflight.md	Step 0。
skills/_shared/routing.md	跨技能矩阵。
skills/_shared/report-style.md	通用报告规则。