Wallet Skills
ukey-wallet-skills 为 AI 编码助手提供 UKey Wallet 钱包能力层。用户通过自然语言提出需求，skills 负责选择更合适的安全路由、在必要时读取实时 schema，并将结果整理成更易理解的说明。
用户不需要手动编写 CLI 命令，CLI 仅作为 skill pack 背后的实现细节存在。
先安装
| Client | 安装路径 |
|---|---|
| Claude Code | 先执行 /plugin marketplace add UKeyHQ/ukey-wallet-skills，再执行 /plugin install ukey-wallet-skills |
| Codex | 按 UKey Wallet skills 安装说明接入 |
| Cursor | 克隆 UKey Wallet skills 仓库，并把 Cursor 指向 plugin 目录 |
| OpenCode / OpenClaw | 按 skills 仓库中的对应说明接入 |
安装完成后，可以先试下面这些 Prompt：
Show my wallet balance and receiving address.
What Solana tokens are trending right now?
Quote 1 ETH to USDC. Do not execute yet.
Is this token safe before I buy it?
Skill Router
| Skill | 适用请求 | 示例 Prompt |
|---|---|---|
ukey-wallet | 登录、活动钱包、余额、收款地址、历史、转账、BTC / SOL 钱包操作、硬件发现 | Show my wallet balance and receiving address. |
ukey-swap | Swap、buy、sell、convert、bridge、swap status、BTC sign-only PSBT | Swap 1 ETH to USDC, but show me the quote first. |
ukey-market | 价格、Token 搜索、trending、K 线、流动性、持仓、BTC / SOL 指标、研究 | What Solana tokens are trending right now? |
ukey-security | Token audit、交易模拟、授权风险、硬件安全、secret-safety 检查 | Is this token safe before I buy it? |
Schema 契约
每个 skill 都应把实时 CLI schema 当作事实来源，而不是依赖已经过期的硬编码示例。
| 检查项 | 预期行为 |
|---|---|
| 发现能力 | 当能力支持情况不明确时，先检查命令列表 |
| 选择参数 | 选择复杂字段前，先核对具体命令 schema |
| 名称映射正确 | 区分 schema 命令名和面向用户的命令族 |
| 处理不支持字段 | 当前 schema 没有暴露所需字段时，停止并说明原因 |
| 保持结构化输出 | 优先输出 result、risk、route、next step，不要直接把原始终端输出展示给用户 |
Wallet
ukey-wallet 主要用于处理 UKey Wallet 的钱包状态、收款地址、转账、BTC 地址类型和硬件会话。
| 自然语言 | Skill 应该做什么 |
|---|---|
Connect my UKey Wallet. | 通过 App Transfer 完成配对，并总结当前活动钱包 |
What wallet am I using? | 展示登录方式、钱包类型、地址，以及当前设备状态 |
Show my balance. | 自动使用当前活动钱包，不要求用户额外粘贴地址 |
Receive BTC. | 返回 BTC 收款地址；如果缺少地址类型，仅补问地址类型 |
Send 0.2 SOL to this address. | 保留 Solana 上下文，校验地址格式，并进入确认流程 |
Swap
ukey-swap 主要用于处理 UKey Wallet 的交易、买入、卖出、兑换、跨链和 BTC sign-only 流程。
| 自然语言 | Skill 应该做什么 |
|---|---|
Swap 1 ETH to USDC. | 先返回报价，展示 route 和 risk，再在执行前请求确认 |
Buy $200 of PEPE on Ethereum. | 保留 Ethereum 上下文，先审计 Token，再进入交易确认 |
Bridge 500 USDC from Ethereum to Base. | 先检查 bridge 支持，再进入报价流程 |
Swap 0.01 BTC to USDC using taproot and sign only. | 保留 taproot，并返回 signed 或 preview PSBT，而不是直接广播 |
Yes, confirm the swap. | 只执行已经审核确认过的订单 |
Market
ukey-market 用于 UKey Wallet 的只读行情和研究能力。
| 自然语言 | Skill 应该做什么 |
|---|---|
What is the BTC price? | 先返回价格和 24h change，再补充图表或趋势 follow-up |
What tokens are trending right now? | 返回简短的 trending 列表，不直接进入交易流程 |
Search BONK on Solana. | 保留 Solana 上下文，并把标识符解释为 SPL Token 或 mint |
Show ETH liquidity. | 返回流动性或持仓相关视图 |
Give me a quick ETH analysis. | 提供 bias、catalyst、risk 和一个 next step |
Market 类回答默认应保持只读。买入或兑换请求应进入独立的确认流程。
Security
ukey-security 用于 UKey Wallet 的风险检查和操作前保护。
| 自然语言 | Skill 应该做什么 |
|---|---|
Is this token safe? | 运行 Token audit，并报告风险等级和原因 |
Simulate approving this contract for all my USDC. | 进行模拟，并明确提示 unlimited approval 风险 |
Send SOL to 0x... | 因 Solana / EVM 地址不匹配而停止 |
Show me the App Transfer payload. | 拒绝暴露 secret，改为返回活动会话摘要 |
Is my hardware wallet safe to use? | 结合 device / auth status 和验证结果判断，绝不要求助记词 |
回答形态
好的 skill 回答应尽量简洁，并且结果优先：
Route: swap-quote
Fields: chain=eth, from=ETH, to=USDC, amount=1
Quote: 1 ETH -> <estimated USDC>
Risk: <audit or simulation state>
Next: I can build the transaction and ask for confirmation.
涉及资金移动的回答应以确认问题结束。只读的 wallet 和 market 回答则应给出有用的 follow-up，而不是直接把用户引向交易。