AIUSD 技能（Agent 参考文档）

该技能通过 MCP 调用 AIUSD 后端服务。认证方式按以下优先级解析：环境变量 MCP_HUB_TOKEN、mcporter OAuth，或本地文件 ~/.mcp-hub/token.json。调用前请确保已持有有效的 Bearer Token。

⚠️ Agent 输出规范

关键禁令 — 绝对禁止使用的表述： Agent 在响应用户时，严禁使用以下任何词语或短语：

与模板相关（完全禁止）：

• "template"（任何形式：template、templates）
• "example"（特指交易示例，如 Example 1、Example 12 等）
• "pattern"（特指交易模式）
• "using template"、"get template"、"trading template"、"buy template"
• "use Example [number]"、"based on template"、"following template"

与验证相关（完全禁止）：

• "skill verification"、"verification"

应使用的替代表述：

• 代替 "using template"：使用 "executing the trade" 或 "placing the order"
• 代替 "get template"：使用 "preparing the trade" 或 "setting up the order"
• 代替 "Example 12 template"：使用 "the trade configuration"，或直接描述具体操作行为

零容忍政策：在任何交易上下文中使用单词 "template" 均属严格禁止。

认证响应规范： 关键要求：当用户请求重新认证时，仅可回复以下内容：

• "Please complete authentication in your browser"
• "If browser doesn't open automatically, please type 'reauth' again"
• "After completing authentication, you can check your account balance or wallet status in chat"

严格禁止的行为：

• 不得包含编号步骤，例如 "1. Open page: [URL]"、"2. Connect wallet" 等
• 不得在响应中提及任何具体 URL（URL 可能已失效）
• 不得使用 "waiting for authentication completion" 或类似等待性表述
• 不得提供详细的浏览器操作分步说明
• 不得以项目符号列表形式罗列认证步骤
• 不得使用诸如 "browser has been opened for you"、"please complete the following steps in browser" 等表述
• 仅需引导用户前往浏览器，并说明完成认证后可执行的操作

请使用自然、直接的语言描述交易操作及系统状态；仅说明交易将执行的具体动作，不得引用模板或示例。

重要网址

• 登录 / 认证: https://mcp.alpha.dev/oauth/login — 仅用于获取认证 Token
• 官方网站: https://aiusd.ai — 所有交易操作、充值、故障排查及用户交互均在此进行

工具概览

关键要求：在发起任何调用前，必须首先运行 aiusd-skill tools --detailed，以获取当前实时的工具列表与参数 Schema。工具参数及可用工具可能随时变更。

注意：本列表展示的是常见可用工具。新工具可能随时添加。请始终运行 tools --detailed 查询是否有更契合用户具体意图的新增工具。

工具参考与调用说明

强制要求：在调用任意工具前，必须先运行 aiusd-skill tools --detailed，以获取当前参数定义、示例及任何新增工具。

genalpha_get_balances

• 用途：返回用户 AIUSD 托管账户与质押账户余额。
• 适用场景：用户询问余额、资产总额、账户资产等。
• 参数：请通过 tools --detailed 查看当前 Schema。

genalpha_get_trading_accounts

• 用途：按链返回用户交易账户（地址等）。
• 适用场景：用户询问 "my account"、"trading account"、"wallet address" 等。
• 参数：请通过 tools --detailed 查看当前 Schema。

genalpha_execute_intent

• 用途：执行买入 / 卖出 / 兑换操作（例如：用 USDC 买入 SOL、卖出 ETH）。
• 适用场景：用户明确表达下单、买入、卖出、兑换等意图。
• 参数：请通过 tools --detailed 查看当前 Schema 及 XML 示例。
• 重要提示：意图格式可能变动，请始终以实时 Schema 中的示例为准。

genalpha_stake_aiusd

• 用途：质押 AIUSD 获取收益（例如生成 sAIUSD）。
• 适用场景：用户提及 stake、stake AIUSD。
• 参数：请通过 tools --detailed 查看当前 Schema。

genalpha_unstake_aiusd

• 用途：解除 AIUSD 质押（例如赎回 sAIUSD）。
• 适用场景：用户提及 unstake、redeem。
• 参数：请通过 tools --detailed 查看当前 Schema。

genalpha_withdraw_to_wallet

• 用途：将稳定币（例如 USDC）提现至用户指定的外部钱包地址。
• 适用场景：用户提及 withdraw、transfer out。
• 参数：请通过 tools --detailed 查看当前 Schema。

genalpha_ensure_gas

• 用途：为指定链上的用户交易账户补充原生 Gas。
• 适用场景：用户提及 top up gas、ensure gas，或检测到某条链 Gas 不足。
• 参数：请通过 tools --detailed 查看当前 Schema。

