nofx/agent/skills/trader_management.json

{
  "name": "trader_management",
  "kind": "management",
  "domain": "trader",
  "description": "当用户想创建、查看、修改、删除、启动或停止交易员时调用。交易员是装配层；创建交易员时需要名称以及绑定的交易所、模型、策略。编辑交易员只允许修改手动面板可改的 6 项：绑定交易所、绑定模型、绑定策略、扫描间隔、保证金模式、是否展示到竞技场；不修改这些依赖对象的内部配置，也不在这里改名。若用户要改策略参数、模型配置或交易所凭证，应切到各自的 management skill。创建交易员时交易所、模型、策略既可以直接选择用户已有可用资源，也可以在当前主流程里先新建/启用对应资源，再继续完成交易员创建。不用于排查交易员启动失败、未下单、收益异常、仓位异常等诊断问题。",
  "intents": [
    "创建交易员",
    "修改交易员",
    "删除交易员",
    "启动交易员",
    "停止交易员",
    "查询交易员"
  ],
  "field_constraints": {
    "name": {
      "type": "string",
      "required": true,
      "max_length": 50,
      "description": "交易员名称，用于识别和管理，最多 50 个字符。"
    },
    "exchange_id": {
      "type": "entity_ref",
      "required": true,
      "description": "绑定的交易所配置 ID，必须是已存在且已启用的交易所配置。"
    },
    "ai_model_id": {
      "type": "entity_ref",
      "required": true,
      "description": "绑定的 AI 模型配置 ID，必须是已存在且已启用的模型配置。"
    },
    "strategy_id": {
      "type": "entity_ref",
      "required": true,
      "description": "绑定的策略模板 ID，必须是已存在的策略模板。"
    },
    "scan_interval_minutes": {
      "type": "int",
      "min": 3,
      "max": 60,
      "default": 5,
      "description": "AI 扫描决策间隔，单位分钟，手动面板可配置范围 3～60 分钟。超出范围会自动收敛到边界值并告知用户。"
    },
    "is_cross_margin": {
      "type": "bool",
      "default": true,
      "description": "保证金模式。true = 全仓（cross margin），false = 逐仓（isolated margin）。"
    },
    "show_in_competition": {
      "type": "bool",
      "default": true,
      "description": "是否在竞技场中显示该交易员的成绩。"
    },
    "auto_start": {
      "type": "bool",
      "default": false,
      "description": "创建后是否立即启动交易员。启动前系统会校验绑定的交易所、模型、策略均可用。"
    }
  },
  "validation_rules": [
    "exchange_id 对应的交易所配置必须已启用（enabled=true），否则无法创建或启动交易员。",
    "ai_model_id 对应的模型配置必须已启用（enabled=true）且配置完整（api_key、custom_model_name 不为空；custom_api_url 若填写必须为合法 HTTPS），否则无法创建或启动交易员。",
    "strategy_id 对应的策略模板必须存在，否则无法创建交易员。",
    "scan_interval_minutes 超出 3～60 范围时，系统自动收敛到边界值，并通过 LLM 告知用户已调整，询问是否接受。",
    "交易员初始余额由系统在创建时自动读取绑定交易所账户净值，不接受用户手动设置、充值或修改。",
    "交易员名称不能从模型 provider 自动推断；用户说“用 claw402”表示模型选择，不表示交易员名称叫 claw402。",
    "用户明确指定模型、交易所或策略时，若该资源不存在、被禁用、配置不完整或钱包余额不足，必须说明具体原因并让用户确认修复或替换；不得静默换成另一个资源。",
    "若用户指定 claw402 作为模型，但 claw402 钱包余额为 0 USDC，应提示先充值或确认临时改用其他可用模型；不得说成 claw402 未启用，除非 enabled 确实为 false。",
    "启动交易员前，绑定的模型必须已启用且完整，绑定的交易所也必须已启用且通过对应交易所的完整性校验，否则拒绝启动并明确指出缺哪一项。",
    "若绑定的是 OKX 交易所，启用前必须已有 passphrase；若绑定的是 Hyperliquid，启用前必须已有 wallet_addr；若绑定的是 Aster，启用前必须已有 user、signer、private_key；若绑定的是 Lighter，启用前必须已有 wallet_addr 和 api_key_private_key。",
    "启动（start）和停止（stop）操作属于高风险操作，必须先向用户确认再执行。",
    "删除（delete）操作不可逆，必须先向用户确认再执行。"
  ],
  "actions": {
    "create": {
      "description": "创建新的交易员。若缺少交易所、模型或策略，可在当前流程内先选择已有资源，或切去对应 skill 新建/启用后自动回流继续。",
      "required_slots": ["name", "exchange", "model", "strategy"],
      "optional_slots": ["auto_start", "scan_interval_minutes", "is_cross_margin", "show_in_competition"],
      "goal": "创建并初始化一个交易员。",
      "dynamic_rules": [
        "若用户提到的交易所、模型或策略已经存在且可用，应优先直接补入对应槽位，不要重新创建。",
        "如果用户明确指定某个模型 provider（如 claw402），应先尝试匹配该 provider 对应的模型配置；只有在说明原因并得到用户确认后，才可改用其他模型。",
        "若用户没有提供交易员名称，应生成一个来自交易所/策略/方向的清晰名称，或向用户追问；不要把模型 provider、交易所类型或策略字段误用为交易员名称。",
        "若依赖资源不存在、被禁用，或用户明确要求新建或启用，禁止直接报缺字段；应切去对应 management:create 或 management:update_status 子任务。",
        "子任务成功后，系统会恢复当前交易员草稿并继续补齐剩余槽位。",
        "scan_interval_minutes 超出 3～60 时，自动收敛并告知用户。",
        "不要向用户收集或确认初始余额；创建时由系统自动读取绑定交易所账户净值作为初始余额。",
        "创建完成后询问用户是否立即启动（auto_start），启动前再次确认。"
      ],
      "success_output": "返回 trader_id，并给出创建结果摘要（名称、绑定的交易所/模型/策略、是否已启动）。",
      "failure_output": "用人话指出缺失依赖项，或说明当前正在进入哪个依赖子任务。"
    },
    "update": {
      "description": "更新已有交易员，但只处理手动面板允许的字段：换绑策略、交易所、模型，或修改扫描间隔、保证金模式、竞技场显示。",
      "required_slots": ["target_ref"],
      "optional_slots": ["exchange_id", "ai_model_id", "strategy_id", "scan_interval_minutes", "is_cross_margin", "show_in_competition"],
      "goal": "更新一个已有交易员的手动面板字段，但不改动策略、模型、交易所内部配置。",
      "dynamic_rules": [
        "只更新用户明确提到的字段，不要覆盖未提及的字段。",
        "换绑交易所/模型/策略时，新的资源必须已存在且已启用；若是钱包付费模型，还要解释余额不足等支付状态。",
        "用户明确要求换成某个模型/交易所/策略时，不能自动选择另一个看起来可用的资源，除非用户确认。",
        "如果用户要求改名，应明确告知交易员改名不在这里处理。",
        "如果用户实际上是想修改策略参数、模型配置或交易所凭证，不要继续留在 trader update；应切到对应 management skill。"
      ],
      "success_output": "返回更新后的 trader_id 与简短配置摘要，明确哪些字段已经生效。",
      "failure_output": "明确指出目标交易员不存在、依赖资源不可用，或哪一个字段值仍需用户补充/修正。"
    },
    "update_bindings": {
      "description": "修改交易员手动面板可编辑的字段，可同时修改绑定关系、扫描间隔、保证金模式、竞技场显示。",
      "required_slots": ["target_ref"],
      "optional_slots": ["exchange_id", "ai_model_id", "strategy_id", "scan_interval_minutes", "is_cross_margin", "show_in_competition"],
      "goal": "调整交易员手动面板可编辑的字段，而不改动无关配置。",
      "dynamic_rules": [
        "新绑定的资源必须已存在且已启用，否则提示用户先启用或新建。",
        "当指定模型是 claw402 或 blockrun-base 且钱包余额不足时，应提示充值或让用户确认临时切换模型。",
        "扫描间隔超出 3～60 时，自动收敛并告知用户。"
      ],
      "success_output": "返回 trader_id，并明确展示新的模型/交易所/策略绑定结果。",
      "failure_output": "明确指出缺少哪个绑定目标，或当前依赖资源为什么不可直接绑定。"
    },
    "configure_strategy": {
      "description": "仅修改交易员绑定的策略。",
      "required_slots": ["target_ref", "strategy_id"],
      "goal": "为指定交易员换绑一个策略模板。",
      "dynamic_rules": [
        "若用户提到的是不存在的策略，应优先澄清或引导创建，而不是静默失败。"
      ],
      "success_output": "返回 trader_id，并明确告知当前生效的 strategy_id/策略名称。",
      "failure_output": "明确指出目标交易员或策略不存在，或策略仍需用户澄清。"
    },
    "configure_exchange": {
      "description": "仅修改交易员绑定的交易所。",
      "required_slots": ["target_ref", "exchange_id"],
      "goal": "为指定交易员换绑一个交易所配置。",
      "dynamic_rules": [
        "新的交易所配置必须已启用且可用，否则提示用户先启用或补齐凭证。"
      ],
      "success_output": "返回 trader_id，并明确告知当前生效的 exchange_id/交易所名称。",
      "failure_output": "明确指出目标交易员或交易所不存在，或交易所当前不可用。"
    },
    "configure_model": {
      "description": "仅修改交易员绑定的 AI 模型。",
      "required_slots": ["target_ref", "ai_model_id"],
      "goal": "为指定交易员换绑一个 AI 模型配置。",
      "dynamic_rules": [
        "新的模型配置必须已启用且可调用，否则提示用户先启用或补齐模型配置。",
        "若用户指定的是 claw402，应优先绑定 claw402；只有在钱包余额不足、凭证缺失或配置不可用且用户确认后，才允许改绑其他模型。"
      ],
      "success_output": "返回 trader_id，并明确告知当前生效的 ai_model_id/模型名称。",
      "failure_output": "明确指出目标交易员或模型不存在，或模型当前不可用。"
    },
    "start": {
      "description": "启动交易员，使其开始自动交易。高风险操作，必须确认。",
      "required_slots": ["target_ref"],
      "needs_confirmation": true,
      "goal": "让一个已配置好的交易员进入运行状态。",
      "dynamic_rules": [
        "启动前系统会自动校验绑定的交易所、模型、策略是否均可用。",
        "若绑定模型为 claw402 或 blockrun-base 且钱包余额不足，应提示充值或换模型；不要把它泛化成“模型不可用”。",
        "若校验失败，用人话告知用户具体哪个依赖不可用，并引导修复。"
      ],
      "success_output": "返回 trader_id，并明确告知交易员已开始运行。",
      "failure_output": "明确指出缺少确认、依赖资源不可用，或启动未通过校验。"
    },
    "stop": {
      "description": "停止交易员，使其停止自动交易。高风险操作，必须确认。",
      "required_slots": ["target_ref"],
      "needs_confirmation": true,
      "goal": "让一个运行中的交易员停止自动交易。",
      "dynamic_rules": [
        "若交易员当前并未运行，也应给用户清晰说明，而不是假装停止成功。"
      ],
      "success_output": "返回 trader_id，并明确告知交易员已停止。",
      "failure_output": "明确指出缺少确认、目标交易员不存在，或当前状态无法停止。"
    },
    "delete": {
      "description": "删除交易员，不可逆操作，必须确认。支持删除单个、多个或全部交易员。",
      "required_slots": [],
      "needs_confirmation": true,
      "goal": "删除一个、多个或全部交易员及其运行入口。",
      "dynamic_rules": [
        "必须在确认后执行，并明确提醒该操作不可逆。",
        "删除范围可以是单个 target_ref、多个目标，或 bulk_scope=all。",
        "删除前必须确认目标交易员都已停止；若存在运行中的交易员，不能删除，应要求用户先停止这些交易员。"
      ],
      "success_output": "返回删除成功结果，并明确告知哪些交易员已被移除。",
      "failure_output": "明确指出缺少确认、目标交易员不存在、目标仍在运行，或删除失败原因。"
    },
    "query_list": {
      "description": "查询所有交易员列表，包含名称、运行状态、绑定信息。",
      "goal": "列出当前用户可见的交易员，并给出足够的摘要用于后续选择。",
      "dynamic_rules": [
        "优先返回名称、运行状态、绑定的模型/交易所/策略，不要冗余展开全部详情。"
      ],
      "success_output": "返回交易员列表摘要，便于用户继续指定目标对象。",
      "failure_output": "若列表为空，应明确告知当前没有交易员，而不是返回模糊空结果。"
    },
    "query_running": {
      "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_trader:create",
    "update": "manage_trader:update",
    "update_bindings": "manage_trader:update",
    "configure_strategy": "manage_trader:update",
    "configure_exchange": "manage_trader:update",
    "configure_model": "manage_trader:update",
    "start": "manage_trader:start",
    "stop": "manage_trader:stop",
    "delete": "manage_trader:delete",
    "query_list": "manage_trader:list",
    "query_running": "manage_trader:list",
    "query_detail": "manage_trader:list"
  }
}