Back to Details

atlas-flight-booking

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Atlas Flight Booking

Atlas Flight Booking

Operate through the Atlas Flight Booking CLI only. Preserve every opaque ID exactly. Branch on response 
code
, never 
message
, and present only normalized CLI fields.
仅通过Atlas Flight Booking CLI操作。严格保留所有不透明ID。根据响应
code
进行分支处理，绝不依据
message
，且仅展示标准化的CLI字段。

Capability questions

能力相关问题

When the user only asks what this Skill can do or how to use it, answer directly in the user's language. Do not check or install the CLI, check authorization, or call any service. Keep the answer concise and use the following structure or its natural equivalent:
“Atlas Flight Booking 支持使用自然语言查询和预订航班。你可以提供准确日期，也可以描述日期范围、时间偏好或价格要求；我会搜索并比较符合条件的航班。
例如：
  • ‘查询 9 月 4 日上海到东京的航班。’
  • ‘比较 9 月 1 日至 7 日上海到东京的最低价格。’
  • ‘找未来两周东京到大阪最便宜的上午直飞航班。’
选定航班后，还可以继续核价、选择行李和座位、创建订单、余额支付并查询出票状态。涉及涨价、座位替代或支付时，会先获得你的确认。”
Do not enumerate implementation details or unsupported after-sales operations unless the user asks for more detail.
当用户仅询问此Skill的功能或使用方法时，直接用用户的语言作答。无需检查或安装CLI、验证授权，也无需调用任何服务。回答需简洁，并遵循以下结构或其自然等效表述：
“Atlas Flight Booking 支持使用自然语言查询和预订航班。你可以提供准确日期，也可以描述日期范围、时间偏好或价格要求；我会搜索并比较符合条件的航班。
例如：
  • ‘查询 9 月 4 日上海到东京的航班。’
  • ‘比较 9 月 1 日至 7 日上海到东京的最低价格。’
  • ‘找未来两周东京到大阪最便宜的上午直飞航班。’
选定航班后，还可以继续核价、选择行李和座位、创建订单、余额支付并查询出票状态。涉及涨价、座位替代或支付时，会先获得你的确认。”
除非用户要求更多细节，否则不要列举实现细节或不支持的售后操作。

Start

启动流程

