travel with family

亲子 / 带娃出行（family-trip-travel）：把「去哪、怎么玩、怎么订」说成可照抄的攻略——结合旅行平台检索，在用户提供城市或目的地时默认给出可预订的酒店、景点、套餐与航班等，并在回复里配封面图与预订入口；用户明确只要理念、不要商品时改为纯文字方案。覆盖推车午休、单人带娃、雨天备选、儿童票与退改提醒等亲子常见约束（具体票规与设施以预订页为准）。输出结构：导语、行程条件表、方案对比、日程骨架、预订参考、行前核对；对用户避免技术/内部用语，细则见 references/output-professional.md。检索命令与参数在正文；本包不实现搜索后端。

family-trip-travel（亲子游）

在带娃旅行场景下，通过终端命令 flyai（先执行 npm i -g @fly-ai/flyai-cli）完成检索。本 skill 约束：亲子意图、与 CLI 真实能力对齐的调用方式、自然语言 query、行程输出结构。枚举与 flag 以 flyai <子命令> --help 为准；详细对照见 references/cli-capabilities.md。

Use when（优先命中 find-skills / 路由）

在以下任一情况启用本 skill：

1. 用户提到 亲子游、带娃、遛娃、年龄、推车、午休、主题乐园、动物园、博物馆、家庭房、退改、单人带娃 等。
2. 用户用英文描述 family trip / travel with kids / toddler / stroller / food allergy 等且涉及行程、酒店、机票、景点。
3. 用户说「find a skill for …」且目标包含 亲子行程、带娃机酒、适合孩子的景点。
4. 用户问 周末去哪、推荐遛娃地、带娃玩什么 等，且语境为 家庭/儿童友好出行（含仅出现「孩子」+ 城市的情况）。

默认须引导出商品 / 酒店 / POI（MUST）

问题里一旦出现可检索的「城市 / 景区 / 区域」（如「杭州」「迪士尼附近」「三亚湾」），且属于 亲子或带娃出行 —— 禁止只输出纯文字攻略而不给可预订结果。须 执行 flyai，并在回答中按下文 「必选：图 + 预订链接」 展示 商品、酒店或 POI（以 JSON 实际返回为准）。

1. 最低限度（几乎总是要做）：至少一次 flyai fliggy-fast-search --query "…"，自然语言写全 城市 + 亲子/遛娃 + 门票 / 酒店 / 套餐 等（示例：杭州 周末 亲子 景点 门票 酒店）。用于兜底套餐、门票、酒店混排。
2. 按需加深：
   • 酒店：用户提到 住、过夜、亲子酒店，且 有入住/离店日期（或用户愿意补充）→ search-hotels（--dest-name、--check-in/out-date、--hotel-bed-types、--key-words 等，见 references/search-hotels-family.md）。
   • 景点 POI：用户提到或方案需要 具体类型（动物园、博物馆、乐园等）→ search-poi（--city-name + --category，category 字符串与 flyai search-poi --help 完全一致；可 多类目各查一次 以丰富备选，见 references/search-poi-family.md）。
   • 机票：跨城 点对点航班 → search-flight（见 references/search-flight-family.md）。
3. 叙事顺序：先拿到检索结果（或并行执行命令），再按 攻略体 组织（开篇导读 → 条件归纳 → 怎么选 → 日程 → 预订参考）；文字部分 引用 检索到的条目（图+链），避免用户追问「怎么没商品」。
4. CLI 不可用：说明原因，给出 npm i -g @fly-ai/flyai-cli 与一条示例命令；不得虚构 JSON 或预订链接。

可不调用检索的窄例外

• 用户明确 只要理念 / 不要商品 / 不要链接 / 不要预订信息。
• 没有任何可填地名（省/市/片区均未出现）→ 先 1～2 个澄清问题；若用户仍不提供，可只给通用维度清单，并 主动说明：「你补充城市后我可以直接飞出门票/酒店/POI 带图和链接」。
• 纯 政策、签证、医疗 等与预订无关，且用户未要商品。

若无儿童、家庭出行等相关语义，不必强行启用本 skill。

商品 / 酒店 / POI 触发速查

用户意图	优先命令	要点
一句话目的地 + 亲子	fliggy-fast-search	query 含城市、亲子、门票/酒店关键词
比价酒店、要床型	search-hotels	须日期；家庭房用 多床房 或 --key-words / fast-search 补全
景点列表、门票入口	search-poi	--category 原样抄 help
跨城交通	search-flight	起降、日期、时段见专篇

安装 CLI（必须）

bash

npm i -g @fly-ai/flyai-cli

