跳到主要内容

AI 与 Skills

概述​

Deepcoin Open API 文档既可以直接作为 AI 的上下文，也可以进一步整理成可复用的 agent skills。本页把“给 AI 读 Markdown 文档”和“按意图路由 skill”两种做法结合起来，方便 AI 更准确地理解 Deepcoin 的行情、账户与交易接口。

当前设计参考了两类思路：

  • 直接提供给 AI 读取的 Markdown 文档
  • 通过 SKILL.md 按用户意图拆分能力边界

Skill 架构​

当前建议将 Deepcoin 能力拆成 3 个 skills：

Skill范围适用场景
deepcoin-market公共 REST 与公共 WebSocket 行情能力行情、盘口、成交、K 线、产品信息、资金费率
deepcoin-account鉴权后的账户查询与私有 WebSocket 状态余额、持仓、账单、UID、杠杆设置、子账户、内部划转
deepcoin-trade鉴权后的交易与策略订单能力下单、撤单、改单、条件单、止盈止损、批量单、跟单、策略单

Skill 文件位于仓库中：

  • skills/deepcoin-market/SKILL.md
  • skills/deepcoin-account/SKILL.md
  • skills/deepcoin-trade/SKILL.md

设计原则​

1. 按用户意图路由，而不是按交易对路由​

同一个 BTC-USDT-SWAP 可能同时出现在行情、账户和交易请求中，因此应按“用户要做什么”来选 skill：

  • “查询 BTC 最新资金费率” -> deepcoin-market
  • “查看我的 BTC-USDT-SWAP 持仓” -> deepcoin-account
  • “在 BTC-USDT-SWAP 开多一笔限价单” -> deepcoin-trade

2. 所有私有接口都必须遵循签名规则​

凡是访问私有 REST 接口的 skill，都必须遵循 接入指南 中的签名规则：

  • DC-ACCESS-KEY
  • DC-ACCESS-SIGN
  • DC-ACCESS-TIMESTAMP
  • DC-ACCESS-PASSPHRASE

3. 当前优先支持“文档型 skill”​

当前版本的 Deepcoin skills 主要用于帮助 AI：

  • 正确回答接口问题
  • 生成 REST / WebSocket 示例代码
  • 组装正确的请求参数
  • 解释签名方式、交易对命名和字段语义

也就是说，这一版更偏“文档型 skill”，优先提升 AI 读文档和写代码的能力。后续如果 Deepcoin 提供官方 CLI 或 MCP Server，可以沿用同一套 skill 结构继续扩展成真正可执行的 tool skill。

推荐打包方式​

如果要把 Deepcoin skills 提供给外部 AI 工具或代码代理，建议使用如下目录结构：

deepcoin-skills/
  skills/
    deepcoin-market/
      SKILL.md
    deepcoin-account/
      SKILL.md
    deepcoin-trade/
      SKILL.md
  docs/
    authentication.md
    DeepCoinMarket/
    DeepCoinAccount/
    DeepCoinTrade/
    publicWS/
    privateWS/

其中 SKILL.md 负责定义 skill 的适用范围和路由规则，具体接口、字段和示例仍以 Deepcoin 原始文档为准。

下一步​

继续阅读 使用说明，了解在 Claude Code、Cursor、Cline、OpenClaw 等工具中的安装方式与调用方式。