mcpField
T
trip-planner

trip-planner

github.com/borski生产力80087 次安装5 天前更新
代码仓库

关于 trip-planner

面向旅行规划的编排技能,适用于同时安排航班和住宿的行程。它协调机票、酒店、积分转点及旅行计算技能,汇总现金与积分方案的总成本。

主要功能

  1. 01协调机票与酒店搜索
  2. 02汇总不同方案的旅行成本
  3. 03比较现金与积分选项
  4. 04计算全程积分价值
  5. 05报告搜索来源的失败情况

适用场景

  1. 01规划包含航班和住宿的旅行
  2. 02比较现金支出与积分方案
  3. 03整理目的地行程总成本

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/borski/travel-hacking-toolkit --skill trip-planner

安装后在 Claude Code 中输入/trip-planner确认已加载。

详细介绍

配套参考技能。 加载这些技能以获取更深入的背景信息:

  • flight-search-strategy — 完整的搜索工作流和来源优先级
  • lessons-learned — Seats.aero 工作流和常见失败模式(进行任何里程奖励搜索前加载)
  • points-valuations — CPP 规则、机会成本
  • partner-awards — 通过联盟及双边合作伙伴关系查询可用性
  • award-sweet-spots — 标记经典兑换方案
  • booking-guidance — 预订流程 + 电话号码 + “转点前先保留”的规则
  • transfer-bonuses — 实时转点奖励(每周更新),建议转点前加载
  • stopovers — 各计划的经停规则;无需额外里程即可将单次行程规划变为多城市行程
  • award-holds — 各计划的奖励机票保留规则;会影响转点时机决策
  • round-the-world — 当行程需求包含 3 个或更多经停点或多个地区时,环球旅行产品可能比单独兑换更便宜
  • status-match — 用户提到想获得会籍或询问精英会籍捷径时使用;涵盖免费直接匹配、付费礼宾服务费用以及每人终身仅可申请一次的警告

行程规划器

“规划 8 月 11 日至 15 日去巴黎的行程”——给出一份完整的费用明细。

将 compare-flights、compare-hotels、transfer-partners 和 trip-calculator 协调为统一的行程分析。展示现金支付与所有可用积分方案下的行程总费用。

这是一项编排技能。 它会告知 Agent 应调用哪些技能,以及如何整合它们的输出。

适用场景

  • “规划 8 月 11 日至 15 日去巴黎的行程”
  • “9 月去东京一周,从 SFO 出发最便宜的方式是什么?”
  • “去斯德哥尔摩旅行,用积分和现金分别要花多少钱?”
  • 任何同时涉及航班和住宿的请求

不适用场景

  • 仅比较航班(使用 compare-flights)
  • 仅比较酒店(使用 compare-hotels)
  • 奖励机票日历(使用 award-calendar)
  • 未指定具体行程而询问“我该用积分吗?”(使用 trip-calculator)

工作流

步骤 1:解析行程参数

从用户请求中提取:

参数示例必填
出发地SFO是
目的地巴黎 / CDG是
出发日期2026-08-11是
返程日期2026-08-15是(未提供时假设为单程)
旅客人数2 位成人默认:1
客舱等级商务舱默认:经济舱
偏好FHR 酒店、直飞航班可选

如果有任何不明确之处,请询问。不要猜测日期或旅客人数。

步骤 2:并行运行搜索

同时启动所有搜索。不要等一个搜索完成后才开始另一个。

PARALLEL:
  1. compare-flights: origin → destination, departure date, cabin
  2. compare-flights: destination → origin, return date, cabin (if round-trip)
  3. compare-hotels: destination, checkin = departure, checkout = return

这些搜索各自会在内部并行运行子搜索(Duffel、Ignav、seats.aero、Chase、Amex、SerpAPI、Trivago、LiteAPI、Airbnb 等)。

步骤 3:汇总为行程费用矩阵

创建一张表,显示每种策略的行程总费用。

对每种预订策略,计算总费用 = 去程 + 返程 + 酒店:

策略去程返程酒店(4 晚)总计使用积分自付现金
全现金$4,200$3,800$1,200$9,2000$9,200
航班:奖励机票,酒店:现金$120 税费$95 税费$1,200$1,415110,000 UR$1,415
航班:奖励机票,酒店:FHR$120 税费$95 税费$8,284(通过积分支付)$8,499110,000 UR + 828,400 MR$215
航班:Chase 门户,酒店:Edit———视情况而定540,000 UR$0
航班:奖励机票,酒店:Airbnb$120 税费$95 税费$780$995110,000 UR$995
步骤 4:计算价值评分

