gate-info-risk

gate-info-risk

通用规则

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

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

CLI 和操作手册约定

1. 旧版命令必须存在于 gate-cli v0.5.2 中。当启用 shortcuts_enabled（>= 0.7.6）时，token_risk 可根据操作手册中的 shortcut 使用 info +token-risk；如果失败或 CLI 版本较旧，则回退到 check-token-security。此技能不会为 address_risk 调用 check-address-risk 或 +address-tracker。
2. 仅按 playbooks/gate-info-risk.yaml 中列出的方式调用 gate-cli info … / gate-cli news …。当预检 route 为 CLI 时，不得调用此技能中的 Gate MCP 工具。
3. 缺失数据绝不代表“低风险”。当所选操作手册的主要命令不可用时，判定结果为 UNABLE_TO_ASSESS（范围有限；用户报告中可以出现本地化标签），并明确提示重试。
4. 始终传入 --format json。必须提供必填项（token+chain、address+chain、symbol）；如果有歧义，请询问用户。
5. 报告以安全为先：判定结果行必须置于证据之前，并始终优先列出高严重性项目，其次是中、低严重性项目。
6. 不提供买入 / 卖出建议，不预测价格。在此技能的逻辑中使用判定等级 HIGH / MEDIUM / LOW / UNABLE_TO_ASSESS；最终用户报告可以将这些标签本地化。始终包含一份**“接下来需要核实的内容”**列表。

---

步骤 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：按照 skills/_shared/cli-version-routing.md 设置 cli_version 和 shortcuts_enabled。

步骤 0 返回 route == "CLI" 之前，不得运行任何数据收集命令。

---

---

步骤 1 — 意图路由

从 playbooks/gate-info-risk.yaml 中准确选择一个操作手册 ID：

操作手册 ID	适用情况	必填项
token_risk	“这个代币安全吗”“是不是蜜罐”“税费太高”“持有者集中度”——对象是代币合约。	token、chain（token 项接受代币代码或合约地址）
address_risk	“这个地址安全吗”“是否受到制裁 / 是否在 OFAC 名单上”“黑名单”“这个钱包有风险吗”。	address、chain
project_risk	“这个项目有合规或安全事件风险吗”“{project} 是否发生过安全事件”“交易所公告风险”。	symbol

槽位提取规则

• check-token-security 必须且只能使用 --token 或 --address 中的一个——CLI 会明确拒绝同时传入两者（见 CLI 错误消息；两者互斥）。此技能始终使用 --token，因为该标志具有多态性：既接受代币代码（USDT），也接受合约地址（0xdAC17F...、SPL 铸币地址、TRX 铸币地址）。Agent 槽位提取规则：当用户在代币风险查询中提到合约地址时，直接将该地址存入 token 槽位——不要为此操作手册另建平行的 address 槽位。始终与 --chain 搭配使用。
• chain 的规范形式（始终在 --chain 上发送短 ID）：eth、bsc、polygon、arb、op、base、avax、solana、tron、……接受用户常用的长格式别名（ethereum、arbitrum、optimism、avalanche、bnb、matic），并在调用 CLI 前规范化为短 ID。响应中的 .chain 回显取决于端点——有时是短格式（eth→eth），有时是长格式（arb→arbitrum）。解析器 MUST 同时接受两种别名形式；输入规范化和响应解析的规范别名表见 skills/gate-info-risk/references/troubleshooting.md。
• address 指钱包。如果用户询问代币合约，却传入了地址，请确认他们指的是哪一种。
• project_risk 的 symbol 指已上市代币的代码；调用 news 命令前，先消除有歧义的项目名称。
• 缺少必需槽位或槽位有歧义 → 停止并询问用户。不要猜测。

第 1 步的跨技能路由

用户信号	路由到
“只要对这枚币做一般分析”，没有安全方面的表述	gate-info-research
“这个地址是谁／在链上做什么”（非风险优先）	gate-info-web3
“为什么跌了”／“社区对这起事件怎么看”	gate-news-intel

---

第 2 步 — 数据收集

所有命令都使用 --format json。同一 parallel_group 中的命令会并发运行。

当 shortcuts_enabled 启用且操作手册定义了 shortcut 时，请遵循 skills/_shared/cli-version-routing.md。将 +token-risk 的输出（risk_level、risk_items、token_identity）映射到与 check-token-security 相同的判定规则。

token_risk 快捷方式参数：代币代码使用操作手册的 args（--symbol）；对于形似合约地址的 token，使用带 when: contract_address 的 args_when（--address + --chain）。快捷方式成功后，仍需运行可选的 token_onchain（post_shortcut_optional_ids）——快捷方式不包含链上持有者数据。

2.A token_risk

