首驱 Skymotor 车联网

要解决什么问题

如果你骑的是首驱 Skymotor电动车，日常会问的不只是「车在哪」，还包括电量够不够、是否在充电、围栏有没有告警，以及「明早骑车去公司会不会淋雨」。这些能力分散在 Device Service 与围栏、天气接口里，手动查 API 或记 fenceId 都不适合对话场景。

技能如何工作

技能通过 scripts/skymotor_query.py 对接首驱接口，由 Agent 先识别意图再调脚本，而不是凭空回答车辆或天气数据。

典型能力包括：

• 车辆状态：绑定列表、当前使用车辆（state = 1 优先）、位置、电量、续航、开关机与充电状态。
• 电子围栏：查询、创建、更新、删除，以及告警记录；名称会先解析为真实 fenceId，纯数字名称也不会被直接当成 ID。
• 地点与天气：把当前位置存为「家」「公司」等别名；在用户明确要求时，基于车辆位置做通勤类天气查询。

鉴权 Key 的优先级固定为：环境变量 SKYMOTOR_DEVICESERVICE_KEY → 命令行 --api-key → 本地 config.json 的 apiKey。未配置时会提示提供 首驱 Skymotor Device Service Key。

边界与注意点

• 不要编造经纬度、围栏 ID、车辆状态或天气结果；失败时应保留原因，多车/多围栏时返回候选列表（choose_device / choose_fence），不要猜。
• 删除围栏属于高风险操作：需 --confirm-delete；脚本返回 confirmation_required 时要先展示围栏信息并等用户确认。
• config.json、state.json 等本地敏感配置不应随 skill 发布；围栏详情接口失败但列表命中时，只能确认围栏存在，无法判断是否在围栏内。
• 电量百分比为空时应说明暂不可用，并尽量返回续航等其它字段。字段与返回结构见 references/api-spec.md。