gate-info-research

gate-info-research

一般ルール

⚠️ 停止 — 続行する前に、共有ランタイムルールを必ず読み、厳守してください。 すべてのルールを読むまで、ツールを選択または呼び出してはなりません。これらのルールが最優先です。 → 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.5、cli_version >= 0.7.6 を参照）が有効な場合は、プレイブックの shortcut / additional_shortcut ブロック（info +coin-overview、+market-overview など）を優先してください。失敗した場合、または CLI が古い場合は、プレイブック YAML のレガシー commands にフォールバックしてください。
2. gate-cli info … / gate-cli news … は、playbooks/gate-info-research.yaml に記載されている場合に限り呼び出してください。このプライマリスキルは、プリフライトの route が CLI の場合、Gate MCP ツールを呼び出しません（MCP はレガシーラッパースキル専用です）。
3. データ収集コマンドには必ず --format json を指定してください。同じパイプラインで JSON 出力と整形済み出力を混在させてはなりません。
4. 必須スロット（例：single_coin の symbol）を高い確度で解析できない場合は、ユーザーに確認してください。プロジェクト名からティッカーを推測してはなりません。
5. クロスドメインでの利用は許可されています。research_plus_news プレイブックが適用される場合、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 でレポートの末尾に移行に関するヒントを 1 つ追加します。
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 — インテントの振り分け

ユーザーのクエリを、プレイブック ID のいずれか 1 つに対応付けます。playbooks/gate-info-research.yaml からプレイブックの定義を読み込みます。以下の対応表を正とします。

Playbook id	選択する条件	必須スロット	対応するレガシースキル
single_coin	「SOLを分析して」「BTCの状況は？」「ETHは注目する価値がある？」など、明示的な追加分析軸がない場合。	symbol	gate-info-coinanalysis
market_overview	「今の市場は？」「市場全体の状況は？」「どのセクターが注目されている？」など、特定のコインを指定していない場合。	—	gate-info-marketoverview
multi_coin	「BTCとETHを比較して」「BTC対SOL対ARB」など、ティッカーが 2〜20 個の場合。	symbols	gate-info-coincompare
trend	「BTCのテクニカル分析をして」「SOLのRSI／MACD」「BTCの価格の方向性／テクニカル分析の見解」などの場合。	symbol	gate-info-trendanalysis
macro	「NFPがBTCに与える影響」「CPIが市場に与える影響」「FRBの金利決定と暗号資産」などの場合。	—	gate-info-macroimpact
research_plus_news	「SOLを分析して、最近のニュースやセンチメントも確認して」「分析にセンチメント／ニュースも追加して」などの場合。	symbol	複数のレガシースキルへのファンアウト

スロット抽出ルール

• symbol はティッカー（BTC、ETH、SOL）です。ユーザーがプロジェクト名（「Solana」「Arbitrum」）を指定した場合は、確認するか質問してください。
• symbols はリストです。重複を取り除き、表示上の大文字・小文字の表記を統一してください。
• time_range は、ニュースのコンテキストに対するユーザー指定の大まかな期間です。コマンドごとに列挙値の範囲を絞り込みます。上位集合は 1h / 24h / 7d / 30d ですが、コマンドごとに受け付ける範囲は異なります。ユーザー指定の time_range をコマンドに渡す前に、プレイブックの 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 には 2 つの種類があります。
  • 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 は必須）。この 2 つでは 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 内のコマンドは並行して実行されます。エージェントは、次のグループまたは統合に進む前に、グループの完了を待ちます。

ショートカットルーティング（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 の呼び出しでは（preflight と異なり）stdout の status を想定しないでください。
4. ペイロードの partial／missing_sections（stdout のトップレベル）については、影響を受けるレポートのサブセクションに印を付けます。必要なデータが空でない限り、レガシーコマンドを自動的に再実行しないでください。
5. すべてのショートカットが成功した後、id が skip_ids に含まれないレガシー項目（マージ済みの extends バケット：commands、news_addons、additional_commands、…）に加え、プレイブックに従って 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 は、以下の 3 つの 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 ではありません）をマッピングします。

1回実行します（レガシー、またはシンボルが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。詳細なローソク足／インジケーター履歴には以下のレガシーパスを使用します）。

• 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 です。置き換えられた3つのニュースコマンドや親の news_addons を再実行しないでください。

レガシーのみ（shortcuts_enabled == false、またはショートカット失敗時のブロックごとの fallback_on_error）：

• 情報：single_coin のレガシー3コマンド（get-coin-info、get-market-snapshot、get-technical-analysis）。

• ニュース：以下の additional_commands を使用します（ID が重複するため、single_coin の news_addons も実行しないでください）。

• 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 overbought — elevated short-term pullback risk"
RSI < 30	"RSI oversold — potential bounce"
24 時間の出来高 > 7 日平均出来高の 2 倍	"Significant volume surge"
24 時間の出来高 < 7 日平均出来高の 0.5 倍	"Notable volume decline"
funding_rate > 0.05%（get-market-snapshot から取得）	"High funding rate — long crowding"
funding_rate < -0.05%	"Negative funding rate — short crowding"
Fear & Greed > 75	"Extreme Greed — exercise caution"
Fear & Greed < 25	"Extreme Fear — potential opportunity"
30 日以内に予定されているトークンアンロックが流通供給量の 5% 超（get-coin-info から取得）	"Large upcoming token unlock — potential sell pressure"

移行ヒント（ステップ 0 のステータスが ready_with_migration_warning の場合のみ）

ユーザーに最終表示するレポートの末尾に、skills/_shared/report-style.md の移行ヒントに定義されている単一行の引用ブロックをそのまま追加します（⚙️ で始まり、gate-cli migrate --dry-run に言及している行）。言い換えてはいけません。

---

スキル間のルーティングと安全ルール

ルーティング

skills/_shared/routing.md の共通マトリックスに従ってください。リサーチスキル固有の後続対応は次のとおりです。

後続対応の意図	対象
"is it safe", "honeypot", "blacklist", "compliance"	gate-info-risk（主）
"trace this address", "smart money", "whale"	gate-info-web3（主）
"why did it crash", "community take"	gate-news-intel（主）
"only need the technical read"	trend プレイブックを再実行
"only need the latest news feed"	time_range 24h を指定して research_plus_news を再実行

安全ルール

skills/_shared/report-style.md の共通ルールに従ってください。リサーチ固有の注意事項：

1. 買い／売りの助言は禁止です。許容される最も強い表現は、（中立的な）より強い／より弱い／監視が必要です。
2. 具体的な価格目標を示してはいけません。
3. 各セクションでは、Step 2 のコマンド ID を少なくとも 1 つ引用してください（ソースはプレイブックの report_sections[*].source_commands で指定されています）。
4. データがない場合は データなし と記載してください。決して捏造してはいけません。

---

参照資料

ファイル	読み込むタイミング...
skills/gate-info-research/references/scenarios.md	どのプレイブック ID を選ぶべきか判断できない場合。各行で、具体的なプロンプトと対応するプレイブックおよび想定される動作を示します。
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	Step 0 の契約（逐語的なスニペットと 5 ステータスのマトリックス）。
skills/_shared/cli-version-routing.md	Step 0.5 のバージョンゲートと、ショートカットの実行／JSON フィールドのマッピング。
skills/_shared/routing.md	スキル横断のルーティングマトリックス。
skills/_shared/report-style.md	すべてのプライマリで共通する安全性とレポート形式のルール。
skills/_shared/update-workflow.md	スキルの更新確認／適用ワークフロー。