Communitygithub.com

AichenFilm/旅行價格規劃工具

一個用於比較航班、旅館、火車與混合行程的 Codex 技能,依據總成本與風險提供建議。

旅行價格規劃工具 是什麼?

此技能提供一個結構化工作流程,協助 AI 代理(例如 Codex)比較多種交通與住宿選項的總成本與風險,而非僅看最低標價。它整合了航班、旅館與火車的來源策略,優先選用官方網站驗證,再輔以 OTA 與元搜尋引擎進行比價。技能內建風險評估模型、正常化腳本與輸出分級(推薦、最便宜可接受、較便宜但有風險、應避免),確保推薦時附上確切的預訂路徑及最終檢查事項。支援平台包含 Google Flights、Booking.com、Trenitalia、12306 等,並可透過環境變數設定 Skyscanner、Amadeus 等 API(需合法帳號)。此技能特別適合需要綜合比較機加酒、多段火車或自轉機行程的使用者,能顯著降低規劃時間與隱藏成本。

相容平台~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. 透過一般網頁或瀏覽器存取即時價格,若最終驗證重要則優先使用官方來源。記錄來源網址、時間戳記與時區、貨幣、最終顯示總額、出票/預訂方、行李或早餐、取消/退款/更改條款,以及可見費用。
  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 或類似代理商進行比較、便利性或多模式探索。
  • 諸如 Skyscanner、Amadeus、Duffel、Hotelbeds 或 Expedia Rapid 等 API 需要合法帳號及使用者提供的環境變數。請勿捏造 API 存取權限或暗示未設定的即時 API 覆蓋範圍。

輸出標準

區分以下層級:

  • recommended:最佳總成本/風險平衡。
  • cheapest acceptable:最便宜但實際上仍可預訂的選項。
  • optional:可接受,但既非最強整體選項,也非最便宜可接受選項。
  • cheaper but risky:價格較低,但存在重大的售後服務、退款、行李、轉機、簽證或隱藏費用風險。
  • avoid:除非使用者明確接受風險,否則不推薦。

針對每個推薦選項,應包含具體的預訂路徑,例如 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。

最終安全檢查

在推薦「立即預訂」之前,若可達,請在結帳或官方詳細頁面驗證選項,然後記錄時間戳記。若無法在不登入或輸入個人資料的情況下到達最終結帳頁面,請說明情況並將價格視為暫時性。

相關技能