Treat 
0.3.12
as the minimum supported CLI version. Run 
atlas-flight --version
and parse the stable 
atlas-flight X.Y.Z
output. If the command is unavailable, its version output is invalid, or its version is older than 
0.3.12
, bootstrap or upgrade the required tooling immediately and continue the interrupted flight task. Do not reinstall when the installed version is 
0.3.12
or newer, and never downgrade a newer CLI. Do not ask conversational permission to install or upgrade it: the user's request to use this Skill authorizes installation of its required CLI. Allow any native execution-approval prompt from the host to appear, but do not add a separate permission question.
If 
uv
is unavailable, detect the operating system and run the applicable official standalone installer:
  • macOS or Linux: 
    curl -LsSf https://astral.sh/uv/install.sh | sh
    ; use 
    wget -qO- https://astral.sh/uv/install.sh | sh
    only when 
    curl
    is unavailable.
  • Windows: 
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    .
Use the newly installed executable in the current session, including 
$HOME/.local/bin/uv
on macOS/Linux or 
$HOME\.local\bin\uv.exe
on Windows when 
uv
is not yet on 
PATH
. Run exactly 
uv tool install --force --python 3.12 atlas-flight-booking==0.3.12
, using that resolved executable path when the CLI is missing, invalid, or older than the minimum supported version. If 
atlas-flight
is not yet on 
PATH
, resolve the tool binary directory with 
uv tool dir --bin
and invoke 
atlas-flight
from there; do not ask the user to restart the terminal. Verify that 
atlas-flight --version
now reports 
0.3.12
or newer and continue. Only stop when the automatic installation or upgrade actually fails; then give one concise failure explanation and the official 
https://docs.astral.sh/uv/getting-started/installation/
link. Do not fall back to another Python environment or package manager.
Then run 
atlas-flight auth status --json
. Retain 
data.ticketing_activation_url
and 
data.ticketing_blocker
only when returned; never invent or derive either field. If authorization is required, follow 
references/cli-contract.md
. Explain that Atlas authorization is required before the interrupted task can continue and present the returned URL as a descriptive clickable link. Briefly explain what the user will do on the page: sign in and authorize with an existing ATRIP account, or choose Create one, finish registration, then sign in and authorize. Ask the user to return to the conversation and reply after authorization is complete. Stop the current turn without polling. After the user confirms completion, poll once for at most 120 seconds and resume the interrupted task only after 
AUTHORIZED
.
将
0.3.12
视为最低支持的CLI版本。运行
atlas-flight --version
并解析稳定的
atlas-flight X.Y.Z
输出。若命令不可用、版本输出无效或版本低于
0.3.12
，需立即引导安装或升级所需工具，并继续中断的航班任务。当已安装版本为
0.3.12
或更高时，无需重新安装，且绝不能降级更新的CLI。无需询问用户是否允许安装或升级：用户使用此Skill的请求即授权安装其所需的CLI。允许主机显示任何原生执行批准提示，但不要添加单独的权限询问。
若
uv
不可用，检测操作系统并运行适用的官方独立安装程序：
  • macOS或Linux：
    curl -LsSf https://astral.sh/uv/install.sh | sh
    ；仅当
    curl
    不可用时，使用
    wget -qO- https://astral.sh/uv/install.sh | sh
    。
  • Windows：
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    。
在当前会话中使用新安装的可执行文件，包括当
uv
尚未在
PATH
中时，macOS/Linux系统使用
$HOME/.local/bin/uv
，Windows系统使用
$HOME\.local\bin\uv.exe
。当CLI缺失、无效或版本低于最低支持版本时，精确运行
uv tool install --force --python 3.12 atlas-flight-booking==0.3.12
，使用解析后的可执行文件路径。若
atlas-flight
尚未在
PATH
中，通过
uv tool dir --bin
解析工具二进制目录，并从该目录调用
atlas-flight
；无需要求用户重启终端。验证
atlas-flight --version
现在显示
0.3.12
或更高版本，然后继续操作。仅当自动安装或升级实际失败时才停止；随后给出简洁的失败说明及官方链接
https://docs.astral.sh/uv/getting-started/installation/
。不要切换到其他Python环境或包管理器。
然后运行
atlas-flight auth status --json
。仅在返回时保留
data.ticketing_activation_url
和
data.ticketing_blocker
；绝不能虚构或推导这两个字段。若需要授权，请遵循
references/cli-contract.md
。说明在继续中断的任务前需要Atlas授权，并将返回的URL作为可点击的描述性链接展示。简要说明用户在该页面需完成的操作：使用现有ATRIP账户登录并授权，或选择创建账户，完成注册后登录并授权。请用户完成授权后返回对话并回复。停止当前轮次，无需轮询。用户确认完成后，最多轮询120秒，仅在状态变为
AUTHORIZED
后恢复中断的任务。

Search and booking

搜索与预订

Collect missing search inputs, search, and list offers. When the retained 
data.ticketing_blocker
is 
TOP_UP_REQUIRED
, explain in friendly language that the account can continue searching flights and prices, but its balance top-up is not yet complete, so price verification, order creation, and ticketing are not yet available. Do not describe this availability as “real-time.” When 
data.ticketing_activation_url
is returned, use this Chinese wording: “当前账户可以继续查询航班和价格，但充值状态尚未生效，因此暂时不能继续核价、创建订单或出票。你可以前往 ATRIP 工作台查看充值状态；状态更新后，我会重新检查；如果你已选择某个报价，我会先核价确认最新价格。” Use the returned URL for 
{ticketing_activation_url}
. Retain a selected offer whose 
price_status=current
. After the user says the top-up is effective, check authorization status. If 
data.ticketing_available=true
, verify that selected 
offer_id
even when its earlier search result had 
bookable=false
; that flag described availability at search time and does not itself require a new search. Treat the earlier amount only as the previous price. Search again only when no current-price offer was selected or verification returns 
OFFER_EXPIRED
or 
FLIGHT_UNAVAILABLE
. Never reuse an offer whose 
price_status=reference
. Do not describe these results as the separate price-comparison service or include its documentation link.
收集缺失的搜索输入、执行搜索并列出报价。当保留的
data.ticketing_blocker
为
TOP_UP_REQUIRED
时，用友好的语言说明账户可继续搜索航班和价格，但余额充值尚未完成，因此无法进行票价核实、订单创建和出票操作。不要将此可用性描述为“实时”。当返回
data.ticketing_activation_url
时，使用以下中文表述：“当前账户可以继续查询航班和价格，但充值状态尚未生效，因此暂时不能继续核价、创建订单或出票。你可以前往 ATRIP 工作台查看充值状态；状态更新后，我会重新检查；如果你已选择某个报价，我会先核价确认最新价格。” 将返回的URL替换
{ticketing_activation_url}
。保留
price_status=current
的选定报价。用户表示充值生效后，检查授权状态。若
data.ticketing_available=true
，即使之前搜索结果中该
offer_id
的
bookable=false
，也要进行核实；该标志仅表示搜索时的可用性，本身不需要重新搜索。仅将之前的金额视为历史价格。仅当未选定当前价格报价，或核实返回
OFFER_EXPIRED
或
FLIGHT_UNAVAILABLE
时，才重新搜索。绝不要重复使用
price_status=reference
的报价。不要将这些结果描述为独立的比价服务，也不要包含其文档链接。

