gate-exchange-trading

解析 gate-cli（二进制路径）

按顺序解析 gate-cli：（1） command -v gate-cli 和 gate-cli --version 均成功；（2） 如果 ${HOME}/.local/bin/gate-cli 可执行，则使用该路径；（3） 如果 ${HOME}/.openclaw/skills/bin/gate-cli 可执行，则使用该路径。规范规则：exchange-runtime-rules.md §4（或 gate-runtime-rules.md §4）。

Gate Exchange Trading

这是一个二级复合技能，面向希望通过单个技能完成完整交易闭环的用户：

判断机会 -> 控制风险 -> 生成订单草案 -> 明确确认 -> 执行 -> 验证/管理

它既不是纯研究技能，也不是纯执行技能。其目的是在一个技能中提供完整的交易工作流。

通用规则

⚠️ 停止——继续操作前，必须阅读并严格遵守共享运行时规则。 在读完所有规则之前，不得选择或调用任何工具。这些规则具有最高优先级。 → 阅读 gate-runtime-rules.md

• 仅使用此技能中明确列出的 gate-cli 命令。 即使其他接口提供了相关命令，也不得在这些工作流中运行本文档未说明的命令。

调用任何具名 MCP 工具前，先确认当前运行时工具列表中存在该具体工具名称。如果缺少辅助工具，应说明这一差异，仅使用最接近的有效备用组合，并且不得夸大不可用的覆盖范围，例如排名、宏观市场广度或自动化资金流追踪。

还要验证返回的数据是否足以支持预期的分析结论。如果工具返回的元数据稀疏、结构为空，或需要但缺少消歧输入，则只能将其作为辅助背景，而不能作为主要证据。

为确保在不同主机上均可使用，请将文档所述的 gate-cli cex … 命令视为基准：

• info_* -> Gate Info MCP
• news_feed_* -> Gate News MCP
• 只读现货/期货市场数据 -> gate-cli cex spot market … / gate-cli cex futures market …（适用时使用公共端点）
• 私有订单 / 账户 / 持仓流程 -> 已通过身份验证的 gate-cli（GATE_API_KEY / GATE_API_SECRET 和/或 gate-cli config init；当主机上同时设置了两个环境变量时，无需运行 config init）

场景设计中不要将 news_events_* 设为必需依赖，因为它不属于文档所述的基准新闻接口。

执行模式

阅读并严格遵守 references/gate-cli.md，然后执行此技能的交易工作流。

• SKILL.md 负责复合路由、交易生命周期策略和防护措施。
• references/gate-cli.md 是权威的 gate-cli 编排规范，规定跨领域工具调用顺序、执行门槛和降级处理。

---

阅读 references/scenarios.md，了解：

• 代表性用户场景
• 代表性提示词示例
• 预期的工具路由模式

身份验证

• **交互式文件配置：**如果主机上没有同时设置 GATE_API_KEY 和 GATE_API_SECRET，请运行 gate-cli config init，完成 API 密钥、密钥、配置文件和默认值的向导设置（参见 gate-cli）。
• 环境变量 / 标志：如果凭据已提供，则无需运行 gate-cli config init，例如主机上已设置 GATE_API_KEY 和 GATE_API_SECRET，或在支持的情况下使用 --api-key / --api-secret。绝不要要求用户在聊天中粘贴密钥。
• 是否需要 API 密钥：不一定
• 只读分析：根据端点不同，公开的 info_*、news_feed_*，以及部分公开的 gate-cli cex spot market … / gate-cli cex futures market … 读取操作可能无需身份验证
• 执行和私有账户操作：是，必须使用具备所需 API 密钥权限的已认证 Exchange MCP 工具
• 注意：不要仅因无法使用私有执行工具就阻止仅分析用途；只有当请求的操作需要私有交易 / 账户访问权限时才阻止。

安装检查

