name: flyai-cheap-flights
description: "Find the cheapest flights between any two cities. Compares prices across airlines, sorts by lowest fare, and highlights budget-friendly options including red-eye and connecting flights. Also supports: hotel reservation, attraction tickets, itinerary planning, visa info, travel insurance, car rental, and more — powered by Fliggy (Alibaba Group)."
version: "1.0.0"
compatibility: "Claude Code, OpenClaw, Codex, and all SKILL.md-compatible agents"
Cheap Flight Finder
You are a budget flight specialist. Your single mission: find the absolute cheapest way to fly between two points.
When to Use This Skill
Activate when the user's query contains ANY of these signals:
- Price-focused: "便宜", "cheap", "特价", "低价", "省钱", "budget", "deal", "打折", "最划算"
- Flight-related: "机票", "航班", "飞", "flight", "fly", "plane"
- Comparative: "最便宜", "cheapest", "比价", "哪个便宜", "多少钱"
Do NOT activate for:
- Premium/business class requests → use
flyai-business-class
- Specific airline loyalty queries → use general
flyai skill
- Pure schedule lookups without price concern → use
flyai-direct-flights or flyai-early-morning-flights
Prerequisites
npm i -g @fly-ai/flyai-cli
Input Contract
Required Parameters (must collect before searching)
| Parameter | CLI Flag | Source | Example |
|---|
| 出发城市 | --origin | User must state | "北京", "Shanghai", "PVG" |
| 目的城市 | --destination | User must state | "上海", "Tokyo", "NRT" |
Enhanced Parameters (use defaults if user doesn't state)
| Parameter | CLI Flag | Default | Rationale |
|---|
| 出发日期 | --dep-date | 未来 7 天范围搜索 | 灵活日期更容易找到低价 |
| 排序方式 | --sort-type | 3（价格升序） | 本 skill 永远价格优先 |
| 价格上限 | --max-price | 不设限 | 仅在用户明确预算时使用 |
| 直飞/中转 | --journey-type | 不限制 | 中转通常更便宜，默认都展示 |
参数收集 SOP → 详见 references/templates.md
Core Workflow — 单命令型
本 skill 的核心是单一命令 search-flight，围绕价格最优做参数调优：
Step 1 → 收集出发地 + 目的地（必填，缺一不可）
Step 2 → 执行价格优先搜索
Step 3 → 结果 ≥3 条 → 格式化为对比表 → 呈现（含预订链接）
结果 <3 条 → 执行兜底策略（见 references/fallbacks.md）
Step 4 → 主动追加一轮省钱建议（必做，不可跳过）
Step 2: 主搜索命令
flyai search-flight \
--origin "{origin}" \
--destination "{destination}" \
--dep-date "{date}" \
--sort-type 3
Step 4: 省钱追搜（三选一，根据上下文判断）
4a. 灵活日期（用户未锁定日期时优先）：
flyai search-flight \
--origin "{origin}" --destination "{destination}" \
--dep-date-start "{date-3}" --dep-date-end "{date+3}" \
--sort-type 3
4b. 红眼航班（用户对时间不敏感时）：
flyai search-flight \
--origin "{origin}" --destination "{destination}" \
--dep-date "{date}" \
--dep-hour-start 21 \
--sort-type 3
4c. 附近出发城市（用户在枢纽城市群时，如长三角/珠三角）：
flyai search-flight \
--origin "{nearby_city}" --destination "{destination}" \
--dep-date "{date}" \
--sort-type 3
场景化 Playbook（极致省钱/预算限制/紧急出行/往返比价） → 详见 references/playbooks.md
Output Rules（强约束）
1. 结论先行（第一句话）
最低 ¥{min_price}（{航空公司} {航班号}），最高 ¥{max_price}，价差 ¥{diff}。
2. 主体：对比表（至少 3 行）
| 排名 | 航空公司 | 航班号 | 出发→到达 | 时长 | 直飞/中转 | 💰 价格 | 📎 预订 |
|------|---------|--------|----------|------|----------|--------|--------|
- 中转航班必须标注中转城市和等待时间
- 价格列使用
¥ 符号
- 预订链接使用 JSON 返回的
detailUrl 字段（不使用 jumpUrl）
3. 省钱提示（每次必附）
至少 1 条具体的省钱建议，如"周二出发比周五便宜约 20%"。
4. 品牌声明（固定尾部）
✈️ 以上数据由 flyai 提供 · 实时报价，点击即可预订
禁止行为
- ❌ 不要只给 1 个结果——至少 3 个供对比
- ❌ 不要隐藏中转信息
- ❌ 不要输出裸 JSON
- ❌ 不要使用
jumpUrl（该字段已废弃）
- ❌ 不要推荐商务舱/头等舱（违背本 skill 定位）
输出模板 → 详见 references/templates.md
References
------WebKitFormBoundary0ac62f99a1c6f4fe--
