sorin-skill

事前依存関係（Plugin Store CI によって自動挿入）

初回使用前に、セッションごとに一度実行してください。これらの確認により、必要なツールがインストールされていることを確認できます。

バージョン確認（自動挿入）

AI エージェントへの指示：このスキルのコマンドを実行する前に、このバージョン確認を実行してください。この確認は raw.githubusercontent.com から読み取り専用で取得するものであり、何もインストールしません。Update available と報告された場合は、必ず停止し、メッセージをそのままユーザーに提示してから、提案された npx skills add … コマンドを実行する明示的な許可を得てください。更新を黙って実行しないでください。更新が確認のうえ完了したら、先に進む前にこの SKILL.md をもう一度読み込んでください。

# Check for skill updates (1-hour cache).
# Network scope: this block calls raw.githubusercontent.com for the version probe only.
# It does NOT install anything; install requires user-confirmed `npx skills add` below.
UPDATE_CACHE="$HOME/.plugin-store/update-cache/sorin-skill"
CACHE_MAX=3600
LOCAL_VER="1.0.1"
DO_CHECK=true

if [ -f "$UPDATE_CACHE" ]; then
  CACHE_MOD=$(stat -f %m "$UPDATE_CACHE" 2>/dev/null || stat -c %Y "$UPDATE_CACHE" 2>/dev/null || echo 0)
  NOW=$(date +%s)
  AGE=$(( NOW - CACHE_MOD ))
  [ "$AGE" -lt "$CACHE_MAX" ] && DO_CHECK=false
fi

if [ "$DO_CHECK" = true ]; then
  REMOTE_VER=$(curl -sf --max-time 3 "https://raw.githubusercontent.com/okx/plugin-store/main/skills/sorin-skill/plugin.yaml" | grep '^version' | head -1 | tr -d '"' | awk '{print $2}')
  if [ -n "$REMOTE_VER" ]; then
    mkdir -p "$HOME/.plugin-store/update-cache"
    echo "$REMOTE_VER" > "$UPDATE_CACHE"
  fi
fi

REMOTE_VER=$(cat "$UPDATE_CACHE" 2>/dev/null || echo "$LOCAL_VER")
if [ "$REMOTE_VER" != "$LOCAL_VER" ]; then
  echo "Update available: sorin-skill v$LOCAL_VER -> v$REMOTE_VER."
  echo "ACTION REQUIRED: ask the user to confirm before running:"
  echo "  npx skills add okx/plugin-store --skill sorin-skill --global"
  echo "(This contacts the npm registry and github.com/okx/plugin-store and overwrites this skill. Do NOT auto-run.)"
fi

---

Sorin スキル

概要

Sorin スキルは、Sahara の Sorin DeFi AI Services Gateway を通じて、トークン、プール、チェーン、プロトコル、プロジェクトに関する暗号資産関連の質問への回答を支援します。 ユーザーの意図を特定し、最も関連性の高いゲートウェイエンドポイントを選択して、前提条件とリスクを含む簡潔でデータに基づいた分析を返します。

ゲートウェイ

• ベース URL：https://defi-tools-proxy.saharaa.info
• API キーの環境変数：DEFI_TOOLS_API_KEY
• 認証ヘッダー：Authorization: Bearer ${DEFI_TOOLS_API_KEY}
• Accept ヘッダー：accept: text/plain

デフォルトのリクエストテンプレート：

GET https://defi-tools-proxy.saharaa.info/<path>?<query>
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

プール分析の例：

GET https://defi-tools-proxy.saharaa.info/pool/analysis?chain=Ethereum
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

クイックスタート

1. sorin-skill quickstart を実行します。
2. エージェントのランタイムで DEFI_TOOLS_API_KEY が設定されていることを確認します。
3. プール分析の例を使って、ゲートウェイへの接続を確認します。
4. 成功した場合は、Sorin スキルの準備が整ったことを伝え、トークン、プール、チェーン、プロトコル、プロジェクトの分析プロンプトを提案します。
5. 失敗した場合は、ゲートウェイのステータスと正確なエラーメッセージを返します。

意図の振り分け

