senpi-getting-started-guide

入门：完成你的第一笔交易

引导用户通过 Senpi 在 Hyperliquid 上完成第一笔完整交易。此技能将介绍核心流程：发现顶尖交易者 → 创建策略，跟随选定的交易者进行交易 → 监控 → 关闭策略。

**前提条件（仅限 Agent）：**已连接 Senpi MCP。已完成设置（见下方状态检查）。钱包中有足够资金用于创建策略；如果尚未充值，请显示充值提醒，在余额达到 ≥ $100 或用户确认已充值前，不要开始。

**面向用户的规则：**绝不向用户展示内部详情。不要提及状态名称（例如 UNFUNDED、READY、FRESH）、文件路径（例如 state.json、~/.config/senpi）、步骤代码（例如 STRATEGY_CREATED）或 MCP／工具名称。只使用简单、友好的语言（例如“你已准备就绪，可以开始了”“为钱包充值后即可开始”“你的策略正在运行”）。

**策略最低预算：**创建首个跟单策略时，最低金额为 $100。不要建议或使用 $50 或任何低于 $100 的金额。

---

前提条件

开始教程前，请确认：

1. 已连接 MCP — Senpi MCP 服务已配置且可访问。
2. 已完成设置 — 如果尚未完成（状态为 FRESH 或 ONBOARDING），请仅使用友好的消息引导用户（见下文）。不要向用户提及“状态”或“设置”。
3. 钱包已充值（用于创建策略） — 如果尚未充值，只显示一条友好的充值提醒；在余额达到 ≥ $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：不要开始介绍。只显示一条清晰、友好的消息：
   • 提供用户的交易钱包地址（从状态中获取；不要说“Agent 钱包”或“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’ 即可开始。”不要说“设置流程”“状态”或“用户需要先完成设置”。

步骤 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、胜率排序），并推荐一位交易者供用户镜像，作为首笔交易。

请参阅 references/discovery-guide.md 中的展示模板和状态更新（firstTrade.step: "DISCOVERY"、recommendedTraderId、recommendedTraderName）。

---

步骤 3：策略规模设定

创建策略之前，请说明：所选交易者、预算（至少为 $100），以及该策略将镜像该交易者的持仓。提醒用户注意风险和强制平仓的风险。请用户回复 “confirm” 以创建策略。

请参阅 references/strategy-management.md 中的规模设定表和措辞。

---

步骤 4：创建策略

用户确认后，使用所选交易者（来自步骤 2）和预算（至少 $100）调用 MCP strategy_create。成功后，展示庆祝内容（请参阅 references/next-steps.md — “庆祝（创建首个策略后）”）：祝贺用户开通首个策略，然后提供“我的策略怎么样了？”、“关闭我的策略”或“显示我的持仓”等选项。不要显示策略状态或原始 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。提供以下选项：持有、关闭策略或添加保护。此处不要单独显示祝贺内容——用户创建首个策略时（步骤 4）已经展示过。

---

步骤 6：关闭策略

当用户说“关闭”、“退出”、“关闭我的策略”、“获利了结”等时，使用状态中的策略 ID 调用 MCP strategy_close。告知用户策略已关闭，并以通俗语言展示已实现 PnL、持续时间和费用。展示 references/next-steps.md 中的“关闭后”结果和后续步骤（无需单独祝贺——用户创建策略时已经展示过）。不要提及策略状态或内部代码。更新状态（STRATEGY_CLOSE，tradeDetails 中包含 closedAt、pnl 等）。请参阅 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