对每种策略,计算:

Points value = (all-cash total - cash out of pocket) / total points used × 100

这会告诉你整个行程获得的 CPP,而不只是某个单项的 CPP。

示例:

"Flights: award + Hotel: Airbnb"
All-cash equivalent: $9,200
Cash out of pocket: $995
Points saved: $9,200 - $995 = $8,205
Points used: 110,000 UR
Trip CPP: $8,205 / 110,000 × 100 = 7.5 cpp
步骤 5:呈现行程方案
行程:SFO → Paris,8 月 11-15 日,2 位成人,商务舱

✈️ 去程:SFO → CDG,8 月 11 日

选项来源价格/积分货币
现金(最低价)Duffel$4,200—
Flying Blueseats.aero55,000 + $120 税费Chase UR(1:1)
Chase Portal Boostchase-travel180,000Chase UR

✈️ 返程:CDG → SFO,8 月 15 日

选项来源价格/积分货币
现金(最低价)Duffel$3,800—
Aeroplanseats.aero70,000 + $200 税费Chase UR(1:1)

🏨 酒店:Paris,8 月 11-15 日(4 晚)

选项来源每晚总计积分礼遇
SO/ Paris [EDIT]Chase$639$2,555127,756 UR早餐、$100 抵用金
Le Bristol [FHR]Amex$1,849$8,284828,400 MR$100 抵用金、早餐、升级
Marriott ChampsSerpAPI$289$1,156——
Airbnb:Marais 2BRAirbnb$195$780—厨房

💰 按策略划分的行程总费用

#策略现金总额积分CPP评价
1奖励机票(FB+AC)+ Airbnb$1,115125,000 UR6.5⭐ 最划算
2奖励机票 + Chase Edit 酒店$2,870252,756 UR2.5方便舒适
3全现金支付$8,1360—基准方案
4Chase 门户机票 + Edit 酒店$0487,756 UR1.7消耗积分最多
5奖励机票 + FHR 酒店$8,599125,000 UR + 828,400 MR混合奢华体验

🎯 建议:

通过 Flying Blue(去程)+ Aeroplan(返程)兑换奖励机票 = 使用 125,000 Chase UR,兑换价值 $8,000 的商务舱机票。每分价值为 6.4 美分。非常划算。

酒店方面:Chase Edit 的 SO/ Paris 含早餐和 $100 抵用金,价格为 $2,555(或通过 Boost 使用 127,756 UR,按每分 2.0 美分计算)。Airbnb 最便宜,价格为 $780,但不含早餐或酒店设施。

综合最佳:奖励机票 + Airbnb,适合希望最大限度节省费用的情况。奖励机票 + Chase Edit,适合希望享受酒店体验和礼遇的情况。

第 6 步:来源状态

始终说明哪些来源查询成功、哪些失败:

✅ Duffel: 45 outbound, 38 return
✅ Ignav: 40 outbound, 35 return
✅ Seats.aero: 12 award options outbound, 8 return
✅ Chase Travel: 300 outbound flights, 21 hotels
✅ Amex Travel: 292 outbound flights, 17 hotels
✅ SerpAPI: 25 hotels
✅ Trivago: 30 hotels
✅ LiteAPI: 22 hotels
✅ Airbnb: 18 listings
✅ Google Flights: 52 outbound
⏭️ Southwest: skipped (no SFO-CDG service)

错误处理

绝不要默默失败。 如果任何子查询失败,请注明并继续使用已有信息。

如果机票查询失败,但酒店查询成功(反之亦然),请展示已有信息并注明缺失部分:

❌ Seats.aero: API timeout. Award flight pricing unavailable.
    Trip totals shown are cash-only and portal-only. Retry seats.aero for award options.

如果某个项目的所有来源都查询失败,请明确说明:

❌ All hotel sources failed. Cannot calculate trip total. Fix hotel search, then rerun.

限制

  • Duffel/Ignav 的往返现金价格可能比购买两张单程票更便宜。如果确实如此,请注明。
  • 奖励机票价格按单程计算。去程与返程奖励机票的总成本才是与往返现金票价正确比较的数值。
  • 门户预订与直接预订的酒店价格可能不同。若差异显著,请注明。
  • Chase 门户价格采用动态 Points Boost(部分预订约为每分 1.5-2.0 美分,并非有保证的最低值)。过去固定的 1.5 倍乘数已取消。请获取实际报价。
  • 行程总费用为估算值。税费、手续费和汇率都可能导致实际预订费用变化。

评论

支持 Markdown