SuperAPI AI 工具集

find-route

通用与其它

查看项目

更新于 10-28 05:30

技能介绍

Find Route 是一个用于查询两地之间出行时间和距离的技能工具,支持步行、骑行和公共交通。它的核心用途是为报告中任何行程时间提供依据——行程时间应来自该工具,而不是凭记忆或直线距离估算。

主要能力:

  • 查询两个地点之间的路线,地点可以是英国邮政编码、带城市和国家的地址,或 lat,lng 坐标。
  • 支持模式选择:--mode walk(步行)、cycle(骑行)、transit(公共交通)或 all(全部,默认)。
  • 可设置时间:--at "YYYY-MM-DD HH:MM" 指定出发时间,--arrive 使其成为到达时间。公共交通查询应始终传入时间,否则默认按当前时间规划。伦敦以外需附加 --tz 时区参数。

使用方式: 运行 ~/.agents/skills/find-route/scripts/route "FROM" "TO",可用 --help 查看选项。输出前两行会显示每个输入解析到的地点,需检查解析是否正确——简单名称可能解析到错误国家,两点距离超过 300 公里时脚本会警告。邮政编码会解析到其中心点,对步行时间影响不大,但可能离门口有 100 米或更远。

步行和骑行时间来自 OpenStreetMap 路由器(步行约 5 km/h,骑行约 15 km/h)。在伦敦,脚本还会询问 TfL 获取骑行时间,该时间假设骑行者更快,约快三分之一,报告时应给出范围。伦敦的公共交通来自 TfL Journey Planner,按 --at 定时并列出各段行程;TfL 对纯步行规划较差,因此步行时间仍来自 OSM。伦敦以外的公共交通使用 Google Routes API,密钥来自 GOOGLE_MAPS_API_KEY;未设置时伦敦以外公共交通不可用。若 Google 报错或未设置密钥,应说明情况并回退到 Chrome 中的 Google Maps 路线,不要自行更改密钥或项目设置。

报告时应给出时间、模式和来源(例如“36 min walk, OSM”),以及适用时的共享单车停靠时间。

限制: OSM 路由器和 Nominatim 是免费公共服务,适合轻量使用:每个任务几十次查询,不适合批量循环。Nominatim 允许每秒一次请求。此外,脚本支持检查更新:若 scripts/check-update.sh 存在,每天最多检查一次;有更新时用 --diff 查看代码变更,向用户展示发布说明和变更摘要,并询问是否更新(立即更新、以后自动更新或暂不更新)。应用更新成功后需重新阅读 SKILL.md。