FlightAware 技能用于查询特定航班的起飞或到达时间,包括回答“我的航班什么时候起飞”以及确认用户记忆中的时间,同时支持航班状态查询。该技能无需用户连接任何账户,也无需输入密钥。可运行 flightaware status 检查是否可达,或运行 flightaware status --verify 同时确认实时读取是否正常。如果状态返回不可用,应告知用户当前设备无法访问 FlightAware,稍后重试,且绝不可向用户索要 FlightAware API 密钥。
主要能力与使用方式:
跟踪航班:使用航班号运行 flight 获取当前状态,然后使用返回的 fa_flight_id 配合 position 查询当前位置,或使用 track 查询近期路径。如需图片,可运行 map 并配合 --save <path> 保存航班的静态图像。
监控已跟踪的行程:当用户直接要求对即将到来的已预订航班进行持续监控,或运行时移交了经过验证的自动预订来源时,使用此流程。在所需航班事实齐备后,将任一触发视为授权创建监控。运行时移交后不要询问是否开始监控,不要要求连接电子邮件账户。仅向用户询问所请求监控需要且当前上下文未提供的航班事实。在安排任务前,解析每个确切的带日期航段。
搜索用户目标和 Tracking 项以找到行程。使用匹配的用户目标作为规范所有者。否则,复用匹配的活动 Tracking 项。如果两者都不存在,则创建一个 Tracking 项。在安排任务前解析规范所有者。不要创建 FlightAware 专用数据库或重复的 Tracking 项。
将最小操作状态存储在 ~/workspace/goals/<goal-slug>/hidden_files/travel/flight.json。仅将此文件用作目标拥有的任务状态。不要创建单独的旅行数据库。
在创建操作任务前,列出规范所有者的 cron 任务。如果存在等效的目标拥有操作任务,则复用。如果不存在等效任务,则为该行程添加一个操作任务。使用 flight-status-<goal-slug> 作为其标识符。将其所有者设置为 goal:<goal-slug>。在创建时,根据下一个活动航段的当前节奏带,使用实际 cron 计划安排操作任务。当下一个活动航段起飞时间距现在超过 48 小时时,使用每日 cron 计划。从起飞前 48 小时到起飞前 6 小时,使用每小时 cron 计划。从起飞前 6 小时到着陆,使用 10 到 15 分钟的 cron 计划。不要创建或保留依赖 ~/workspace/goals/<goal-slug>/hidden_files/travel/flight.json 来跳过源调用的高频 cron 计划。编写自包含的 cron 主体,因为 cron 工作器既不会收到此技能,也不会收到周围的对话。包括 Tracking 目标、~/workspace/goals/<goal-slug>/hidden_files/travel/flight.json、确切航段标识和已预订基线。包括去重规则、失败策略、节奏转换和停止条件。
在每次操作运行开始时,将现有 cron 计划与下一个活动航段的当前节奏带进行比较。当现有 cron 计划与当前节奏带不同时,在任何 FlightAware 源调用之前更新同一 cron 任务。当下一个活动航段处于高频带之外时,在任何 FlightAware 源调用之前修复现有的高频 cron 计划。保持当前节奏,直到活动航段着陆或连接风险仍未解决。将同一任务推进到下一个活动航段,然后在最终着陆后停止它。
将战略计划变更与已预订基线进行比较。将操作变更与上次通知的事实进行比较。应用规则部分中的取消佐证和状态解释规则。对于重大变动、航班或承运人变更、确认取消、备降、航站楼变更、符合条件的登机口变更、符合条件的设备变更、符合条件的延误或可信的连接风险,创建一个稳定的事件指纹。将首次延误估计达到 30 分钟或以上视为符合条件的延误。仅当仅延误变更从 30 分钟或以上跨越到少于 30 分钟、进入 30 至 59 分钟、60 至 119 分钟和 120 分钟或以上中更差的区间,或与上次通知的延误估计相差 60 分钟或以上时,才将其视为符合条件的延误。不要在仅延误指纹中包含确切的延误分钟值。将航站楼变更、机场变更、确认取消、备降和可信连接风险视为立即警报候选。仅在起飞前 24 小时内将出发登机口变更视为警报候选。仅当到达登机口变更影响连接或接机时,才将其视为警报候选。仅当设备变更影响客舱、座位或行程事实时,才将其视为警报候选。保持最终着陆静默,除非用户要求着陆通知或接机或连接影响仍然存在。在发送消息前持久化指纹。在发送消息前添加一个 Tracking 活动。不要为同一指纹添加另一个活动或消息。保持未更改的检查静默。在连续三次预期源失败后,添加一个降级覆盖活动。不要将读取失败视为没有变化的证据。当 Tracking 项完成或退役时,移除操作任务。
查找空中航班:使用 search 按出发地、目的地或区域查找空中航班。默认返回一页结果,在拉取更多之前先询问。
机场活动:使用 airport 获取机场详情,airport-delays 获取当前延误,airport-flights 获取到达和出发,airport-weather 获取天气状况。nearby-airports 查找位置附近的机场。
航空公司活动:使用 operator 获取航空公司详情,operator-flights 获取其近期和计划航班。
历史记录:对于过去的航班,使用 history 命令并指定明确的日期范围。它们涵盖航班、轨迹、航线、机场活动和飞机的最后一次航班。
预测和时刻表:使用 foresight 获取 FlightAware 的预测状态和位置,schedules 获取两个日期之间的计划航班,disruptions 获取取消和延误计数。
其他命令:上述流程涵盖常见情况。对于其他任何内容,运行 flightaware --help 获取完整命令列表,运行 flightaware <command> --help 获取命令选项。这包括飞机所有者和类型查询、航线和计数查询以及高级搜索语法。
规则:
尽可能使用航空公司的 ICAO 航班号(UAL123,而非 UA123)。如果用户的航班号有歧义,先用 canonical-flight 解析。
对于“我的航班在哪里”,先获取航班,选择正确的日期和航段,然后查询其位置或轨迹。不要猜测 fa_flight_id。
取消是高影响的最终声明。绝不要仅凭 cancelled: true 就将其报告为已确认或停止航班监控。如果航班带有 muse_cancellation_evidence.classification: conflicting_provider_fields,重新检查确切的带日期航段。如果字段仍然冲突,寻求航空公司或机场来源的确认;否则说明取消未经确认并继续监控。仅当 FlightAware 的布尔值和状态文本一致,或独立来源确认时,才将取消视为已确认。
如果 FlightAware 表示航班或飞机被屏蔽或没有数据,直接告知用户,不要试图绕过。
航班读取保留 AeroAPI 的原始时间,并添加语义 UTC/用户本地字段,如 scheduled_gate_departure_at、estimated_takeoff_at、actual_landing_at 和 scheduled_gate_arrival_at。在回复中优先使用它们的 user_local 值。位置样本类似地添加 position_observed_at。
FlightAware 不涵盖航空公司政策、航站楼地图、行李、预订或客户服务。对于这些,使用网络搜索并明确哪些细节来自网络而非 FlightAware。
用平实的语言回复航班情况,而不是你如何查找它。不要向用户显示命令、ID、令牌或原始状态代码。
限制:
无法预订旅行、购买机票、更改预订或联系航空公司或机场。
提交飞行意图会改变 FlightAware 中的状态,因此仅在用户明确要求且确切航班无歧义时才执行;无需额外确认。