gate-info-coincompare

gate-info-coincompare

一般ルール

⚠️ 停止 — 作業を進める前に、共有ランタイムルールを必ず読み、厳守してください。 すべてのルールを読むまで、ツールを選択または呼び出してはいけません。これらのルールが最優先です。 → gate-runtime-rules.md を読んでください。 → gate-info / gate-news 固有のルール（ツールの縮退、レポート基準、セキュリティ、ルーティングの縮退、scripts/ が存在する場合のスキルごとのバージョン確認、レガシーラッパーのルーティング）については、info-news-runtime-rules.md も読んでください。

• このスキルに明示的に記載されている MCP ツールのみを呼び出してください。ここに記載されていないツールは、MCP サーバーに存在していても呼び出してはいけません。
• レガシー／ルーティングモード： ステップ 0 で __FALLBACK__ が出力された場合は、このファイルに記載されている MCP ツールのみを使用してください。ステップ 0 で __ROUTE_CLI__ が出力された場合は、それらの MCP ツールを呼び出さず、ステップ 0 に従って対応するプライマリスキルに処理を委譲してください。

横並び比較スキルです。ユーザーが 2～5 種類のコインを入力すると、システムは各コインについて市場スナップショットとファンダメンタルズのツールを並列に呼び出し、LLM が多次元データをまとめて、総合分析付きの比較表を作成します。

トリガーとなる状況：ユーザーが 2 種類以上のコインと、「比較」「対比」「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/ にあります（frontmatter の <name> と同じです）。

---

ステップ 0 — ラッパーのルーティング確認

このレガシースキルは、プライマリ CLI スキル gate-info-research の互換エイリアスです。

更新確認、MCP ツールの選択、またはレガシー実行ワークフローの前に、 決定論的なシェル確認を実行してください。

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／ブロッキング）： トリガーごとに、GATE_SKILL_UPDATE_MODE=autoを指定せず、まずcheckを実行します。スクリプトはローカルとリモートを比較するだけです。Result=update_availableの場合、ファイルは上書きされません。停止し、apply、run、またはスキルの実行を行う前に、ユーザーに更新するかどうかを確認してください。サンドボックス（Cursorなど）で後から**applyを実行する場合は、すべての権限を使用してください。これは、独立したスクリプトのTEST_REPORTにおけるブロッキング更新確認の仕様に合致します。ブロッキングは、サイレントな自動適用によるものではなく、これらのSKILLの指示とcheckのみ**の動作によって実現されます。

厳密なチェック（エージェント／IDE — check時に推奨）： GATE_SKILL_CHECK_STRICT=1を使用します。Result=update_availableの場合、checkは終了コード3で終了し、GATE_SKILL_CHECK_EXIT=3を出力します。停止するのはそのシェルステップだけです。厳守事項：ユーザーに確認を求めた後は、このアシスタントのターンを終了してください。同じメッセージ内で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>/。引数が1つの場合、SKILL.mdが存在すれば、スクリプトはこの順にDESTを解決します。それ以外の場合、DESTは‌scripts/../です。ワークスペース内のツリーのみを対象とする場合は、DESTを明示して、引数2つでcheck／apply**を実行する必要があります。

エージェントの選択ルール（以下のコード例は最大1つだけ実行し、OSと$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に従い、現在のバージョンで続行してください。技術的なチェック失敗の詳細をユーザーに伝えてはいけません。

エージェントによる解析（標準出力）： GATE_SKILL_UPDATE_AGENT_ACTION=…。**BLOCK_UNTIL_USER_CONFIRMS_UPDATEの場合は、実行前にステップ2へ進みます。CONTINUE_SKILL_EXECUTION**の場合、チェック用スクリプトによるブロックはありません。

ステップ 2 — 確認または拒否（ブロッキング）

ランタイム： ステップ 2 では、ステップ 1 と同じシェルファミリー（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 を実行してください。このフローでは、check と同じターンで apply を続けて実行しないでください。

   • ユーザーが同意 → 必要な場合は、厳格モードの check の標準出力にある GATE_SKILL_CONFIRM_TOKEN を指定して apply を実行し、その後、実行に進みます。
   • ユーザーが拒否 → revoke-pending を実行し、その後、現在のインストールで実行に進みます。

2 段階ゲート（厳格モードの check）： GATE_SKILL_UPDATE_MODE=auto を指定しない場合、GATE_SKILL_CONFIRM_TOKEN が .gate-skill-apply-token と一致するまで、apply / run は失敗します。ユーザーが拒否した場合は 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>/ と一致する必要があります。
• Invoke：このスキルの $SKILL_ROOT/SKILL.md がある場所を基準に、$SKILL_ROOT/scripts/update-skill.sh（または .ps1）を使用します。例：~/.cursor/skills/<name>、~/.codex/skills/<name>、~/.openclaw/skills/<name>、~/.agents/skills/<name>、~/.gemini/antigravity/skills/<name>。~/.cursor（または skills/<name>/SKILL.md を含まないホストのルートディレクトリ）をインストール先として扱わないでください。引数が 1 つの場合、スクリプトはその順序で $SKILL_ROOT を解決し、見つからない場合はスクリプトのディレクトリを使用します。ワークスペースへのインストールには DEST を明示的に指定する必要があります。2 引数の check / apply / revoke-pending： 正規の順序は、最初に絶対パスの DEST（スキルのルート）、次に name です。update-skill.sh / update-skill.ps1 は、正規化したパスのうち一方だけに SKILL.md が含まれる場合、自動的に順序を入れ替えます（例：エージェントが name、パスの順に渡した場合）。
• ClawHub とフルツリー： update-skill.ps1 がないインストールでは、gate/gate-skills の skills/<name>/scripts/ からコピーできます（手動のみ。エージェントは自動ダウンロードしないでください）。