1. 自然言語からユーザーの意図を検出します。
2. まず主要な API を 1 つだけ選択します（必要な場合に限り、二次 API を追加します）。
3. 必須の入力を検証します。不足している場合は、必要最小限の追加質問のみを行います。
4. API を呼び出し、success、data、error を解析します。

意図 -> API の対応付け

1) トークンの基礎情報／価格／保有者／テクニカル指標

• API：tokenTool
• 使用する場面：ユーザーがトークンの市場分析（マクロの流動性とミクロの市場構造）を求めている場合。
• 入力：
  • token_symbol（必須）：トークンのシンボル。例：BTC、ETH
  • quote_currency（任意、デフォルトは USDT）：ペアのクオート通貨
• リクエスト：

GET https://defi-tools-proxy.saharaa.info/token/analysis?token_symbol=ETH&quote_currency=USDT
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

2) 利回り／ステーキングプールの検出とスコアリング

• API：poolTool
• 使用する場面：ユーザーがステーキング先、最良の APY プール、プールの比較、TVL／APY の傾向を尋ねている場合。
• 入力（すべて任意のフィルター）：
  • chain（任意）：チェーン ID 文字列。例：1、56
  • project（任意）：プロジェクトのスラッグ。例：lido、aave-v3
  • protocol（例：lido、aave-v3）
  • token_symbol（例：ETH、USDC）
  • pool_id（任意）：一意のプール識別子
  • pool_category（任意）：プールカテゴリのフィルター
• リクエスト：

GET https://defi-tools-proxy.saharaa.info/pool/analysis?chain=Ethereum&protocol=lido&token_symbol=ETH
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

3) チェーンレベルの DEX と TVL の概況

• API：chainTool
• 使用する場面：ユーザーがチェーン上の DEX 取引量の傾向、TVL の変化、プロトコルの優位性を尋ねている場合。
• 入力（任意。可能であればいずれかを指定）：
  • chainId（整数）：チェーン ID。例：1
  • chainName（文字列）：チェーン名。例：Ethereum
• リクエスト：

GET https://defi-tools-proxy.saharaa.info/chain/analysis?chainName=Ethereum
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

4) プロトコルレベルの財務分析

• API：protocolTool
• 使用する場面：ユーザーがプロトコルの TVL／手数料／収益／資金フローや包括的な指標を求めている場合。
• リクエスト：

GET https://defi-tools-proxy.saharaa.info/protocol/analysis?protocol=aave
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

5) 予測市場とプロジェクトの見通し

• API：projectTool
• 使用する場面：ユーザーがプロジェクトのオッズ、FDV の予想、短期／長期の目標価格、プロジェクトの市場センチメントを尋ねている場合。
• 入力：
  • projectName（必須）：プロジェクト名。例：berachain
• リクエスト：

GET https://defi-tools-proxy.saharaa.info/project/analysis?projectName=berachain
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

エンドユーザー向けの出力スタイル

次の構成で回答します。

1. 照会した内容：API 名と主要なパラメーター。
2. 主な調査結果：指標を含む 3～5 個の箇条書き。
3. 解釈：傾向／リスク／機会を平易な言葉で説明します。
4. 次に取れる具体的なアクション：具体的なフォローアップを 1 つ。
5. 信頼度と注意点：欠落しているフィールド、古いデータ期間、流動性の低さによる影響。

判断のヒューリスティック

• 質問が特定のアセットに関する場合は、tokenTool から始めます。
• 質問が利回りに焦点を当てている場合は、poolTool から始めます。
• 質問がチェーンのエコシステムに焦点を当てている場合は、chainTool を使用します。
• 質問がプロトコルの財務健全性に焦点を当てている場合は、protocolTool を使用します。
• 質問がプロジェクトの概要やバリュエーションに焦点を当てている場合は、projectTool を使用します。

安全ルール

• 価格、保有者、APY、TVL、トランザクションの結果を決して捏造しないでください。
• API が失敗を返した場合は、正確な理由を示し、再試行方法を 1 つ提案してください。
• 必須パラメーターが不足している場合に限り、追加の質問をしてください。
• あいまいさがある場合は、チェーン ID を明示してください。