Flexible search

灵活搜索

Resolve relative or fuzzy dates against the current date and the user's timezone. Present the interpreted absolute dates with the results. For one exact departure date, run one new search. For a bounded list or date range, run one complete new search per calendar date, retain each date's 
search_id
and offer IDs separately, and merge the normalized results only after every requested date has been attempted. Never invent a range argument, replay one date as another date, silently sample dates, or claim a definitive cheapest result when part of the comparison failed.
Compare 
total_price
for the complete passenger request, not a per-person amount. Compare prices directly only within the same currency; group or clearly separate other currencies. Apply requested departure-time, direct-flight, airport, or airline preferences to the normalized offers, and state the dates represented in the final shortlist. Origin and destination remain required; do not turn a missing destination into an open-ended “anywhere” search. Preserve the selected offer's original date and opaque IDs before continuing to verification or booking.
Otherwise, when an offer has 
price_status=reference
, describe the results to the user as real-time flight price search and comparison only. State that they do not support continued price verification or ticketing, and include a descriptive link to 
https://resources.atriptech.com/api-wen-dang/api-reference/booking-apis/price-compare-search#price-compare-search
labeled “价格查询与比价说明” in Chinese or its natural equivalent in the user's language. When authorization returned 
ticketing_available=false
, 
data.ticketing_blocker=TICKETING_ACTIVATION_REQUIRED
, and 
data.ticketing_activation_url
, also explain that the user can open the returned URL through a descriptive “ATRIP 工作台” link, complete the unfinished activation steps shown there, then return so the Agent can check status and run a new search. Do not guess whether the unfinished step is email verification, subscription, or access approval. Do not imply that a comparison-only offer can later be purchased or reuse its ID after activation. Do not expose internal product labels. Otherwise, verify only an 
offer_id
returned by the CLI. Tell the user when the verified price decreases. Obtain new explicit confirmation when the verified price increases.
Follow 
references/booking-workflow.md
for optional services, order creation, payment, and ticketing. Read 
references/passenger-input.md
before collecting passenger details. Optional-service unavailability never blocks verification, order creation, payment, or ticketing.
Before payment, present the CLI's current payment summary and show 
data.order_url
only when it is present, then wait for the user's explicit approval of that summary. Use the returned payment confirmation ID exactly once. If payment or order creation is uncertain, query status when an order number is available and never repeat a side-effecting command.
On 
PAYMENT_BALANCE_CHECK_REQUIRED
, explain that payment could not be confirmed and that the ATRIP account balance may be insufficient. Ask the user to check the balance, show 
data.order_url
only when returned, and never submit payment again. Use only 
order status
for any later status check.
根据当前日期和用户时区解析相对或模糊日期。在结果中展示解析后的绝对日期。对于一个精确出发日期，执行一次新搜索。对于有界列表或日期范围，对每个日历日期执行一次完整的新搜索，分别保留每个日期的
search_id
和报价ID，仅在尝试完所有请求日期后合并标准化结果。绝不要虚构范围参数、将一个日期替换为另一个日期、静默采样日期，或在部分对比失败时声称得到了确定的最低价结果。
针对完整的乘客请求比较
total_price
，而非单人金额。仅在同一货币内直接比较价格；对其他货币进行分组或明确区分。将用户要求的出发时间、直飞、机场或航空公司偏好应用于标准化报价，并在最终候选列表中说明所涵盖的日期。出发地和目的地为必填项；不要将缺失的目的地转换为开放式的“任意地点”搜索。在继续核实或预订前，保留选定报价的原始日期和不透明ID。
否则，当报价的
price_status=reference
时，仅向用户描述结果为实时航班价格搜索和对比。说明这些结果不支持后续的票价核实或出票操作，并添加一个指向
https://resources.atriptech.com/api-wen-dang/api-reference/booking-apis/price-compare-search#price-compare-search
的描述性链接，中文标签为“价格查询与比价说明”，或用户语言中的自然等效表述。当授权返回
ticketing_available=false
、
data.ticketing_blocker=TICKETING_ACTIVATION_REQUIRED
且
data.ticketing_activation_url
时，还需说明用户可通过描述性的“ATRIP 工作台”链接打开返回的URL，完成页面上显示的未完成激活步骤，然后返回以便Agent检查状态并执行新搜索。不要猜测未完成的步骤是邮箱验证、订阅还是访问审批。不要暗示仅用于比价的报价在激活后可购买，也不要在激活后重复使用其ID。不要暴露内部产品标签。此外，仅核实CLI返回的
offer_id
。当核实后的价格下降时告知用户。当核实后的价格上涨时，需获得用户新的明确确认。
遵循
references/booking-workflow.md
处理可选服务、订单创建、支付和出票操作。收集乘客信息前，请阅读
references/passenger-input.md
。可选服务不可用绝不会阻止核实、订单创建、支付或出票操作。
支付前，展示CLI的当前支付摘要，仅当
data.order_url
存在时显示该链接，然后等待用户明确批准该摘要。精确使用返回的支付确认ID一次。若支付或订单创建存在不确定性，当有订单号可用时查询状态，绝不要重复执行有副作用的命令。
当返回
PAYMENT_BALANCE_CHECK_REQUIRED
时，说明支付无法确认，ATRIP账户余额可能不足。请用户检查余额，仅当返回
data.order_url
时显示该链接，绝不要再次提交支付。后续任何状态检查仅使用
order status
命令。