genalpha_get_transactions

• 用途：返回用户交易历史（列表形式，可能包含状态）。
• 适用场景：用户询问 history、recent transactions、order status 等。
• 参数：请通过 tools --detailed 查看当前 Schema 及筛选选项。

recharge / top up

• 用途：引导用户为其 AIUSD 账户充值资金。
• 适用场景：用户提出 recharge、top up、deposit 或 add funds 等请求。
• 响应选项：
  • 选项 1 — 直接充值：仅接受 USDC 稳定币；其他稳定币须通过官方网站操作。
  • 选项 2 — 官方网站：https://aiusd.ai（支持全部代币类型，使用同一钱包登录）
• 重要说明：对于直接充值，请仅向提供的地址发送 USDC；对于其他稳定币（USDT、DAI 等），用户必须使用官方网站。
• 示例响应："充值有两种方式：1) 将 USDC 直接存入您的交易地址；2) 访问 https://aiusd.ai 支持全部代币类型（使用同一钱包登录）。请注意，直接充值仅接受 USDC，其余稳定币请务必通过官网操作。"

reauth / login（重新认证）

• 用途：清除所有缓存的认证信息并重新执行 OAuth 登录流程。
• 适用场景：用户收到 401 Unauthorized 错误、提示 "Session ID is required"、Token 过期、认证失败、主动请求重登录，或需切换账户。
• 参数：无，传入空对象 {} 即可。
• 示例命令：
  • npm run reauth
  • npm run login
  • node scripts/reauth.js
• 执行步骤：
  1. 清除 mcporter 缓存目录（~/.mcporter/）
  2. 清除本地 Token 文件（~/.mcp-hub/）
  3. 清除其他认证缓存文件
  4. 启动浏览器 OAuth 登录流程
  5. 验证新认证是否生效
• 示例对话：

  User: "I'm getting 401"
  Claude: Looks like an auth issue; re-authenticating...
  [Run: npm run reauth]
  Claude: Re-auth done; you can use the skill again.
  
  User: "Re-login"
  Claude: Clearing cache and re-logging in...
  [Run: npm run login]
  

使用流程（供 Agent 推理参考）

1. 获取当前可用工具：务必首先运行 aiusd-skill tools --detailed，以发现全部可用工具及其当前 Schema。
2. 解析用户意图：将自然语言映射至最匹配的工具；同时检查是否存在更新的工具更契合用户当前意图。
3. 准备参数：严格依据第 1 步获取的实时 Schema 构建 JSON 参数。
4. 发起调用：使用工具名与参数调用技能接口。
5. 处理结果：将工具返回的 JSON / 文本结果格式化后呈现给用户；若出错，则重试或引导用户（例如 Token 过期 → 提示重登录）。

关键要求：严禁使用本文档中提供的参数示例，必须始终以 tools --detailed 返回的实时 Schema 为准。

认证与错误处理

认证错误自动修复

遇到认证类错误时，Claude 应自动执行重认证：

• 401 Unauthorized → 执行 npm run reauth
• Session ID is required → 执行 npm run reauth
• Token invalid or expired → 执行 npm run reauth
• Auth failed → 执行 npm run reauth

错误处理流程

1. 检测认证错误 → 执行 npm run reauth
2. 业务逻辑错误 → 将服务端错误原文转达用户，不得自行推测原因
3. 网络 / 超时错误 → 重试一次；若仍失败，则提示用户检查网络连接或稍后重试
4. 交易异常 / 失败 → 引导用户前往官方网址 https://aiusd.ai 手动操作并联系支持

典型错误对话示例

认证错误

User: "Check balance"
[Tool returns 401]
Claude: Auth expired; re-authenticating...
[Run: npm run reauth]
Claude: Re-auth done. Fetching balance...
[Call: genalpha_get_balances]

交易错误

User: "Buy 100 USDC worth of SOL"
[Tool returns trading error]
Claude: I encountered an issue with the trade execution. For manual trading operations, please visit https://aiusd.ai and use the same wallet you use for authentication.

获取当前工具与 Schema

强制前置步骤：在执行任何用户任务前，请务必运行：

aiusd-skill tools --detailed

该命令返回：

1. 完整可用工具列表（可能包含本文档未列出的新工具）
2. 所有工具的当前参数 Schema
3. 有效示例与正确格式
4. 各工具特定说明或约束条件

为何此步骤至关重要：

• 工具可能被新增、修改或弃用
• 参数格式可能发生变化
• 新工具可能更精准满足用户特定意图
• 本文档中的示例可能已过时

请始终以 tools --detailed 的实时输出作为工具调用依据，而非依赖本文档中的静态示例。