快捷方式（>= 0.7.6）：从操作手册的 shortcut.args / shortcut.args_when 解析参数（代币代码不得默认使用 --address）。原生币解析失败时，回退到以下旧版命令。

必需（旧版）：

• gate-cli info compliance check-token-security --token {token} --chain {chain} --scope full

可选（与上述命令并行运行）：

• gate-cli info coin get-coin-info --query {symbol_or_token} --chain {chain} --scope basic — 提供项目基本面信息作为背景。
• gate-cli info onchain get-token-onchain --token {token} --chain {chain} --scope full — 持有者集中度、聪明钱流向。

2.B address_risk

必需：

• gate-cli info onchain get-address-info --address {address} --chain {chain} --scope basic — 风险标签、标记及限定范围的余额摘要。

可选：

• gate-cli info onchain get-address-transactions --address {address} --chain {chain} --time-range 30d --min-value-usd 100000 --limit 50 — 近期大额资金流动；有助于标记混币／频繁更换交易所的行为。

范围受限规则：gate-cli v0.5.2 未提供 info compliance check-address-risk。如果 get-address-info 未返回风险标签或标记，最终判定必须为 UNABLE_TO_ASSESS（在用户输出中本地化），并注明应在专用地址风险命令发布后重新检查。

2.C project_risk

必需（并行运行）：

• gate-cli news feed search-news --coin {symbol} --limit 10 --sort-by importance --time-range 7d
• gate-cli news events get-latest-events --coin {symbol} --time-range 7d --limit 20（服务端枚举值为 1h|24h|7d；较长时间范围请使用 --start-time / --end-time unix-ms）

可选：

• gate-cli news feed get-exchange-announcements --coin {symbol} --limit 10 — 上市／退市／维护／紧急通知。

失败策略

• 必需命令失败 → 中止操作手册，原样显示 CLI 错误（删去认证信息），停止。不输出判定。
• 可选命令失败 → 在第 3 步中将对应部分标记为 scope limited，并降低置信度。
• 上游返回“not found”或标签为空 → 视为数据缺失，而非低风险。

---

第 3 步 — 综合分析

报告始终包含 5 个部分，顺序如下：

报告模板

## Risk assessment — {subject}

### 1. Verdict
- **Level**: {HIGH | MEDIUM | LOW | UNABLE_TO_ASSESS} (you may localize labels in the user-facing report)
- Three short sentences: main basis + data coverage + confidence (whether scope-limited)

### 2. Core risk items
Sort strictly HIGH → MEDIUM → LOW. Each item includes:
- Risk name + taxonomy: `TECHNICAL_CONTRACT` / `ADDRESS_COMPLIANCE` / `PROJECT_LEVEL`
- Evidence (real JSON paths), e.g. `check-token-security.high_risk_list[?risk_key=="is_honeypot"].risk_value == "1"`, `check-token-security.data_analysis.top10_percent`, `get-address-info.risk_labels`
- Impact + trigger (e.g. “tax rises after holding > 7 days”)

### 3. On-chain or compliance context
{Balances / tags / labels / large flows / holder concentration / fundamentals. Sources as hit by playbook:
`info onchain get-address-info`, `info onchain get-address-transactions`, `info onchain get-token-onchain`, `info coin get-coin-info`}

### 4. Event context (if any)
{Last 7–30d news / incidents / announcements from `news feed search-news`, `news events get-latest-events`, `news feed get-exchange-announcements`. Separate **sourced facts** from **community speculation** (mark “needs confirmation” where needed).}

If the playbook did not call news commands, mark **no data**; you may suggest `gate-news-intel` for follow-up.

### 5. What to verify next
- List concrete next commands to close each gap
- If **UNABLE_TO_ASSESS**, the first bullet must tell the user to re-run `check-token-security` / `get-address-info` with the correct `{chain}`
- No buy/sell advice; no price targets

Verdict rules (applied in section 1)

check-token-security 有意采用两种类型约定——Agent 不得混用：

• 顶层标志（例如 .is_honeypot、.is_open_source）是 JSON 布尔值（true / false）。使用 == true / == false 进行比较，不要与 "1" / "0" 比较。
• high_risk_list[]、middle_risk_list[]、low_risk_list[]、risky_list[]、attention_list[] 中的嵌套列表项，其 .risk_value 是字符串（"0" / "1"）。使用 == "1" 进行比较，或通过 tonumber 转换。
• 税费字段（.buy_tax、.sell_tax、嵌套的 .tax_analysis.token_tax.{buy_tax,sell_tax,transfer_tax}）是字符串（不含 % 的百分比）。进行数值比较前，先使用 tonumber 转换。
• .data_analysis 下的百分比字段（.top10_percent、.top100_percent、.dev_holding_percent、.insider_percent、.max_holder_percent）是字符串。比较前先转换。
• 每个嵌套项的结构为 {risk_key, risk_value, risk_level, risk_name, risk_desc}。

