关于 trip-planner
面向旅行规划的编排技能,适用于同时安排航班和住宿的行程。它协调机票、酒店、积分转点及旅行计算技能,汇总现金与积分方案的总成本。
主要功能
- 01协调机票与酒店搜索
- 02汇总不同方案的旅行成本
- 03比较现金与积分选项
- 04计算全程积分价值
- 05报告搜索来源的失败情况
适用场景
- 01规划包含航班和住宿的旅行
- 02比较现金支出与积分方案
- 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,200 | 0 | $9,200 |
| 航班:奖励机票,酒店:现金 | $120 税费 | $95 税费 | $1,200 | $1,415 | 110,000 UR | $1,415 |
| 航班:奖励机票,酒店:FHR | $120 税费 | $95 税费 | $8,284(通过积分支付) | $8,499 | 110,000 UR + 828,400 MR | $215 |
| 航班:Chase 门户,酒店:Edit | — | — | — | 视情况而定 | 540,000 UR | $0 |
| 航班:奖励机票,酒店:Airbnb | $120 税费 | $95 税费 | $780 | $995 | 110,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 Blue | seats.aero | 55,000 + $120 税费 | Chase UR(1:1) |
| Chase Portal Boost | chase-travel | 180,000 | Chase UR |
✈️ 返程:CDG → SFO,8 月 15 日
| 选项 | 来源 | 价格/积分 | 货币 |
|---|---|---|---|
| 现金(最低价) | Duffel | $3,800 | — |
| Aeroplan | seats.aero | 70,000 + $200 税费 | Chase UR(1:1) |
🏨 酒店:Paris,8 月 11-15 日(4 晚)
| 选项 | 来源 | 每晚 | 总计 | 积分 | 礼遇 |
|---|---|---|---|---|---|
| SO/ Paris [EDIT] | Chase | $639 | $2,555 | 127,756 UR | 早餐、$100 抵用金 |
| Le Bristol [FHR] | Amex | $1,849 | $8,284 | 828,400 MR | $100 抵用金、早餐、升级 |
| Marriott Champs | SerpAPI | $289 | $1,156 | — | — |
| Airbnb:Marais 2BR | Airbnb | $195 | $780 | — | 厨房 |
💰 按策略划分的行程总费用
| # | 策略 | 现金总额 | 积分 | CPP | 评价 |
|---|---|---|---|---|---|
| 1 | 奖励机票(FB+AC)+ Airbnb | $1,115 | 125,000 UR | 6.5 | ⭐ 最划算 |
| 2 | 奖励机票 + Chase Edit 酒店 | $2,870 | 252,756 UR | 2.5 | 方便舒适 |
| 3 | 全现金支付 | $8,136 | 0 | — | 基准方案 |
| 4 | Chase 门户机票 + Edit 酒店 | $0 | 487,756 UR | 1.7 | 消耗积分最多 |
| 5 | 奖励机票 + FHR 酒店 | $8,599 | 125,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 倍乘数已取消。请获取实际报价。
- 行程总费用为估算值。税费、手续费和汇率都可能导致实际预订费用变化。