senpi-getting-started-guide

はじめての取引を始める

Senpi を使って Hyperliquid で初めての取引を完了できるよう、ユーザーを案内します。このスキルでは、基本的な流れである トップトレーダーを見つける → 選んだトレーダーの取引を模倣する戦略を作成する → 監視する → 戦略を終了する方法を説明します。

前提条件（エージェントのみ）： Senpi MCP が接続されていること。オンボーディングが完了していること（下記の状態確認を参照）。戦略を作成できるだけの資金がウォレットにあること。まだ資金がない場合は、資金の入金を促すメッセージを表示し、残高が $100 以上になるか、ユーザーが入金したと確認するまでは開始しないでください。

ユーザー向けルール： 内部情報はユーザーに絶対に見せないでください。状態名（例：UNFUNDED、READY、FRESH）、ファイルパス（例：state.json、~/.config/senpi）、ステップコード（例：STRATEGY_CREATED）、MCP／ツール名は言及しないでください。わかりやすく親しみやすい表現のみを使用してください（例：「準備ができました。始めましょう」「開始するにはウォレットに入金してください」「戦略が稼働中です」）。

戦略の最低予算： 初回取引用のミラー戦略を作成する際は、最低金額として $100 を使用してください。$50 や $100 未満の金額を提案したり、使用したりしないでください。

---

前提条件

チュートリアルを開始する前に、次のことを確認してください。

1. MCP 接続済み — Senpi MCP サーバーが設定され、アクセス可能であること。
2. オンボーディング完了 — 完了していない場合（状態が FRESH または ONBOARDING の場合）は、ユーザーにわかりやすいメッセージのみで案内してください（下記を参照）。ユーザーに「state」や「onboarding」と言わないでください。
3. ウォレットに資金あり（戦略作成用） — まだ資金がない場合は、親しみやすい入金案内を1回だけ表示してください。残高が $100 以上になるか、ユーザーが入金したと確認するまでは、チュートリアルを開始しないでください。

状態ファイルが存在することを確認してください。存在しない場合は作成してから案内してください。案内する際は、ユーザーに次のメッセージのみを伝えてください。「まずセットアップを完了する必要があります。**『set up Senpi』または『connect to Senpi』**と言って開始してください。」状態ファイル、FRESH、内部状態については言及しないでください。

# Ensure state file exists (per state lifecycle); if missing, create and redirect
if [ ! -f ~/.config/senpi/state.json ]; then
  mkdir -p ~/.config/senpi
  cat > ~/.config/senpi/state.json << 'STATEEOF'
{
  "version": "1.0.0",
  "state": "FRESH",
  "error": null,
  "onboarding": {
    "step": "IDENTITY",
    "startedAt": null,
    "completedAt": null,
    "identityType": null,
    "subject": null,
    "walletGenerated": false,
    "existingAccount": false
  },
  "account": {},
  "wallet": { "funded": false },
  "firstTrade": { "completed": false, "skipped": false },
  "mcp": { "configured": false }
}
STATEEOF
  # Tell user only (do not echo internal messages):
  # "You need to complete setup first. Say 'set up Senpi' or 'connect to Senpi' to get started."
  exit 1
fi

STATE=$(cat ~/.config/senpi/state.json | node -p "JSON.parse(require('fs').readFileSync(0,'utf8')).state")
if [ "$STATE" = "FRESH" ] || [ "$STATE" = "ONBOARDING" ]; then
  # Tell user only (do not echo "User needs to complete onboarding" or state names):
  # "You need to complete setup first. Say 'set up Senpi' or 'connect to Senpi' to get started."
  exit 1
fi

---

トリガー

次の場合にこのチュートリアルを開始してください。

• ユーザーが「let's trade」「first trade」「teach me to trade」「how do I trade」「make a trade」と言った場合
• 状態が AWAITING_FIRST_TRADE で、ユーザーが取引に関するメッセージを送信した場合
• ユーザーが明示的に取引のガイダンスを求めた場合