信号（实际 JSON 路径）	对判定的影响
high_risk_list[?risk_key=="is_honeypot"].risk_value == "1"（等同于顶层 is_honeypot == true——顶层值是布尔值，不是字符串）	高（立即）
high_risk_list[?risk_key=="is_high_tax"].risk_value == "1" 或 tonumber(buy_tax) > 10 或 tonumber(sell_tax) > 10	至少为高
middle_risk_list[?risk_key=="owner_change_balance"].risk_value == "1"（所有者可以重写任意持有者的余额）	高（立即）
middle_risk_list[?risk_key=="can_take_back_ownership"].risk_value == "1" 或 middle_risk_list[?risk_key=="hidden_owner"].risk_value == "1" 或 middle_risk_list[?risk_key=="self_destruct"].risk_value == "1"	高（立即）
middle_risk_list[?risk_key=="is_mintable"].risk_value == "1" 或 middle_risk_list[?risk_key=="is_proxy"].risk_value == "1" 或 middle_risk_list[?risk_key=="is_blacklisted"].risk_value == "1"	至少为中
high_risk_list[?risk_key=="is_open_source"].risk_value == "0"（等同于顶层 is_open_source == false——顶层值是布尔值）	至少为中
tonumber(data_analysis.top10_percent) > 70（或顶层 top10_percent），且没有锁仓证据	至少为中
get-address-info.risk_labels 包含 OFAC / sanctioned / mixer / scam / exchange-hack-proceeds / darknet	高（立即）
get-address-info 返回 risk_labels=[] 且 tags=[]	无法评估（范围有限）——不要降为低
holders.holder_concentration[?label=="No.1-10"].percentage > 0.5，且 7 天内存在活跃的大额换手（get-token-onchain）	添加一项中风险
latest-events 中的 event_type == "exploit" / "rug" / "depeg"，且 create_time ≤ 7 天	添加一项中或高风险（视严重程度而定）
所有必需命令均执行失败	无法评估 + 提供明确的重试指引

可选的摘要捷径：check-token-security.risk_summary.highest_risk_level——上游提供的汇总 0–3 严重程度评分（3 = 蜜罐级别）。当 highest_risk_level >= 3 且没有任何被标记的 risk_key 时，仍须按上述规则逐项检查，并引用具体的问题字段，不要只引用 risk_summary。

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

在报告末尾，原样附上 skills/_shared/report-style.md 中的迁移引用块行（以 ⚙️ 和 gate-cli migrate --dry-run 开头）。

绝不要根据迁移状态来决定判定结果。

---

跨技能路由 + 安全规则

路由

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

后续意图	目标
“全面研究” / “值得关注吗”	gate-info-research
“这个地址在做什么” / “聪明钱的行为”	gate-info-web3
“为什么下跌” / “社区对该事件的看法”	gate-news-intel
用户更换链或代币，并希望重新评估	使用新的槽位重新进入同一操作手册；不要沿用先前的结论。

安全规则

遵循 skills/_shared/report-style.md 中的共享约定。风险专属强化规则：

1. 如果必需命令失败，或未返回风险标签／安全检查字段，绝不能给出 LOW；应使用 UNABLE_TO_ASSESS（或其本地化表述）。
2. 在第 2 节中严格区分三类风险分类（TECHNICAL_CONTRACT / ADDRESS_COMPLIANCE / PROJECT_LEVEL）。
3. 在第 2 节中，HIGH 项必须列在任何 MEDIUM 或 LOW 项之前。
4. 不得提供买入／卖出建议。最接近许可的表述是“避免／进一步核实”（保持中立，不作指示）。
5. 对每项影响结论的说法，引用确切的 JSON 路径，例如 info compliance check-token-security.high_risk_list[?risk_key=="is_honeypot"].risk_value 或 info compliance check-token-security.data_analysis.top10_percent；绝不能只含糊地引用命令，例如“来自 check-token-security”。

---

参考资料

文件	在以下情况下加载……
skills/gate-info-risk/references/scenarios.md	不确定该选择哪个操作手册 ID，或用户的提示看起来符合场景 4／5（地址风险、主流币歧义）。
skills/gate-info-risk/references/cli-reference.md	需要查看 check-token-security、get-address-info、get-token-onchain 或辅助新闻命令的完整标志表。
skills/gate-info-risk/references/troubleshooting.md	命令失败，或 get-address-info 未返回风险标签（check-address-risk 缺失）。
skills/_shared/preflight.md	步骤 0 约定。
skills/_shared/routing.md	跨技能路由。
skills/_shared/report-style.md	安全与报告规则。
skills/_shared/update-workflow.md	技能更新工作流。