nofx/agent/skills/exchange_management.json

{
  "name": "exchange_management",
  "kind": "management",
  "domain": "exchange",
  "description": "当用户想创建、查看、修改或删除交易所账户配置时调用。适用于用户提到交易所账户、API Key、Secret、Passphrase、测试网开关、启用状态等配置管理需求。不用于排查 invalid signature、timestamp、权限不足、白名单限制等连接或鉴权诊断问题。",
  "field_constraints": {
    "exchange_type": {
      "type": "enum",
      "required": true,
      "values": ["binance", "bybit", "okx", "bitget", "gate", "kucoin", "hyperliquid", "aster", "lighter", "indodax"],
      "aliases": {"币安": "binance", "欧易": "okx", "必安": "binance", "bitget": "bitget", "bitget futures": "bitget", "bitget合约": "bitget", "库币": "kucoin", "gate.io": "gate", "hyper": "hyperliquid", "印尼站": "indodax"},
      "description": "交易所类型，必填，决定后续需要哪些凭证字段。"
    },
    "account_name": {
      "type": "string",
      "max_length": 50,
      "description": "账户显示名称，可选，用于区分同一交易所的多个账户。"
    },
    "api_key": {
      "type": "credential",
      "pattern": "^[A-Za-z0-9_\\-]{8,}$",
      "description": "交易所 API Key，至少 8 位字母数字。"
    },
    "secret_key": {
      "type": "credential",
      "pattern": "^([A-Za-z0-9_\\-]{8,}|(0x)?[A-Fa-f0-9]{16,})$",
      "description": "交易所 Secret Key，至少 8 位字母数字，或十六进制格式。"
    },
    "passphrase": {
      "type": "credential",
      "required_for": ["okx", "bitget", "kucoin"],
      "description": "OKX、Bitget、KuCoin 专用 Passphrase/API 口令，对这些交易所启用前必须填写；Binance、Bybit、Gate、Indodax 通常不需要。"
    },
    "testnet": {
      "type": "bool",
      "default": false,
      "description": "是否使用测试网（沙盒环境），默认 false（主网）。"
    },
    "enabled": {
      "type": "bool",
      "default": true,
      "description": "是否启用该交易所配置。只要必要字段齐全并配置成功，就默认启用。"
    },
    "hyperliquid_wallet_addr": {
      "type": "credential",
      "required_for": ["hyperliquid"],
      "description": "Hyperliquid 主钱包地址，Hyperliquid 账户启用前必须填写。"
    },
    "hyperliquid_unified_account": {
      "type": "bool",
      "default": false,
      "required_for": ["hyperliquid"],
      "description": "是否启用 Hyperliquid unified account 模式。"
    },
    "aster_user": {
      "type": "credential",
      "required_for": ["aster"],
      "description": "Aster 用户地址，Aster 账户启用前必须填写。"
    },
    "aster_signer": {
      "type": "credential",
      "required_for": ["aster"],
      "description": "Aster Signer 地址，Aster 账户启用前必须填写。"
    },
    "aster_private_key": {
      "type": "credential",
      "required_for": ["aster"],
      "description": "Aster 私钥，Aster 账户启用前必须填写。"
    },
    "lighter_wallet_addr": {
      "type": "credential",
      "required_for": ["lighter"],
      "description": "Lighter 钱包地址，Lighter 账户启用前必须填写。"
    },
    "lighter_private_key": {
      "type": "credential",
      "required_for": ["lighter"],
      "description": "Lighter 私钥，某些 Lighter 账户模式下启用前必须填写。"
    },
    "lighter_api_key_private_key": {
      "type": "credential",
      "required_for": ["lighter"],
      "description": "Lighter API Key 私钥，Lighter 账户启用前必须填写。"
    },
    "lighter_api_key_index": {
      "type": "int",
      "min": 0,
      "max": 255,
      "required_for": ["lighter"],
      "description": "Lighter API Key Index，范围 0～255，超出范围自动收敛并告知用户。"
    }
  },
  "validation_rules": [
    "api_key 格式：至少 8 位字母数字，不符合时提示用户重新输入完整 Key。",
    "secret_key 格式：至少 8 位字母数字，或十六进制格式，不符合时提示用户重新输入。",
    "OKX 账户启用前必须填写 passphrase，否则拒绝启用并提示补填。",
    "Bitget 和 KuCoin 页面流程里也需要 passphrase/API 口令，不能回答“没有就留空”；缺失时应明确提示补填。",
    "Hyperliquid 创建/更新时应与手动页面保持一致：至少收集 api_key + hyperliquid_wallet_addr。",
    "Hyperliquid 账户启用前必须填写 hyperliquid_wallet_addr。",
    "若用户使用 Hyperliquid unified account 模式，应明确记录 hyperliquid_unified_account 开关状态。",
    "Aster 账户启用前必须填写 aster_user、aster_signer、aster_private_key 三个字段，任一缺失都不能启用。",
    "Lighter 账户启用前必须填写 lighter_wallet_addr + lighter_api_key_private_key；若当前账户模式还依赖 lighter_private_key，也要先补齐后再启用。",
    "lighter_api_key_index 超出 0～255 时自动收敛到边界值并告知用户。",
    "删除操作不可逆，必须先向用户确认再执行。"
  ],
  "per_exchange_required_fields": {
    "binance":      ["api_key", "secret_key"],
    "okx":          ["api_key", "secret_key", "passphrase"],
    "bybit":        ["api_key", "secret_key"],
    "bitget":       ["api_key", "secret_key", "passphrase"],
    "gate":         ["api_key", "secret_key"],
    "kucoin":       ["api_key", "secret_key", "passphrase"],
    "indodax":      ["api_key", "secret_key"],
    "hyperliquid":  ["api_key", "hyperliquid_wallet_addr"],
    "aster":        ["aster_user", "aster_signer", "aster_private_key"],
    "lighter":      ["lighter_wallet_addr", "lighter_api_key_private_key"]
  },
  "actions": {
    "create": {
      "description": "创建新的交易所配置。根据 exchange_type 决定需要收集哪些凭证字段。",
      "required_slots": ["exchange_type", "account_name"],
      "optional_slots": ["account_name", "api_key", "secret_key", "passphrase", "testnet", "hyperliquid_wallet_addr", "hyperliquid_unified_account", "aster_user", "aster_signer", "aster_private_key", "lighter_wallet_addr", "lighter_private_key", "lighter_api_key_private_key", "lighter_api_key_index"],
      "goal": "创建一个可供 trader 绑定使用的交易所配置。",
      "dynamic_rules": [
        "确认 exchange_type 后，根据 per_exchange_required_fields 决定需要追问哪些凭证字段。",
        "Binance/Bybit/Gate/Indodax 需要 API Key + Secret；OKX/Bitget/KuCoin 还必须追问 passphrase；Hyperliquid 必须追问 api_key + 钱包地址，并允许记录 unified account 开关；Aster 必须追问 user/signer/private_key；Lighter 必须追问钱包地址和 api_key_private_key。",
        "如果用户选择 OKX、Bitget 或 KuCoin，不能把 passphrase 说成可选项；没有 passphrase 时应停在补字段，不要创建半成品。",
        "凭证字段格式不符时，用人话告知用户正确格式，不要静默丢弃。",
        "若当前父任务只是缺一个可用交易所，本动作完成后应允许父任务恢复并消费新的 exchange_id。",
        "若请求只是在启用已有交易所，不应误走 create，应改走 update_status。"
      ],
      "success_output": "返回新 exchange_id 和创建后的交易所配置摘要（类型、账户名、是否启用）。",
      "failure_output": "明确指出缺失的必填字段或非法凭证格式，禁止返回含糊的成功信息。"
    },
    "update": {
      "description": "更新已有交易所配置的任意可编辑字段。",
      "required_slots": ["target_ref"],
      "optional_slots": ["account_name", "api_key", "secret_key", "passphrase", "enabled", "testnet", "hyperliquid_wallet_addr", "hyperliquid_unified_account", "aster_user", "aster_signer", "aster_private_key", "lighter_wallet_addr", "lighter_private_key", "lighter_api_key_private_key", "lighter_api_key_index"],
      "goal": "更新一个已有交易所配置的指定字段，而不影响未提及字段。",
      "dynamic_rules": [
        "只更新用户明确提到的字段，不要覆盖未提及的字段。",
        "更新凭证字段时，格式不符则提示用户重新输入。"
      ],
      "success_output": "返回 exchange_id 和更新后的交易所配置摘要。",
      "failure_output": "明确指出目标交易所不存在、凭证格式非法，或仍缺哪个字段。"
    },
    "update_name": {
      "description": "修改交易所配置中的账户显示名称字段。",
      "required_slots": ["target_ref", "account_name"],
      "goal": "修改交易所配置中的账户显示名称，而不影响其他字段。",
      "dynamic_rules": [
        "若用户同时提到其他字段，应优先走更通用的 update。"
      ],
      "success_output": "返回 exchange_id，并明确告知交易所配置已更新。",
      "failure_output": "明确指出目标交易所不存在，或新的账户名称仍缺失。"
    },
    "update_status": {
      "description": "修改交易所配置中的启用开关。启用前系统会校验凭证完整性。",
      "required_slots": ["target_ref", "enabled"],
      "goal": "修改交易所配置中的启用状态字段。",
      "dynamic_rules": [
        "启用前根据 exchange_type 校验必填凭证是否齐全，不齐全则提示用户补填后再启用。"
      ],
      "success_output": "返回 exchange_id，并明确告知交易所配置已更新。",
      "failure_output": "明确指出目标交易所不存在、缺少必填凭证，或当前状态切换失败。"
    },
    "delete": {
      "description": "删除交易所配置，不可逆操作，必须确认。",
      "required_slots": ["target_ref"],
      "needs_confirmation": true,
      "goal": "删除一个交易所配置。",
      "dynamic_rules": [
        "必须在确认后执行，并明确提醒删除不可逆。"
      ],
      "success_output": "返回删除成功结果，并明确告知该交易所配置已被移除。",
      "failure_output": "明确指出缺少确认、目标交易所不存在，或删除失败原因。"
    },
    "query_list": {
      "description": "查询所有交易所配置列表，包含类型、账户名、启用状态。",
      "goal": "列出当前用户可用的交易所配置，便于后续绑定或选择。",
      "dynamic_rules": [
        "优先返回类型、账户名、启用状态，不返回敏感凭证明文。"
      ],
      "success_output": "返回交易所配置列表摘要。",
      "failure_output": "若列表为空，应明确告知当前没有交易所配置。"
    },
    "query_detail": {
      "description": "查询某个交易所配置的详细信息。",
      "required_slots": ["target_ref"],
      "goal": "读取一个交易所配置的详细信息和当前状态。",
      "dynamic_rules": [
        "详情返回中只能暴露凭证存在性，不得返回凭证明文。"
      ],
      "success_output": "返回目标交易所配置的详细摘要。",
      "failure_output": "明确指出目标交易所不存在，或当前引用已经失效。"
    }
  },
  "tool_mapping": {
    "create": "manage_exchange_config:create",
    "update": "manage_exchange_config:update",
    "update_name": "manage_exchange_config:update",
    "update_status": "manage_exchange_config:update",
    "delete": "manage_exchange_config:delete",
    "query_list": "get_exchange_configs",
    "query_detail": "get_exchange_configs"
  }
}