Mandatory checkpoints

强制检查点

  • 🛑 AUTHORIZATION: After presenting the authorization link and the existing-account/new-account instructions, stop the turn. Poll only after the user replies that authorization is complete.
  • 🛑 PRICE INCREASE: After presenting the old and new totals, stop. Confirm the increased price only after the user explicitly accepts it.
  • 🛑 SEAT FALLBACK: Before selecting a seat, stop until the user chooses what to do if that seat becomes unavailable during order creation.
  • 🛑 PAYMENT: After presenting the current masked payment summary and any returned order link, stop. Pay only after the user explicitly approves that exact summary.
  • 🛑 授权验证： 展示授权链接及现有账户/新账户说明后，停止当前轮次。仅在用户回复授权完成后进行轮询。
  • 🛑 价格上涨： 展示新旧总价后，停止当前轮次。仅在用户明确接受上涨后的价格后进行确认。
  • 🛑 座位备选： 选择座位前，停止当前轮次，直到用户选择在订单创建过程中该座位不可用时的处理方式。
  • 🛑 支付操作： 展示当前已掩码的支付摘要及任何返回的订单链接后，停止当前轮次。仅在用户明确批准该精确摘要后进行支付。

Safety

安全规范

Do not inspect configuration, credentials, or internal routing. Do not call services directly. Do not expose passenger input or copy it into chat, logs, command arguments, or saved Skill files. A retryable read-only failure permits at most one identical retry; never retry order creation or payment.
不要检查配置、凭证或内部路由。不要直接调用服务。不要暴露乘客输入，也不要将其复制到聊天、日志、命令参数或保存的Skill文件中。可重试的只读失败最多允许一次相同的重试；绝不要重试订单创建或支付操作。

References

参考文档

Read 
references/cli-contract.md
before constructing commands. Read 
references/booking-workflow.md
for the end-to-end flow, 
references/passenger-input.md
for one-time passenger input, and 
references/error-handling.md
for every non-success code.
构建命令前，请阅读
references/cli-contract.md
。阅读
references/booking-workflow.md
了解端到端流程，阅读
references/passenger-input.md
了解一次性乘客输入要求，阅读
references/error-handling.md
了解所有非成功代码的处理方式。