flightAI
AI机票助手 - 实现国内航班搜索、舱位查询、预订下单、机票改期、机票退票。适用于用户询问航班、查询机票价格、提交机票订单、改期航班、退票时使用。
Install / Use
npx skills add LeoYeAI/openclaw-master-skills --skill ai-flightInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of flightAI
flightAI scores 87/100 on our quality scale, 2162nd of 4,698 Development & Engineering skills we index (top 47%).
Its SKILL.md is 15 KB long, well organised into 36 sections with 37 code examples: a thorough specification that gives an agent plenty to work with.
With 2,149 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-02 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
flightAI compared with similar skills
All 4 of these similar skills score higher than flightAI; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| flightAI (this skill)by LeoYeAI | 87 | 2.1k | 4mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install flightAI?
- Run
npx skills add LeoYeAI/openclaw-master-skills --skill flightAI. The install tabs above show the steps for each supported agent. - Which AI agents does flightAI work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is flightAI safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is flightAI still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: flightAI description: AI机票助手 - 实现国内航班搜索、舱位查询、预订下单、机票改期、机票退票。适用于用户询问航班、查询机票价格、提交机票订单、改期航班、退票时使用。 version: 1.0.0 metadata: {"openclaw": {"emoji": "✈️", "category": "travel", "tags": ["机票", "航班", "预订", "改期", "退票"], "requires": {"bins": ["python3"]}, "required": true}}
AI机票助手
当用户询问航班搜索、舱位查询、机票预订、机票改期或机票退票时,使用此 skill 调用AI机票服务。
运行环境要求
本 skill 通过 python3 执行 HTTP POST 请求调用AI机票服务。运行环境必须提供 python3。
隐私与个人信息(PII)说明
预订功能会将用户提供的个人信息(乘客姓名、手机号、证件号等)通过 HTTP POST 发送至AI机票服务,以完成机票预订。使用本 skill 即表示用户知晓并同意上述 PII 被发送到外部服务。请勿在日志或回复中暴露用户个人信息。
可用工具
重要:下方示例中的参数均为占位,调用时需根据用户当前需求填入实际值(城市、日期、航班号、乘机人、联系方式等),勿直接照抄示例值。
适用场景
- 按出发/到达城市、日期搜索航班列表
- 查看指定航班的舱位价格详情
- 用户确认后创建机票预订订单
- 查询已创建订单的详细信息
- 用户确认后改期或退票已创建订单的航班
鉴权流程(必须先完成)
重要:使用任何功能前,用户必须先完成鉴权流程。鉴权成功后获得的 apiKey 会自动保存在用户主目录的 ~/.fbt_auth.json 文件中,新会话会自动沿用。
鉴权步骤
- 发送验证码:用户提供手机号,系统发送验证码到手机
- 验证并获取 apiKey:用户输入验证码,验证成功后获得 apiKey
- 自动注入:后续所有 API 调用会自动携带 apiKey
鉴权命令
1. 发送验证码
python3 scripts/auth.py send <phone>
示例:
python3 scripts/auth.py send 13800138000
2. 验证并获取 apiKey
python3 scripts/auth.py verify <phone> <code>
示例:
python3 scripts/auth.py verify 13800138000 123456
3. 查看鉴权状态
python3 scripts/auth.py status
鉴权检查规则
- 在执行任何航班查询、预订、改期、退票操作前,必须先检查鉴权状态
- 如果未鉴权或 apiKey 已过期,必须引导用户完成鉴权流程
- 鉴权成功后,所有 API 调用会自动携带 apiKey,无需手动传递
1. 航班搜索 (searchFlight)
功能:查询国内航班列表
必填参数:
start_code: 出发城市名称(如 北京、上海、广州)end_code: 到达城市名称date: 出发日期(格式 YYYY-MM-DD)
触发词:某地到某地航班、查机票、搜航班、机票价格
执行命令:
python3 scripts/search_flights.py <start_code> <end_code> <date>
示例:
python3 scripts/search_flights.py 北京 上海 2026-03-15
返回结果:航班列表(航班号、航空公司、起降时间、机型、机场、最低价等)
上下文检查规则:
- 如果用户在当前或之前的消息中已经提供了某个参数,则无需再次询问该参数
- 只向用户询问尚未提供的参数
- 如果所有参数都已提供,直接发起请求
展示要求:
- 必须使用代码块包裹脚本输出的表格
- 必须展示完整表格
- 参考"输出格式要求"章节的标准格式
2. 舱位详情查询 (searchPrice)
功能:查询特定航班的详细价格信息
必填参数:
start_code: 出发机场三字码(从 searchFlight 响应结果中获取)end_code: 到达机场三字码(从 searchFlight 响应结果中获取)date: 出发日期(格式 YYYY-MM-DD)flight_no: 航班号
触发词:查看航班详情、这个航班的舱位价格
执行命令:
python3 scripts/search_price.py <start_code> <end_code> <date> <flight_no>
示例:
python3 scripts/search_price.py PEK PVG 2026-03-15 CA1501
返回结果:该航班的各舱位价格、折扣、退改签规则等详细信息,并将舱位信息保存到 /tmp/flight_seat_items.json 供下单使用
使用场景:用户先使用航班搜索查询航班列表,从返回的航班列表中选择某个航班后,使用此功能查询该航班的详细价格信息
展示要求:
- 必须使用代码块包裹脚本输出的表格
- 必须展示完整表格
- 参考"输出格式要求"章节的标准格式
3. 退改规则和行李额查询 (searchGuestRule)
功能:查询指定舱位的详细退改签规则和行李额
必填参数:
seat_index: 舱位编号(从舱位详情查询结果中选择,如 1、2、3)
触发词:退改规则、退票规则、改签规则、这个舱位的退改政策、行李额、客规
执行命令:
python3 scripts/search_guest_rule.py <seat_index>
示例:
python3 scripts/search_guest_rule.py 1
返回结果:该舱位的退票、改签、行李额等详细规则说明
重要说明:
- 此功能为可选流程,仅在用户明确询问退改规则时调用
seat_index必须来自最近一次舱位详情查询的结果- 舱位信息从
/tmp/flight_seat_items.json文件中读取 - 如果文件不存在或舱位编号无效,会提示用户先执行舱位详情查询
4. 机票下单 (createOrder)
功能:创建机票订单
必填参数:
seat_index: 舱位编号(从上一步舱位详情查询结果中选择,如 1、2、3)passenger_name: 乘客姓名passenger_phone: 乘客手机号passenger_id: 乘客证件号
触发词:订这个、预订、下单
执行命令:
python3 scripts/create_order.py <seat_index> <passenger_name> <passenger_phone> <passenger_id>
示例:
python3 scripts/create_order.py 1 "张三" "13800138000" "110101199001011234"
返回结果:订单号、支付链接、订单详情链接等
重要说明:
seat_index必须来自最近一次舱位详情查询的结果- 舱位信息从
/tmp/flight_seat_items.json文件中读取 - 如果文件不存在或舱位编号无效,会提示用户先执行舱位详情查询
- 必须向用户索取乘客姓名、手机号和证件号,不可使用默认值或跳过
5. 订单详情查询 (orderDetail)
功能:查询已创建订单的详细信息
必填参数:
order_id: 订单号(从下单接口返回的订单号中获取)
触发词:订单详情、查看订单、查询订单、订单状态
执行命令:
python3 scripts/order_detail.py <order_id>
示例:
python3 scripts/order_detail.py 69a677bee4b0252bd532e35c
返回结果:订单的详细信息,包括航班信息、乘客信息、支付状态等
重要说明:
- 订单号可以从下单接口的返回结果中获取
- 此功能可用于查询订单的实时状态和详细信息
6. 取消订单 (cancelOrder)
功能:取消待支付状态的订单
必填参数:
order_id: 订单号(从下单接口返回的订单号中获取)
触发词:取消订单、不要了、取消这个订单
执行命令:
python3 scripts/cancel_order.py <order_id>
示例:
python3 scripts/cancel_order.py 69a677bee4b0252bd532e35c
返回结果:取消成功或失败
重要说明:
- 此功能仅适用于待支付状态的订单
- 订单号可以从下单接口的返回结果中获取
- 已支付或已出票的订单无法通过此接口取消,需要使用退票功能
7. 改期航班搜索 (endorseSearchFlight)
功能:查询可改期的航班列表
必填参数:
order_id: 订单号(从订单详情或下单接口返回的订单号中获取)dep_date: 改期日期(格式 YYYY-MM-DD,需要向用户索取)
触发词:改期、改签、换航班、查改期航班
执行命令:
python3 scripts/endorse_search_flight.py <order_id> <dep_date>
示例:
python3 scripts/endorse_search_flight.py 69a677bee4b0252bd532e35c 2026-03-20
返回结果:可改期的航班列表(航班号、航空公司、起降时间、机场、最低价等)
重要说明:
- 订单号可以从订单详情接口获取
- 改期日期需要向用户索取
- 此接口会自动从订单详情中提取 flight_no(从 segmentInfo.flight_no 获取)和 ticket_ids(从 passengerList[0].productId 获取)
- 返回的航班列表格式与航班搜索接口一致,方便用户选择
展示要求:
- 必须使用代码块包裹脚本输出的表格
- 必须展示完整表格
- 参考"输出格式要求"章节的标准格式
8. 改期舱位详情查询 (endorseSearchPrice)
功能:查询指定改期航班的舱位价格详情(改期费、机票差价费等)
必填参数:
order_id: 订单号(从订单详情或下单接口返回的订单号中获取)dep_date: 改期日期(格式 YYYY-MM-DD,与改期航班搜索时使用的日期一致)flight_no: 航班号(从改期航班搜索结果中选择)
触发词:查看改期价格、这个航班的改期费、改期舱位详情
执行命令:
python3 scripts/endorse_search_price.py <order_id> <dep_date> <flight_no>
示例:
python3 scripts/endorse_search_price.py 69a677bee4b0252bd532e35c 2026-03-20 HU7603
返回结果:该航班的各舱位改期费、机票差价费、预估总改期费等详细信息,并将舱位信息保存到 /tmp/endorse_seat_items.json 供改期下单使用
重要说明:
- 此接口必须在改期航班搜索之后调用
- flight_no 必须来自改期航班搜索返回的航班列表,需要用户选择
- 此接口会自动从订单详情中提取 ticket_ids(从 passengerList[0].productId 获取)
- 展示的改期费用信息包括:改期费、机票差价费、预估总改期费
- 舱位信息会保存到临时文件供后续改期下单使用
展示要求:
- 必须使用代码块包裹脚本输出的表格
- 必须展示完整表格
- 参考"输出格式要求"章节的标准格式
9. 提交改期申请 (endorseApply)
功能:提交改期申请,创建改期订单
必填参数:
seat_index: 舱位编号(从改期舱位详情查询结果中选择,如 1、2、3)order_id: 原订单号(从订单详情或下单接口返回的订单号中获取)
触发词:确认改期、提交改期申请、改期下单
执行命令:
python3 scripts/endorse_apply.py <seat_index> <order_id>
示例:
python3 scripts/endorse_apply.py 1 69a677bee4b0252bd532e35c
返回结果:改期单订单号、支付链接、订单详情链接等
重要说明:
seat_index必须来自最近一次改期舱位详情查询的结果- 舱位信息从
/tmp/endorse_seat_items.json文件中读取 - 如果文件不存在或舱位编号无效,会提示用户先执行改期舱位详情查询
- 改期申请成功后会返回新的改期单订单号,需要用户完成支付
10. 预估退票费查询 (refundFeeDetail)
功能:查询退票费用详情
必填参数:
order_id: 订单号(从订单详情或下单接口返回的订单号中获取)
触发词:查询退票费、退票费用、预估退票费
执行命令:
python3 scripts/refund_fee_detail.py <order_id>
示例:
python3 scripts/refund_fee_detail.py 69a677bee4b0252bd532e35c
返回结果:预估退票费(单票)
重要说明:
- 此接口用于在退票前预估退票费用
- 用户需要确认退票费用后才能提交退票申请
- 返回的 refund_amount 需要在提交退票申请时使用
11. 提交退票申请 (refundApply)
功能:提交退票申请
必填参数:
order_id: 订单号(从订单详情或下单接口返回的订单号中获取)refund_amount: 预估退票费(从预估退票费查询接口返回的 refund_amount 获取)
触发词:确认退票、提交退票申请、退票
执行命令:
python3 scripts/refund_apply.py <order_id> <refund_amount>
示例:
python3 scripts/refund_apply.py 69a677bee4b0252bd532e35c 808
返回结果:退票申请结果、退票单号
重要说明:
- 此接口必须在预估退票费查询之后调用
- refund_amount 必须来自预估退票费查询接口返回的 refund_amount
- product_ids 会自动从订单详情中获取(从 passengerList 中提取 productId)
- 退票申请提交后需要等待审核
完整流程示例
用户:3月15号北京到上海的航班
AI 执行:
- 检查上下文,发现用户已提供出发城市(北京)、到达城市(上海)、日期(3月15号)
- 调用
search_flights.py 北京 上海 2026-03-15 - 展示航班列表
用户:看一下 CA1501 这个航班的舱位
AI 执行:
- 从上一轮结果确认航班号 CA1501,连同城市和日期
- 调用
search_price.py PEK PVG 2026-03-15 CA1501 - 展示舱位列表(价格、退改签规则等)
- 提示用户可选择舱位编号进行预订
用户:第1个舱位的退改规则是什么?(可选步骤)
AI 执行:
- 调用
search_guest_rule.py 1 - 展示该舱位的详细退改签规则
用户:订第1个,乘客张三 13800138000 110101199001011234
AI 执行:
- 从用户输入提取:seat_index=1、passenger_name=张三、passenger_phone=13800138000、passenger_id=110101199001011234
- 调用
create_order.py 1 "张三" "13800138000" "110101199001011234" - 展示订单号、支付链接等信息
- 提醒用户完成支付
用户:查看订单详情
AI 执行:
- 从上一轮结果获取订单号(如:69a677bee4b0252bd532e35c)
- 如果用户没有提供手机号,向用户索要创建订单时使用的乘机人手机号
- 调用
order_detail.py 69a677bee4b0252bd532e35c 13800138000 - 展示订单的详细信息
用户:取消订单
AI 执行:
- 从上一轮结果获取订单号和手机号
- 调用
cancel_order.py 69a677bee4b0252bd532e35c 13800138000 - 展示取消订单成功或失败的信息
用户:我想改期到3月20号
AI 执行:
- 从上一轮订单详情中获取订单号和手机号
- 向用户确认改期日期(3月20号,格式化为 2026-03-20)
- 调用
endorse_search_flight.py 69a677bee4b0252bd532e35c 13800138000 2026-03-20 - 展示可改期的航班列表
用户:看一下 HU7603 这个航班的改期价格
AI 执行:
- 从上一轮改期航班搜索结果中确认航班号 HU7603
- 调用
endorse_search_price.py 69a677bee4b0252bd532e35c 13800138000 2026-03-20 HU7603 - 展示该航班的改期舱位价格详情(改期费、机票差价费、预估总改期费等)
- 提示用户可选择舱位进行改期
用户:确认改期第1个舱位
AI 执行:
- 从上一轮改期舱位详情查询结果中确认舱位编号 1
- 调用
endorse_apply.py 1 69a677bee4b0252bd532e35c 13800138000 - 展示改期单订单号、支付链接、订单详情链接等信息
- 提醒用户完成支付
用户:我要退票
AI 执行:
- 从上一轮订单详情中获取订单号、手机号和票号
- 调用
refund_fee_detail.py 69a677bee4b0252bd532e35c 13800138000 - 展示退票费详情
- 必须强制用户确认退票费用,无论退票费是多少(包括¥0),都不得擅自提交退票申请
用户:确认退票
AI 执行:
- 从上一轮退票费查询结果中获取退款金额
- 调用
refund_apply.py 69a677bee4b0252bd532e35c 525 13800138000 - 展示退票状态、退票单号等信息
- 提醒用户等待审核
输出格式要求
🚨 强制要求:
- 禁止用自然语言改写表格内容
- 所有表格必须用
plaintext代码块包裹 - 不得省略或截断任何航班/舱位信息
航班列表展示
查询结果以表格形式平铺展示,每个航班一行,只显示最低价:
=================================================================================================
航班号 航空公司 出发时间 到达时间 出发机场 到达机场 最低价
=================================================================================================
HO2218 吉祥航空 08:45 10:55 大兴 虹桥 ¥470
MF8561 厦门航空 07:55 10:25 大兴 浦东 ¥490
=================================================================================================
共找到 X 个航班
=================================================================================================
舱位详情展示
展示各舱位价格、折扣等详细信息,并标注舱位编号供用户选择:
====================================================================================
编号 舱位 价格 折扣 机建费 燃油费 总票价 状态
====================================================================================
[1] 经济舱 ¥800 9.5 ¥50 ¥20 ¥870 余座充足
[2] 经济舱 ¥850 10 ¥50 ¥20 ¥920 余座充足
====================================================================================
退改规则展示
展示选定舱位的详细退改签规则和行李额:
====================================================================================================
舱位信息: 经济舱 | T舱 | 票面价 ¥800
====================================================================================================
【退票规则】
----------------------------------------------------------------------------------------------------
• 未使用的首个航班起飞前168小时(含)到∞小时(不含)退票时,余额再收20%退票费
----------------------------------------------------------------------------------------------------
【改期规则】
----------------------------------------------------------------------------------------------------
• 起飞前168小时以上:变更费按订座舱位公布运价10%收取
----------------------------------------------------------------------------------------------------
【签转规则】
----------------------------------------------------------------------------------------------------
不能签转
----------------------------------------------------------------------------------------------------
【行李额】
----------------------------------------------------------------------------------------------------
• 免费托运行李额:20KG,单件尺寸上限:40*60*100CM
• 免费手提行李额:5KG,单件尺寸上限:20*40*55CM
====================================================================================================
订单结果展示
展示订单号、支付链接、航班信息等关键信息:
✅ 订单创建成功!
航班信息:
- 航班号: CA1501
- 出发时间: 08:00
- 到达时间: 10:30
- 舱位: 经济舱
订单号: 69a677bee4b0252bd532e35c
支付截止时间: 23:59
💳 [立即支付](https://dwz.cn/TftO1qmp)
订单详情展示
展示订单的完整信息,包括航班信息、乘客信息、支付状态等:
====================================================================================
订单详情
====================================================================================
订单号: 69a677bee4b0252bd532e35c
订单状态: 待支付
创建时间: 2
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
