Communitygithub.com

AichenFilm/travel-price-planner-skill

一个用于比较航班、酒店、火车及混合行程的Codex技能,基于总成本和风险进行评估。

travel-price-planner-skill 是什么?

Travel Price Planner 是一个专为 AI 编码代理(如 Codex)设计的技能,用于智能比较旅行选项。它不仅仅比较裸价,而是综合评估最终支付成本、附加服务、行程匹配度、出票方、售后服务、退改签条款以及中转或停留风险,从而推荐最佳预订路径。该技能支持航班、酒店、火车以及混合行程的搜索与比较,推荐使用元搜索引擎(如 Google Flights)进行初步发现,然后通过官方渠道验证关键行程。它包含一个用于标准化手动收集的报价数据的 CSV 规范化脚本,并提供一个清晰的推荐等级系统(推荐、最便宜可接受、可选、更便宜但有风险、避免),帮助用户做出明智决策。该技能明确禁止执行预订、支付、登录或任何涉及个人数据操作的行为,在购买前必须获得用户的明确确认。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add AichenFilm/travel-price-planner-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

旅行价格规划器

核心规则

寻找最低合理选项,而非最低裸价。在推荐预订路径之前,比较最终应付成本、必需附加服务、行程匹配度、出票方、售后服务、退款/改签/取消条款以及中转或停留风险。

不要进行预订、支付、登录、输入个人数据、存储凭证、绕过验证码,或使用隐身/反检测抓取。在购买或账户操作前停止,并要求用户明确确认。

工作流程

  1. 仅收集缺失的高影响约束:日期灵活性、出发地/目的地灵活性、旅客人数、行李、必须到达时间、预算上限、退款需求、支付货币、签证/中转限制、住宿区域、取消需求以及铁路时间偏好。
  2. 当用户未说明其偏好或当你需要可重用的偏好模板时,阅读 references/default-preferences.md。
  3. 阅读 references/source-matrix.md,根据旅行类型和区域选择搜索来源。
  4. 通过普通网页或浏览器访问检查实时价格,当最终验证重要时优先使用官方来源。记录来源 URL、时间戳和时区、货币、最终显示总价、出票/预订方、行李或早餐、取消/退款/改签条款以及可见费用。
  5. 当选项涉及 OTA 预订、自行中转、分开机票、行李不明确、不可退款住宿、铁路代理、中转国家、异常折扣、仅登录可见价格或处于波动事件期间时,阅读 references/risk-rules.md。
  6. 阅读 references/scoring-model.md,根据总成本和预订风险对选项进行排名。
  7. 如果有许多报价行,则组装一个 CSV 并运行 scripts/normalize_travel_quotes.py 以生成确定性的比较表。该脚本仅规范化手动收集的报价;它不会获取实时价格。
  8. 提供推荐,包括:最佳整体选项、最便宜可接受选项、应避免的选项、精确预订路径以及在最终结账页面上需要验证的内容。

来源策略

  • 航班:首先使用元搜索来源(如 Google Flights)进行日期和航线的发现,然后在航空公司官方网站上验证最强行程。仅在使用 OTA 和二级元搜索来源时检查是否存在有意义的价差。
  • 酒店:首先使用地图或酒店元搜索来源进行区域和价格范围的发现,然后比较主要 OTA 和物业官方网站。比较最终税费、房型、取消政策、押金、早餐以及位置调整后的交通费用。
  • 火车:优先考虑官方铁路运营商以获取票价等级和规则。使用 Trainline、Omio、Trip.com 或类似代理商进行比较、便利或多模式发现。
  • API(如 Skyscanner、Amadeus、Duffel、Hotelbeds 或 Expedia Rapid)需要合法账户和用户提供的环境变量。不要虚构 API 访问权限,或在其未配置时暗示实时 API 覆盖。

输出标准

区分以下等级:

  • 推荐:最佳总成本/风险平衡。
  • 最便宜可接受:最便宜但仍可实际预订的选项。
  • 可选:可接受,但既不是整体最强也不是最便宜可接受的选项。
  • 更便宜但有风险:价格较低,但存在实质性的售后、退款、行李、中转、签证或隐藏费用风险。
  • 避免:除非用户明确接受风险,否则不建议。

对于每个推荐选项,包含一个具体的预订路径,例如 Google Flights -> 航空公司官方网站、Booking.com 可退款价格、Trenitalia 官方网站 或 12306 官方网站。

当精度重要时,保留原始语言的票价规则、取消文本、行李规则和平台名称,然后用用户的语言进行清晰解释。

脚本使用

收集报价行后使用规范化器:

python3 /path/to/travel-price-planner/scripts/normalize_travel_quotes.py quotes.csv --base-currency EUR --fx USD=0.92 --fx CNY=0.127 --direct-margin 50 --format markdown

将脚本路径解析为相对于此技能目录的路径。不要假设当前工作目录是技能目录。

最小有用的 CSV 列:

label,category,source,currency,total_price,mandatory_fees,baggage_fee,payment_fee,local_transport_cost,risk_flags,booking_party,url,notes

风险标志以分号分隔,例如 ota;no_checked_bag;self_transfer;nonrefundable。

最终安全检查

在推荐“立即预订”之前,如果可访问,请在结账或官方详情页面上验证该选项,然后注明时间戳。如果最终结账页面无法在不登录或输入个人数据的情况下访问,请说明并将价格视为临时价格。

相关技能