Caltrain 火车时刻查询

这个技能解决什么问题

当你想知道「Caltrain 从 San Jose Diridon 到 San Francisco 接下来几班车」时，你不是在做数学题，而是在问一个依赖外部数据的运行时问题。大模型自身无法可靠回答这类查询：时刻表在不断变化，站点名称有缩写（SF、SJ）和正式拼写的差异，凭记忆生成的时刻很可能是错的。

这个技能把「理解用户意图 → 提取参数 → 调用时刻表 API → 返回原始数据」这条链路固化下来。模型只做路由层的工作，具体的时刻数据全部来自基于 GTFS 的 API 返回。

核心能力

• 指定站点间的时刻查询：调用 scripts.tools.next_trains，返回两点之间接下来若干班 Caltrain 列车，支持 origin、destination 和可选的 when_iso（ISO-8601 本地时间）。
• 站点清单查询：当用户提供的站名无法匹配时，调用 scripts.tools.list_stations 获取可用站点列表。
• 站点名容错：站名大小写不敏感，且支持 SF（San Francisco）、SJ（San Jose）这类常见缩写。

工作流程

1. 检查 API 密钥：scripts.config.settings.api_key 为空时，必须先通过 AskUserQuestion 向用户索取密钥，再用 scripts.config.set_api_key(key) 保存。
2. 选择工具：根据用户意图在 next_trains 和 list_stations 之间路由。
3. 提取参数：缺参数时用 AskUserQuestion 追问，而不是猜测。
4. 调用工具：以关键字参数调用 scripts.tools 中的函数。
5. 返回结果：把工具返回的 result["raw"] 整理后展示给用户。

注意事项

• API 密钥是硬性前提。缺少密钥时，禁止自行搜索或编造时刻数据——这是该技能明确禁止的行为。
• 遇到 Station not found 时，先调 list_stations 拿到准确站名再重试。
• 当前数据范围仅覆盖 Caltrain 线路，不包含其他铁路运营商的时刻信息。