技能介绍

要解决什么问题

跨国协作时最常见的坑，往往是“时间”本身。一个排期表在不同时区的同事眼里可能是完全错乱的：伦敦的会议发起者以为 09:00 是早晨，东京的参会者却在同一时刻看到 18:00。旅行行程、CI/CD 定时任务、日志时间戳对齐这类场景，都需要频繁在 IANA 时区之间换算，手工查表既慢又容易出错。

这个技能把这类换算收敛成一组可调用的工具，而不是让用户自己去维护一张时区对照表。

它如何工作

整个服务是一个 MCP 服务器，核心能力分两块：

查询当前时间：scripts.tools.get_current_time 接收一个时区参数，返回该时区此刻的时间。
跨时区换算：scripts.tools.convert_time 需要源时区、时间、目标时区三个参数，把一个时刻从一个时区平移到另一个时区。

设计上有一个明确的分工：大模型是路由层，负责理解意图、选工具、抽取参数；代码只负责调 API 并把原始数据返回。所有工具都返回统一的 dict，其中 result["raw"] 是 API 原始 JSON，result["success"] 和 result["message"] 表示执行状态。参数缺失时，模型会通过 AskUserQuestion 向用户追问，而不是猜测默认值。

适用边界与注意点

强制依赖 API 密钥：首次使用时若 .env 中没有 XBY_APIKEY，必须先询问用户拿到密钥，再用 scripts.config.set_api_key 保存。没有密钥时禁止自行搜索或编造数据。
不做自然语言解析：工具只认时区标识，模型需要先把用户口语化的“纽约时间”翻译成规范时区名，这步是路由层的职责。
返回的是数据，不是解释：展示给用户的是整理后的原始结果，最终的时间合理性判断仍需使用方自行确认。