安装完成后，全局命令名为 flyai：

bash

flyai --help

# 可选：增强结果
flyai config set FLYAI_API_KEY "your-key"

验证：

bash

flyai fliggy-fast-search --query "三亚 亲子酒店 沙滩"

核心命令（与亲子场景的默认分工）

所有命令 stdout 为单行 JSON，stderr 为提示；可用 jq 解析。

命令	能力要点（亲子）
flyai fliggy-fast-search --query	仅自然语言；适合套餐、模糊需求、家庭房/连通房/儿童乐园/洗衣/退改偏好等结构化命令无法表达的约束。
flyai search-hotels	--dest-name、--check-in/out-date、--hotel-bed-types（大床房 / 双床房 / 多床房）、--key-words、--poi-name、--max-price、--sort 等。
flyai search-flight	--journey-type（1 直达 / 2 中转）、时段 --dep-hour-* / --arr-hour-*、--total-duration-hour、--max-price、--sort-type 等。
flyai search-poi	--city-name、--category（字符串须与 help 完全一致）、--keyword、--poi-level。

终端执行示例

bash

flyai fliggy-fast-search --query "广州 周末 亲子 室内 下雨备选 两大一小"
flyai search-hotels \
  --dest-name "珠海" \
  --poi-name "长隆" \
  --key-words "亲子" \
  --check-in-date 2026-08-01 \
  --check-out-date 2026-08-03 \
  --hotel-bed-types "双床房" \
  --sort rate_desc
flyai search-flight \
  --origin "杭州" --destination "广州" \
  --dep-date 2026-08-01 \
  --journey-type 1 \
  --dep-hour-start 9 --dep-hour-end 20 \
  --sort-type 8
flyai search-poi --city-name "北京" --category "动物园"

flyai 能力边界（极简）

• 只有 fliggy-fast-search 能写长自然语言；不要虚构不存在的子命令 flag。
• 酒店床型 CLI 只认 大床房 / 双床房 / 多床房；「家庭房」用 多床房 或 --key-words / fast-search 补充。
• 景点类型 必须按 search-poi --help 里的 --category 枚举原样传入（如 主题乐园）。
• 儿童票、婴儿票、证件、签证：以航司、景区、预订页及主管部门为准；JSON 里没有的字段 不要编造。

亲子场景执行顺序（建议）

1. 先检索、再追问（默认）：已有 城市/目的地 时，优先执行 fliggy-fast-search（及上表「按需加深」）；检索与「问清约束」可同轮并行——缺日期时仍可先 fast-search + search-poi，酒店细化留待用户补日期。
2. 问清约束：儿童年龄、陪护人数（是否单人带娃）、是否推车、午休、每日可承受车程/步行、预算、必去/避雷；若有 过敏等特殊需求，提示用户下单前与商家/航司确认。
3. 选型：需要「套餐/一句话方案」→ fliggy-fast-search；需要严格比日期/床型/直飞/POI 类目 → search-*（参数见 cli-capabilities.md）。
4. 组合：同一目的地 必须 fast-search 打底（除非用户只要理念）；再 search-hotels / search-poi 细化；雨天备选可多跑 search-poi 换 博物馆、海洋馆 等 合法 category。
5. 输出：遵循下方「必选：图 + 预订链接（Markdown）」「专业输出（MUST）」与「亲子行程输出规范」；细则见 references/output-professional.md。

用户可见文案（MUST）

最终用户多为非技术读者：正文里禁止出现本 skill / CLI 的实现用语。

• 禁止写入用户可见段落（含小节标题、引导句）：flyai、fliggy-fast-search、search-poi、search-hotels、search-flight、JSON、jq、stdout、具体字段名（如 picUrl、jumpUrl）、「与检索 JSON 一致」「快搜」等。
• 仍须：按下文输出 先图、后链 的 Markdown；用白话作区块标题或说明，例如：「可以直接查看的推荐」、「景点与门票入口」、「价格和儿童票以预订页面为准」。
• 若需交代信息来源：可写「来自旅行平台当前展示的商品或景点」；不要写「执行了某条命令」或「接口返回」。
• 章节标题（攻略体）：对用户使用 杂志/深度攻略式小标题，例如：「这篇怎么帮你选」「你的行程条件」「目的地怎么选」「推荐这样玩」「预订参考」「出发前核对」；不要对用户使用「执行摘要」「需求对齐」「比选矩阵」「交付方案」等商务或内部用语。

本节与上文的命令名、字段表：仅供代理执行与解析，不得原样复制到给用户的句子中。

