跳到主要内容

使用说明

使用模式​

将 Deepcoin skills 接入 AI 工具，通常有两种方式。

方式一：仅文档模式​

适用于你希望 AI 读取 Deepcoin API 文档并生成代码，但当前还没有官方 Deepcoin CLI 或 MCP Server 的场景。

建议提供给 AI 的输入包括：

  • 本仓库中相关的 Deepcoin API 文档
  • skills/ 目录中的一个或多个 SKILL.md
  • 目标语言，例如 Python、JavaScript、Go

这种模式适合：

  • API 接入开发
  • 签名逻辑实现
  • 请求与响应解释
  • 交易机器人示例代码生成
  • WebSocket 订阅示例生成

方式二：Skill 优先模式​

适用于你的 AI 工具支持 skill 发现、规则文件或斜杠命令调用。在这种模式下，把 SKILL.md 安装到工具的 skill 目录中，同时把 Deepcoin 文档保留在项目工作区内，方便 AI 跳转到具体接口说明。

安装方式​

Claude Code / 兼容 Claude Skills 的环境​

全局安装：

mkdir -p ~/.claude/skills/deepcoin-market
mkdir -p ~/.claude/skills/deepcoin-account
mkdir -p ~/.claude/skills/deepcoin-trade
cp skills/deepcoin-market/SKILL.md ~/.claude/skills/deepcoin-market/
cp skills/deepcoin-account/SKILL.md ~/.claude/skills/deepcoin-account/
cp skills/deepcoin-trade/SKILL.md ~/.claude/skills/deepcoin-trade/

仅当前项目安装：

mkdir -p .claude/skills/deepcoin-market
mkdir -p .claude/skills/deepcoin-account
mkdir -p .claude/skills/deepcoin-trade
cp skills/deepcoin-market/SKILL.md .claude/skills/deepcoin-market/
cp skills/deepcoin-account/SKILL.md .claude/skills/deepcoin-account/
cp skills/deepcoin-trade/SKILL.md .claude/skills/deepcoin-trade/

Cursor​

如果当前环境不支持原生 skill 目录，可以把每个 SKILL.md 复制成规则文件：

mkdir -p .cursor/rules
cp skills/deepcoin-market/SKILL.md .cursor/rules/deepcoin-market.md
cp skills/deepcoin-account/SKILL.md .cursor/rules/deepcoin-account.md
cp skills/deepcoin-trade/SKILL.md .cursor/rules/deepcoin-trade.md

Cline / Roo Code / 类似 IDE Agent​

把相关 skill 的内容合并到对应扩展使用的 instruction 文件中，同时保留项目内的 Deepcoin 文档目录，方便 agent 基于引用路径继续查阅接口细节。

OpenClaw​

mkdir -p ~/.openclaw/skills/deepcoin-market
mkdir -p ~/.openclaw/skills/deepcoin-account
mkdir -p ~/.openclaw/skills/deepcoin-trade
cp skills/deepcoin-market/SKILL.md ~/.openclaw/skills/deepcoin-market/
cp skills/deepcoin-account/SKILL.md ~/.openclaw/skills/deepcoin-account/
cp skills/deepcoin-trade/SKILL.md ~/.openclaw/skills/deepcoin-trade/

调用方式​

斜杠命令调用​

如果 AI 工具支持显式选择 skill，可以这样使用：

  • /deepcoin-market：行情、盘口、成交、K 线、公共流
  • /deepcoin-account：余额、持仓、账单、UID、私有流
  • /deepcoin-trade：下单、撤单、条件单、止盈止损、批量交易

自然语言触发​

也可以直接让 AI 根据意图自动匹配：

  • “帮我查询 BTC-USDT 的盘口和最近成交”
  • “生成 Python 代码查询 Deepcoin 账户余额”
  • “写一段 JavaScript，给 BTC-USDT-SWAP 下限价开多单”
  • “告诉我怎么订阅私有订单推送”

推荐提示词格式​

为了让 AI 更稳定地产出结果，建议在问题中明确以下信息：

  1. 目标环境，例如 Python requests、Node.js fetch、Go HTTP Client
  2. 目标接口或业务目标
  3. 任务属于行情、账户还是交易
  4. 你希望得到解释、示例代码，还是可直接运行的项目代码

示例：

使用 deepcoin-trade skill，帮我生成 Python 代码调用 POST /deepcoin/trade/order。
交易对是 BTC-USDT-SWAP，我要下一个限价买入开多单。
请使用环境变量读取 API 凭证，并包含签名逻辑。

使用注意事项​

  • 公共行情接口无需鉴权。
  • 私有 REST 接口必须遵循 接入指南 中的签名规则。
  • 私有 WebSocket 示例需要区分登录流程与订阅流程。
  • 交易示例在下单前应先确认 instId、tickSz 和 minSz。
  • 在没有真实执行工具的前提下，当前 skills 默认更适合“文档理解 + 代码生成”，而不是直接执行真实交易。