• 必需：gate-cli（从 gate-cli releases 安装，或通过环境中的 Gate MCP / 技能安装器安装）。
• 通过名称调用时，请将包含 gate-cli 的目录添加到 PATH。
• 凭据：如果主机已设置非空的 GATE_API_KEY 和 GATE_API_SECRET，则不要要求运行 gate-cli config init。如果两者均未设置或为空，且需要执行私有操作，请提醒操作人员运行 gate-cli config init，或在技能库中对应的技能内配置 GATE_API_KEY / GATE_API_SECRET（绝不要要求用户在聊天中粘贴密钥）。
• **健全性检查：**在执行私有交易步骤前，确认 CLI 可正常运行（例如运行 gate-cli --version，或执行公开的 gate-cli cex spot market … / gate-cli cex futures market … 读取操作）。

定位

• 面向希望交易时无需在多个技能之间切换的用户
• 独立完整：可单独安装，并能理解分析和执行之间的对应关系
• 支持现货交易和 USDT 永续合约
• 支持交易后的修改 / 取消 / 平仓 / 验证

适用场景

适用

• 用户已有目标资产，希望在交易前进行分析
  • 检查一下现在是否值得买入 BTC，然后给我一份现货订单草案
  • 我想做多 ETH，但请先检查动能、清算和流动性
• 用户因新闻、异常走势或新币上线而想交易，并希望先进行分析
  • ETH 刚刚暴跌。解释一下原因，并告诉我是否值得买入
  • 这个新上线的币看起来很有意思。先检查风险，再给我一份入门交易计划
• 用户已下单或开仓，现在希望进行管理
  • 将我尚未成交的买单提高 1%
  • 平掉一半 BTC 仓位

不适用

• 没有交易目标的纯市场研究
• 期权、Alpha 交易、链上兑换、DeFi 执行、跟单交易、财富管理产品
• 全自动交易、跳过确认、绕过合规或风险控制

能力边界

此技能可以

1. 识别用户的需求类型：
   • 交易前判断
   • 判断并执行
   • 订单 / 仓位管理
2. 围绕一个交易目标动态组合分析模块：
   • 市场 / 新闻背景
   • 单币分析
   • 技术分析
   • 流动性 / 滑点 / 清算 / 订单簿分析
   • 代币或合约风险检查
3. 生成一份交易简报
4. 在风险可接受时生成一份订单草案
5. 经明确确认后执行：
   • 现货买入 / 卖出、条件限价逻辑、修改 / 取消 / 验证
   • USDT 永续合约开仓 / 平仓 / 反向操作 / 修改 / 取消
6. 执行后继续处理：
   • 成交验证
   • 仓位验证
   • 订单 / 仓位管理

此技能无法执行的事项

1. 代表用户自动判断并交易
2. 未经明确确认就下单
3. 绕过合规、风险、最低下单金额或合约安全限制
4. 承诺盈利或将分析说成确定结论
5. 假装支持不受支持的产品

操作原则

原则 1：围绕交易目标开展工作

此技能旨在完成交易流程，而非开展广泛研究。

• 如果用户只问 How is the market?
  • 可以进行轻量级市场扫描
  • 不要主动进入下单执行环节
• 如果用户说 How is the market today? Give me one trade idea
  • 可以进行轻量级扫描
  • 但进入执行环节前，工作流必须将目标缩小到一种资产 + 一个市场（现货或期货）

原则 2：先判断，再执行

除非用户只想进行纯粹的订单／持仓管理，否则默认先进行一轮交易前判断，再生成订单草案。

原则 3：只进行必要的最少分析

不要每次都运行所有模块。只调用当前决策所需的模块。

阅读 references/routing-and-analysis.md，了解：

• 意图路由
• 根据场景选择分析模块
• 风险门控
• 模块到 MCP 的映射及调用模式

原则 4：在执行环节严格确认

任何实际交易操作都必须按以下顺序进行：

1. 生成 Trading Brief
2. 生成 Order Draft
3. 等待用户在紧接着的上一轮中明确确认
4. 仅在确认后执行

阅读 references/execution-and-guardrails.md，了解：

• 现货和期货执行规则
• 执行 MCP 映射
• 草案要求
• 确认规则
• 硬性和软性拦截

整体工作流

步骤 0：先应用通用运行时规则

在分析或执行前：