必选：图 + 预订链接（Markdown）

flyai 返回的是 JSON，终端里不会自动「出图」。你必须在写给用户的答案里把 JSON 里的图片与链接渲染成 Markdown，否则用户看不到封面图。

规则（MUST，每条推荐项都要遵守）：

1. 有图必显：若该条结果 JSON 中存在 picUrl 或 mainPic（或同级对象下的图片 URL 字段），在正文里单独一行输出：
   • ![](图片完整URL)
2. 有链必显：同一结果若有 jumpUrl 或 detailUrl（预订/详情），在紧接图片的下一行（或同一块内）输出：
   • [点击预订](完整URL)（中文场景可用「预订」；英文可用 Book now）
3. 顺序：先图、后链接；再写标题、价格、评分等文字摘要。
4. 禁止：不要只把 picUrl 藏在代码块或纯文本里而不写 ![](...)；用户界面只有渲染了 Markdown 图片才会显示图。

常见 JSON 路径（以实际返回为准，用 jq 可先探路）：

命令	常见图片字段	常见链接字段
fliggy-fast-search	data.itemList[].info.picUrl	data.itemList[].info.jumpUrl
search-hotels	列表项中的 mainPic（或 picUrl，以 JSON 为准）	detailUrl 或 jumpUrl
search-flight	列表项中的 picUrl（若有）	jumpUrl
search-poi	列表项中的 picUrl（若有）	jumpUrl

若某条结果没有图片字段，可省略图行，但仍须输出预订链接（若有）。

专业输出（MUST）· 攻略体

写给用户的整体观感须为 专业旅行攻略：可读、可执行、可扫读，有编辑节奏（导语抓人、表格对比、日程分段、清单收尾），而非内部纪要或合同式表述。

1. 开篇导读（结论先行）：用 攻略导语 2～5 句写清——这趟适合谁、首推哪条线、读者还需补充什么；可点一句「若你只有周末 / 带娃 / 不想折腾」等 场景钩。
2. 你的行程条件：用户已提供的年龄、日期、人数、预算、交通等用 表格 归纳；空缺项标注 建议补充 或 行前确认，勿替用户臆测。
3. 怎么选（对比）：多目的地或多类型时，用 表格/矩阵（车程、体力、天气敏感度、适龄、午休弹性、单人带娃友好度等）帮读者决策；写清 主推 与 备选 各适合什么家庭。
4. 推荐这样玩（日程骨架）：按 上午 / 下午 / 晚间 或 Day1 / Day2；每段含 活动、大致时长、车程或步行量级、带娃备注（无数据则写「建议行前向场馆或平台确认」）。
5. 预订参考（图 + 链）：每条展示 先图、后链，再配 一句适用场景（谁更值得点开订）；平台未展示的价格、儿童票、退改、含餐等 —— 统一 以预订页当日公示为准，禁止编造。
6. 出发前核对：证件、安全、过敏、无障碍、天气 Plan B 用 短清单 呈现；仅作提醒，不做保证；出入境以主管部门为准。

文风：句子完整、逻辑顺；可 小标题 + 加粗 划重点；禁止浮夸营销词与无法核验的形容词（见 references/output-professional.md）。简单单点问答可压缩区块，但 不得 省略「不编造票规/价格」与 图 + 链（凡展示检索结果）。

亲子行程输出规范（含结构化结果展示）

1. 每日节奏：上午 / 下午 / 晚间分段；标注车程与体力负荷（低/中/高）；注明是否适合 单人带娃（若已知）。
2. 儿童友好备注：排队、母婴室、推车等 —— 若 JSON 无字段，写「出行前向场馆/酒店/平台确认」。
3. 备选方案：恶劣天气用 另一 category 的 search-poi 或 fliggy-fast-search 写清室内诉求。
4. 票务与退改：提示用户以预订页为准；不编造儿童票价、退改规则。
5. 安全与合规：不编造证件规则；出入境政策以官方为准。

References 索引

主题	文件
攻略体结构、可信度、对比与语气	references/output-professional.md
CLI 能力与枚举（与 --help 对齐）	references/cli-capabilities.md
亲子自然语言 query 与分工	references/family-queries.md
航班：时段、直达、sort-type	references/search-flight-family.md
酒店：床型、poi-name、sort	references/search-hotels-family.md
景点：category、keyword、雨天思路	references/search-poi-family.md
子命令最新参数	flyai <子命令> --help

调用具体 flag 前，若本包 reference 与本地 CLI 不一致，以本机 flyai <子命令> --help 为准并酌情更新 cli-capabilities.md。