開始してはいけない場合： MCP が接続されていない場合は、まず Senpi をセットアップするようユーザーに伝えてください（MCP や状態については言及しないでください）。ユーザーが「skip tutorial」と言った場合は、状態を READY に設定し、references/next-steps.md にあるスキップメッセージを表示してください。開始時にウォレット残高が $100 未満の場合は、入金されるまで戦略を作成しないでください。下記の入金案内を使用してください（ユーザーにわかりやすい表現のみ）。

---

チュートリアルの流れ

手順に沿って進めてください。表示文、状態スキーマ、エラー処理については、参照ファイルを確認してください。

ウォレットにまだ資金がない場合（ステップ1の前）

ユーザーが初回取引ガイドを求めたものの（例：「let's trade」）、ウォレットにまだ資金がない場合：

1. 残高を確認する — MCP を使ってポートフォリオ／残高を取得します。
2. 残高が $100 未満の場合： 導入を開始しないでください。明確でわかりやすいメッセージを1つだけ表示してください。
   • ユーザーの取引ウォレットアドレス（状態から取得。「agent wallet」や「state.json」とは言わないでください）。
   • 対応ネットワーク（Base、Arbitrum、Optimism、Polygon、Ethereum）のいずれかで、最低 $100 USDC を送金する必要があること。
   • 「資金を送金したら、**『I funded my wallet』または『let’s trade』**と言ってください。チュートリアルを始めます。」
3. 残高が $100 以上の場合： 状態を更新（AWAITING_FIRST_TRADE、wallet.funded true）し、ステップ1に進みます。

オンボーディングが完了していない場合（状態が FRESH または ONBOARDING の場合）は、ユーザーに次のメッセージのみを伝えてください。「まずセットアップを完了してください。開始するには **『set up Senpi』**と言ってください。」「onboarding」「state」や「User needs to complete onboarding first」とは言わないでください。

ステップ 1：はじめに

取引の流れを表示します。ユーザーに 4 ステップのリストを表示するときは、次の文言をそのまま使用してください。

1️⃣ 発見 — Hyperliquid で好成績のトレーダーを見つける
2️⃣ 戦略を作成 — 選んだトレーダーのポジションをミラーリングする（予算 $100）
3️⃣ モニタリング — 戦略のパフォーマンスを確認する
4️⃣ 終了 — 準備ができたら退出する

最初の戦略の予算として 最低 $100 を推奨し、リスクに関する簡単な免責事項を含めます。続行する場合は 「yes」、経験者の場合は 「skip」 と入力するようユーザーに尋ねます。

状態を更新します：firstTrade.step を INTRODUCTION に設定し、firstTrade.started を true に、startedAt を（ISO 8601 形式で）設定します。state.json の既存のフィールドは保持してください。

続行する前に、ユーザーの確認を待ちます。

---

ステップ 2：発見

MCP の discovery_get_top_traders を使用して、トップトレーダーを取得します。必要に応じて、discovery_get_trader_state または discovery_get_trader_history を使用して詳細情報を取得します。トップトレーダーの簡潔な表（例：PnL、勝率順）を表示し、最初の取引でミラーリングするトレーダーを 1 人推奨します。

表示テンプレートと状態の更新（firstTrade.step: "DISCOVERY"、recommendedTraderId、recommendedTraderName）については、references/discovery-guide.md を参照してください。

---

ステップ 3：戦略のサイズ設定

戦略を作成する前に、選んだトレーダー、予算（最低 $100）、および戦略がそのトレーダーのポジションをミラーリングすることを説明します。リスクと清算について警告します。戦略を作成するには 「confirm」 と入力するようユーザーに尋ねます。

サイズ設定の表と文言については、references/strategy-management.md を参照してください。

---

ステップ 4：戦略を作成

