Agent Skills

Agent Skills 是一组独立的 Markdown 文件，用于教 AI 代理如何使用 toobit CLI 执行特定类别的任务。每个 Skill 提供上下文指令、命令示例和操作流程。

可用 Skills

Skill	描述	需要认证
toobit-cex-market	公开行情数据：价格、深度、K线、资金费率、持仓量、标记价格、指数价格	否
toobit-cex-trade	订单管理：现货和 USDT-M 永续合约，杠杆、保证金、止盈止损、闪电平仓	是
toobit-cex-portfolio	账户操作：余额、子账户、资金流水、充提币、API Key 检查	是

安装

通过 Skills 协议 CLI 安装：

npx skills add toobit-docs/agent-skills

该命令会从 GitHub 仓库 下载 Skill 文件，供 AI 代理使用。

前置要求

• 安装 toobit CLI：

npm install -g toobit-trade-cli

• 使用 toobit-cex-trade 和 toobit-cex-portfolio 需要在 ~/.toobit/config.toml 中配置 API 凭证

工作原理

1. AI 代理接收用户请求（例如："BTC 现在多少钱？"）
2. 根据 Skill 的 description 字段，代理将请求路由到合适的 Skill
3. 代理读取 Skill 文档并按照命令示例执行
4. 通过 toobit CLI 执行命令并将结果返回给用户

Skill 格式

每个 Skill 是一个带有 YAML 头部的 Markdown 文件：

---
name: skill-name
description: "AI 代理路由系统的触发描述。"
license: MIT
metadata:
  author: toobit
  version: "1.0.0"
  agent:
    requires:
      bins: ["toobit"]
---

description 字段列举了该 Skill 处理的自然语言短语和场景，使 AI 代理能够准确路由。

Skill 详情

toobit-cex-market

只读行情数据查询，无需 API 凭证。

功能：

• 实时行情价格（现货和合约）
• 订单簿 / 市场深度
• K线（OHLCV）数据
• 资金费率
• 持仓量
• 标记价格 / 指数价格
• 最近成交
• 多空比
• 交易所信息和可用交易对

toobit-cex-trade

现货和 USDT-M 永续合约订单管理，需要具有交易权限的 API 凭证。

功能：

• 现货下单 / 撤单 / 改单（限价、市价）
• 合约下单 / 撤单 / 改单
• 设置杠杆和保证金模式
• 止盈 / 止损
• 闪电平仓 / 反向开仓
• 查询订单状态、成交历史

toobit-cex-portfolio

账户和资产管理，需要 API 凭证。

功能：

• 账户余额（现货和合约）
• 子账户管理
• 资金流水 / 交易历史
• 充值地址和历史
• 提现历史
• API Key 权限检查

相关链接

• GitHub: toobit-docs/agent-skills
• npm: toobit-trade-cli