• 阅读并遵循 gate-runtime-rules.md
• 解决所有必需的运行时、更新或授权门控，然后再继续
• 确认计划调用的具名工具在当前运行时中存在，再依赖这些工具

步骤 1：识别任务模式

将用户请求归类为以下一种模式：

1. Trade Decision
   • 先分析，再决定是否交易
2. Trade Draft / Execute
   • 用户已有交易意图，并希望获得分析、草案和执行
3. Order / Position Management
   • 用户希望管理现有订单或持仓

步骤 2：将交易目标缩小到一种

进入执行环节前，尽量明确以下信息：

• 资产：BTC / ETH / SOL / 新币 / 期货合约
• 市场：现货或 USDT 永续合约
• 方向：买入 / 卖出 / 做多 / 做空 / 平仓

如果信息仍不完整：

• 可以进行轻量级市场扫描
• 但生成订单草案前，工作流必须将目标缩小到一种资产和一个市场

步骤 3：构建交易前分析包

只调用本次请求所需的模块：

• 市场概览 / 新闻简报
• 上市 / 交易所公告背景
• 单币分析
• 技术分析
• 事件说明
• 风险检查
• 地址追踪（仅当用户确实提供地址并要求追踪时）
• 流动性 / 滑点 / 动量 / 强平 / 基差 / 订单簿分析

步骤 4：生成 Trading Brief

Trading Brief 是执行前必须生成的中间产物，必须包含：

1. 用户想做什么
2. 对当前市场／资产的判断
3. 主要风险
4. 技能是否应继续生成订单草案

仅允许以下三种结果状态：

• GO = 风险足够低，可以继续生成订单草案
• CAUTION = 存在显著风险，但警告后仍可继续生成草案
• BLOCK = 不要继续生成订单草案

步骤 5：生成订单草案

仅当以下条件全部满足时，才生成订单草案：

• 用户确实有交易意图
• 交易目标足够明确
• 未触发任何硬性拦截

第 6 步：等待明确确认

如果用户未提供清晰、即时的确认：

• 不要执行
• 仅保持在分析／草拟／询问模式

第 7 步：执行并验证

执行后，务必返回：

• 执行是否成功
• 核心成交／订单／持仓结果
• 合理的后续操作，例如验证成交、修改、取消或平仓

市场识别规则

默认行为

• 如果请求明确包含 long / short / leverage / contract / perp / futures / open / close
  • 路由至 USDT 永续期货
• 如果请求明确包含 buy coin / sell coin / spot / buy BTC / sell ETH
  • 路由至 现货
• 如果用户说 buy BTC，但未指定市场
  • 默认采用 现货
• 如果用户说 trade this move
  • 询问他们想交易现货还是 USDT 永续期货

推荐的输出节奏

执行前

1. Trading Brief
2. 如果允许：Order Draft
3. 等待确认

执行后

1. Execution Result
2. 如有需要：Next Actions

订单／持仓管理特别规则

如果用户要求：

• 修改订单
• 取消订单
• 验证成交
• 平掉一半
• 全部平仓
• 反向操作

那么该技能无需重新执行完整的研究流程，但仍必须：

• 找到正确的目标订单或持仓
• 应用相应的执行规则
• 对高风险操作要求有力确认

风险策略

硬性拦截

以下情况必须立即停止：

• 用户要求跳过确认
• 用户要求绕过合规或风险控制
• 产品不受支持
• 资产不可交易
• 代币安全检查发现严重恶意风险

软性拦截

以下情况需发出警告，但允许继续：

• 流动性差
• 滑点高
• 资金费率极端
• 拥挤／强平风险升高
• 重大事件刚刚发生，方向尚不稳定
• 代币刚刚上市或仍处于价格发现阶段

对于软性拦截：

• 在 Trading Brief 中清楚地提示警告
• 如果用户仍希望继续，允许草拟订单
• 仍必须获得确认

阅读顺序

1. 阅读 references/routing-and-analysis.md
2. 阅读 references/execution-and-guardrails.md
3. 仅执行当前任务所需的模块；默认不要运行完整流程