skanetrafiken

核心用法

Skanetrafiken Trip Planner 是一款面向瑞典斯科讷省（Skåne）地区的公共交通行程规划工具，通过调用 Skånetrafiken 官方 API 实现实时公交、火车信息查询。该技能包含两个核心脚本：：search-location.sh 用于搜索站点、地址或地标的位置 ID，，journey.sh 用于规划两点之间的完整行程。用户可通过自然语言时间表达（如"in 30 minutes"、"arrive by 18:00"）触发查询，系统会自动解析时间意图并转换为 API 参数。特别支持跨境行程规划至丹麦哥本哈根，覆盖 Pågatåg 区域列车、Öresundståg 跨境列车、巴士及哥本哈根地铁等多种交通方式。

显著优点

精准的时间意图解析：技能内置完善的自然语言时间处理机制，能识别"now"、"around 15:00"、"tomorrow morning"等 6 类时间意图，并自动计算偏移量展示前后选项。对于"around time"类查询，系统会智能提前 15-30 分钟查询，确保用户看到目标时段前后的完整选择。

专业的响应格式化：提供详细的 LLM 输出规范，包含 17 个标准化 emoji 用于区分交通类型（🚂火车、🚌巴士、🚇地铁）、状态（✅准点、⚠️延误）及行程节点（🔄换乘、🛤️站台）。强制要求展示步行段距离与时间，确保用户掌握完整的门到门时间规划。

鲁棒的输入处理：针对 API 的特性差异，技能明确了不同位置类型的查询格式——地标仅用名称、地址需加城市名、火车站使用官方"C"后缀。对于 ADDRESS 和 POI 类型结果，自动转换为坐标格式适配 Journey API，避免调用失败。

完善的错误处理：脚本采用 set -euo pipefail 严格模式，设置 30 秒 curl 超时，临时文件使用 PID 隔离并配置 trap 自动清理。API 响应经 JSON 格式验证后才进入解析流程，错误信息输出至 stderr 不影响正常解析。

潜在缺点与局限性

地域限制明显：仅覆盖瑞典斯科讷省及哥本哈根跨境区域，对瑞典其他地区（如斯德哥尔摩、哥德堡）或国际其他城市无支持。API 数据源单一，若 Skånetrafiken 服务中断则完全不可用。

依赖系统工具：硬性依赖 curl 和 jq，虽为常见工具但在精简容器或特定企业环境中可能缺失。无内置依赖检查与自动安装机制，需用户自行确保环境就绪。

T3 来源维护风险：作者为个人开发者（rezkam），非官方交通机构或成熟组织。长期维护稳定性、功能更新响应速度存在不确定性，不适合作为生产环境关键业务依赖。

网络依赖性强：所有功能均需实时连接 Skånetrafiken 官方服务器，无离线缓存或历史数据查询能力。网络波动时用户体验显著下降。

适合的目标群体

• 斯科讷省居民与通勤者：日常依赖公共交通往返马尔默、隆德、赫尔辛堡等地的上班族与学生
• 跨境旅客：频繁往返瑞典与丹麦哥本哈根之间的商务人士与游客
• AI 助手开发者：需要为瑞典南部地区用户提供交通查询能力的 Claude Code 或其他兼容 Agent 的开发者
• 临时访客：前往斯科讷省旅游、需要实时公交火车信息规划行程的国际游客

使用风险

性能风险：API 响应时间受网络状况与官方服务器负载影响，高峰期可能出现延迟。curl 30 秒超时设置虽防止无限等待，但在弱网环境下可能导致查询失败。

数据准确性风险：实时延误信息依赖 Skånetrafiken 数据更新频率，极端天气或突发事故时信息可能存在滞后。用户应预留缓冲时间，不宜将查询结果作为唯一决策依据。

API 变更风险：非官方维护的第三方封装，若 Skånetrafiken 调整 API 端点或响应格式，现有脚本可能失效，需等待作者更新或自行修复。

隐私合规风险：查询数据发送至瑞典官方服务器，虽仅包含位置信息无个人身份数据，但跨境数据传输需符合用户所在地区数据保护法规要求。