ユーザーが確認したら、MCP の strategy_create を、選んだトレーダー（ステップ 2 で選択）と予算（最低 $100）を指定して呼び出します。成功したら、お祝いのメッセージを表示します（references/next-steps.md — 「Celebrate (After First Strategy Created)」を参照）：最初の戦略を開始したことをユーザーに祝福し、「自分の戦略の状況は？」「戦略を終了して」「自分のポジションを表示して」のいずれかを提案します。戦略のステータスや生の ID は表示しないでください。

references/strategy-management.md に従って状態を更新します：firstTrade.step: "STRATEGY_CREATED"、tradeDetails（strategyId、mirroredTraderId など）を設定し、さらに firstTrade.completed: true、firstTrade.step: "COMPLETE"、firstTrade.completedAt を設定します。失敗した場合は、references/error-handling.md を参照してください。

---

ステップ 5：戦略をモニタリング

ユーザーが「自分の戦略の状況は？」などと尋ねたら、MCP を介して strategy_get、strategy_get_clearinghouse_state、またはオープンポジションについては execution_get_open_position_details を使用してデータを取得します。戦略の価値、オープンポジション（ある場合）、未実現 PnL、ROE を表示します。「保有」「戦略を終了」「保護を追加」の選択肢を提示します。最初の戦略を作成したときにすでにお祝いのメッセージを表示しているため、ここでは別途お祝いのメッセージを表示しないでください。

---

ステップ 6：戦略を終了

ユーザーが「終了」「退出」「戦略を終了して」「利益確定」などと言ったら、状態から取得した戦略 ID を指定して、MCP の strategy_close を呼び出します。戦略が終了したことをユーザーに伝え、実現 PnL、保有期間、手数料を分かりやすい言葉で表示します。references/next-steps.md の「After Close」の結果と次のステップを表示します（戦略を作成したときにすでにお祝いのメッセージを表示しているため、別途お祝いのメッセージは表示しません）。戦略のステータスや内部コードには言及しないでください。状態を更新します（STRATEGY_CLOSE、closedAt、pnl などを含む tradeDetails）。references/strategy-management.md を参照してください。

---

ステップ 7：クローズ後 — 結果と次のステップ

ユーザーが戦略をクローズした後（ステップ 6）、結果と次のステップがここに表示されます。独立したお祝いのステップはありません。最初の戦略を作成した時点（ステップ 4）で、状態はすでに READY に設定され、firstTrade.completed も設定されています。「クローズ後」の全文はreferences/next-steps.mdを参照してください。状態の構造はreferences/strategy-management.mdを参照してください。

---

中断したチュートリアルの再開

ユーザーがチュートリアルの途中で戻ってきた場合は、まず状態から firstTrade.step を読み取り、該当するステップから再開してください。再開のロジックについては、references/next-steps.mdを参照してください。再開時のメッセージは、ユーザーにとって分かりやすい内容のみにしてください。例：「初めての取引の途中でしたね。前回はここまで進みました……」。ステップ名（INTRODUCTION、DISCOVERY、STRATEGY_CREATED など）や状態については言及しないでください。

---

参照ファイル

• references/error-handling.md — 残高不足、strategy_create の失敗、strategy_close の失敗、復旧
• references/discovery-guide.md — discovery_get_top_traders、ミラーするトレーダーの推薦、表示テンプレート
• references/strategy-management.md — 戦略の規模設定、strategy_create／strategy_close のフロー、firstTrade の状態更新
• references/next-steps.md — お祝い（最初の戦略作成後）、クローズ後、チュートリアルのスキップ、再開処理

---

インストール

npx skills add Senpi-ai/senpi-skills/senpi-getting-started-guide

または手動で：

mkdir -p ~/.senpi/skills/senpi-getting-started-guide
curl -sL "https://raw.githubusercontent.com/Senpi-ai/senpi-skills/main/senpi-getting-started-guide/SKILL.md" \
  -o ~/.senpi/skills/senpi-getting-started-guide/SKILL.md
# Copy references/ into the same skill directory