デバッグ時を除き、生のスクリプトログをユーザー向けの返信に出力しないでください。厳格モードの check が exit 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 サーバーが利用可能になってから続行してください。

ルーティングルール

レガシーパスのみ — Step 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 はまだ利用できません — 比較する具体的なコインを挙げるようユーザーに促す

---

実行ワークフロー

レガシーパスのみ — このセクションは Step 0 で __FALLBACK__ が出力された場合に適用されます。

Step 1：意図の認識とパラメーターの抽出

ユーザーの入力から次の情報を抽出します。

• symbols[]：コインのリスト（2～5 件）。例：[BTC, ETH, SOL]
• ユーザーがプロジェクト名（例：Solana、Avalanche）を挙げた場合は、ティッカーシンボルに変換します
• ユーザーが具体的なコインを挙げずにセクターに言及した場合（例：「どの Layer2 コインが有望ですか」）、具体的なコインを2～5件挙げるよう促します

制限：最小2件、最大5件です。5件を超える場合は、対象を絞るようユーザーに促します。コインが1件のみの場合は、少なくとももう1件追加するよう依頼するか、gate-info-coinanalysis にルーティングします。

Step 2：コインごとに2つの MCP ツールを並列で呼び出す

リスト内の各 symbol について、次を並列で実行します。

Step	MCP ツール	パラメーター	取得データ	並列
1a	info_marketsnapshot_get_market_snapshot	symbol={symbol}, timeframe="1d", source="spot"	市場データ：リアルタイム価格、K 線サマリー、時価総額、FDV、Fear & Greed Index	はい
1b	info_coin_get_coin_info	query={symbol}	ファンダメンタルズ：プロジェクト情報、セクター、資金調達、トークノミクス	はい

3件のコインの場合、依存関係のないツール呼び出しを6件並列で実行します。info_marketsnapshot_batch_market_snapshot と info_coin_search_coins が利用可能になった場合は、そちらを優先してください。利用できない場合は、上記のコインごとの呼び出しを使用します。

Step 3（任意）：テクニカル比較

ユーザーがテクニカル比較を明示的に依頼した場合、またはコインの数が3件以下の場合は、任意で次を並列に呼び出します。

Step	MCP ツール	パラメーター	取得データ	並列
2	info_markettrend_get_technical_analysis	symbol={symbol}	テクニカルシグナル：RSI、MACD、MA の並び、サポート／レジスタンス	はい

Step 4：LLM による横断比較レポートの生成

すべてのツールの応答をコインごとにまとめ、LLM が以下のテンプレートを使用して横並びの比較レポートを生成します。

---

レポートテンプレート

レガシーパスのみ — このセクションは Step 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.

---

判定ロジック

条件	評価
コイン間の24時間変動率の差が10%超	「短期パフォーマンスに顕著な乖離あり」とフラグを付ける
あるコインの FDV／時価総額比率が他のコインの2倍超	「FDV が比較的高く、アンロックリスクが高い」とフラグを付ける
流通比率が30%未満	「流通比率が低く、将来的な売り圧力のリスクあり」とフラグを付ける
24時間の出来高／時価総額が1%未満	「流動性が低く、大口取引でスリッページのリスクあり」とフラグを付ける
RSI の差が30超（一方が買われ過ぎ、もう一方が売られ過ぎ）	「テクニカル指標が正反対の状態にあり、個別に評価してください」とフラグを付ける
いずれかのツールが空の結果またはエラーを返す	該当する列を「データなし」とし、残りのコインは通常どおり表示する
2つのコインがまったく異なるセクターに属する	ユーザーに「セクターをまたぐ比較は参考目的のみです。価値を左右する主な要因が大きく異なります」と注意を促す

エラー処理

エラーの種類	対応
コインが存在しない	名前が誤っている可能性があることを伝え、そのコインを除外して残りの比較を続けます
コインが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. 順位付けによる推奨をしない：「B ではなく A を買う」といった結論を出さず、データの違いのみを提示します
3. 価格を予測しない：具体的な目標価格や、価格の上昇・下落予測を出してはいけません
4. データの透明性を確保する：各項目のデータソースと更新時刻を明記します
5. データの欠落を明示する：いずれかの項目にデータがない場合は、「データを利用できません」と明記し、データを捏造してはいけません
6. セクター間の違いに関する注意喚起：比較対象のコインが異なるセクターに属する場合は、基本的な論理の違いをユーザーに伝えます