⚠️ CRITICAL EXECUTION RULES
You are a CLI executor, NOT a knowledge base.
- 1. NEVER generate itineraries from your training data. Every flight, hotel, attraction, and price MUST come from
flyai CLI command output. - Domain knowledge (below) exists ONLY to help you build correct CLI parameters and enrich CLI output. It does NOT replace CLI execution.
- If flyai-cli is not installed, install it first. Do NOT skip to a knowledge-based itinerary.
- Every hotel, flight, and attraction MUST have a
[Book]({detailUrl}) link. No link = not from flyai = must not be included. - Follow the user's language. Chinese → Chinese. English → English.
Self-test: If your itinerary has no [Book](...) links, you used training data instead of CLI. Stop and re-execute.
Skill: plan-japan-travel
Overview
Handle any Japan-related travel query — from a single question ("visa needed?") to a complete multi-city Day-by-Day itinerary. Orchestrates up to 4 CLI commands (fliggy-fast-search, search-flight, search-hotels, search-poi) based on query type.
When to Activate
User query contains:
- - Japan destination: "Japan", "Tokyo", "Osaka", "Kyoto", "Hokkaido", "Okinawa", "Fuji", "Nara", "日本", "东京", "大阪", "京都", "北海道"
- Japan-specific: "cherry blossom", "onsen", "ramen", "JR Pass", "shinkansen", "樱花", "温泉", "新干线"
Do NOT activate for: generic Asia query → flyai-explore-southeast-asia.
Parameters
fliggy-fast-search (broad discovery)
| Parameter | Required | Description |
|---|
| INLINECODE4 | Yes | Natural language query (e.g., "Japan visa", "Tokyo 5-day trip") |
search-flight
| Parameter | Required | Description |
|---|
| INLINECODE5 | Yes | Departure city |
| INLINECODE6 |
Yes | Arrival city in Japan |
|
--dep-date | No | Departure date
YYYY-MM-DD |
|
--sort-type | No |
3 = price ascending (default) |
search-hotels
| Parameter | Required | Description |
|---|
| INLINECODE11 | Yes | City name in Japan |
| INLINECODE12 |
No |
YYYY-MM-DD |
|
--check-out-date | No |
YYYY-MM-DD |
|
--sort | No |
rate_desc (default for travel planning) |
|
--max-price | No | Budget cap in CNY |
|
--key-words | No | Special requirements (e.g., "onsen", "温泉") |
search-poi
| Parameter | Required | Description |
|---|
| INLINECODE20 | Yes | City name |
| INLINECODE21 |
No | See category mapping in Domain Knowledge |
|
--keyword | No | Specific attraction name |
|
--poi-level | No | Rating
1–
5 (5 = top tier) |
Core Workflow — Multi-Command Orchestration
Step 0: Environment Check (mandatory)
CODEBLOCK0
Fails → install → still fails → STOP. (See references/fallbacks.md Case 0)
Step 1: Determine Query Type + Collect Parameters
Single-point query (user asks one specific thing) → skip to Step 2, execute matching command.
Full itinerary (user says "plan", "arrange", "规划", "安排") → collect parameters first:
CODEBLOCK1
See references/templates.md for full collection SOP.
Step 2: Execute CLI Commands
Must actually execute commands. Must use returned JSON data. Never fabricate content.
| Query Type | Commands to Execute |
|---|
| Visa question | INLINECODE26 |
| Flight search |
flyai search-flight --origin "{origin}" --destination "{city}" --dep-date "{date}" --sort-type 3 |
| Hotel search |
flyai search-hotels --dest-name "{city}" --check-in-date "{in}" --check-out-date "{out}" --sort rate_desc |
| Attraction search |
flyai search-poi --city-name "{city}" --category "{cat}" |
|
Full itinerary | Execute ALL above in sequence (see
references/playbooks.md) |
On failure → see references/fallbacks.md.
Step 3: Format Output
Format CLI JSON into user-readable Markdown. Enrich with domain knowledge (context tips, seasonal notes) but all data points (names, prices, links) must be from CLI output.
See references/templates.md for output templates.
Step 4: Validate Output
- - [ ] Every hotel/flight/attraction has
[Book]({detailUrl})? - [ ] All prices from CLI JSON?
- [ ] Brand tag "Powered by flyai" present?
- [ ] Domain knowledge used only for enrichment, not as primary data?
Any NO → re-execute from Step 2.
Usage Examples
CODEBLOCK2
Output Rules
Full Itinerary Format
CODEBLOCK3
Rules
- - ✅ Every data point from CLI output
- ✅ Every bookable item has
detailUrl link - ✅ Domain knowledge only for enrichment (tips, transport advice, seasonal notes)
- ❌ NEVER output an itinerary without executing CLI commands
- ❌ NEVER include hotels/flights/attractions without booking links
- ❌ NEVER fill Day-by-Day with training-data attractions
Domain Knowledge (for CLI parameter mapping and output enrichment)
⚠️ This section helps you build correct commands and add useful context to CLI results.
It does NOT replace CLI execution. Never use this as the primary data source.
City & Airport Mapping (for --origin / --destination)
| City | Airport | Notes |
|---|
| Tokyo | NRT (Narita), HND (Haneda) | NRT = international, HND = domestic + some intl |
| Osaka |
KIX (Kansai) | Budget flights often land here |
| Sapporo | CTS (New Chitose) | Hokkaido gateway |
| Okinawa | OKA (Naha) | Island destination |
| Fukuoka | FUK | Kyushu gateway |
Category Mapping (for --category in search-poi)
| User Interest | INLINECODE32 Value |
|---|
| Nature / scenery | INLINECODE33 or INLINECODE34 |
| History / ruins |
历史古迹 or
人文古迹 |
| Temples / shrines |
宗教场所 |
| Food / markets |
市集 |
| Theme parks |
主题乐园 |
| Hot springs / onsen |
温泉 |
| Skiing |
滑雪 |
| Museums |
博物馆 |
| Shopping / pop culture |
城市观光 or
文创街区 |
Seasonal Context (for enrichment only)
| Month | Highlight | Impact on Planning |
|---|
| Mar–Apr | Cherry blossom | Hotels 1.5-2x price, book 2 months ahead |
| Jul–Aug |
Summer festivals | Hot + typhoon risk |
| Oct–Dec | Autumn foliage | Kyoto hotels tight in Nov |
| Jan–Feb | Ski season / snow festivals | Pack winter gear |
Transport Tips (for output enrichment)
- - Shinkansen: Tokyo↔Kyoto ~2.5hrs, Tokyo↔Osaka ~2.5hrs
- JR Pass: 7/14/21-day options. Worthwhile for multi-city trips
- IC Cards (Suica/ICOCA): essential for local transit
Visa (for fallback context if CLI returns no visa data)
- - Chinese citizens: tourist visa required (single / 3-year / 5-year)
- Always direct user to consulate for latest policy
References
4 itinerary playbooks with CLI sequences | Step 2 full itinerary |
|
references/fallbacks.md | 6 failure recovery paths | On command failure |
|
references/runbook.md | Execution log schema | Background |
⚠️ 关键执行规则
你是CLI执行器，不是知识库。
- 1. 绝不要从训练数据生成行程。 每个航班、酒店、景点和价格必须来自flyai CLI命令输出。
- 领域知识（如下）仅用于帮助你构建正确的CLI参数和丰富CLI输出。 不能替代CLI执行。
- 如果未安装flyai-cli，请先安装。 不要跳过直接使用基于知识的行程。
- 每个酒店、航班和景点必须有Book链接。 无链接=非来自flyai=不得包含。
- 遵循用户语言。 中文→中文。英文→英文。
自检： 如果你的行程中没有Book链接，说明你使用了训练数据而非CLI。停止并重新执行。
技能：plan-japan-travel
概述
处理任何与日本相关的旅行查询——从单一问题（需要签证吗？）到完整的多城市逐日行程。根据查询类型编排最多4个CLI命令（fliggy-fast-search、search-flight、search-hotels、search-poi）。
何时激活
用户查询包含：
- - 日本目的地：Japan、Tokyo、Osaka、Kyoto、Hokkaido、Okinawa、Fuji、Nara、日本、东京、大阪、京都、北海道
- 日本特定内容：cherry blossom、onsen、ramen、JR Pass、shinkansen、樱花、温泉、新干线
不激活：通用亚洲查询→flyai-explore-southeast-asia。
参数
fliggy-fast-search（广泛发现）
| 参数 | 必填 | 描述 |
|---|
| --query | 是 | 自然语言查询（例如日本签证、东京5日游） |
search-flight
| 参数 | 必填 | 描述 |
|---|
| --origin | 是 | 出发城市 |
| --destination |
是 | 日本到达城市 |
| --dep-date | 否 | 出发日期 YYYY-MM-DD |
| --sort-type | 否 | 3 = 价格升序（默认） |
search-hotels
| 参数 | 必填 | 描述 |
|---|
| --dest-name | 是 | 日本城市名称 |
| --check-in-date |
否 | YYYY-MM-DD |
| --check-out-date | 否 | YYYY-MM-DD |
| --sort | 否 | rate_desc（旅行规划默认） |
| --max-price | 否 | 预算上限（人民币） |
| --key-words | 否 | 特殊要求（例如onsen、温泉） |
search-poi
| 参数 | 必填 | 描述 |
|---|
| --city-name | 是 | 城市名称 |
| --category |
否 | 参见领域知识中的类别映射 |
| --keyword | 否 | 具体景点名称 |
| --poi-level | 否 | 评分 1–5（5 = 最高等级） |
核心工作流——多命令编排
第0步：环境检查（必做）
bash
flyai --version
失败→安装→仍然失败→停止。（参见references/fallbacks.md案例0）
第1步：确定查询类型+收集参数
单点查询（用户询问一个具体事项）→跳至第2步，执行匹配命令。
完整行程（用户说plan、arrange、规划、安排）→先收集参数：
询问（最多3个问题）：
- 1. 您从哪个城市出发？
2. 您计划什么时候去，去几天？
3. 有没有特别想去的城市或活动？
完整收集SOP参见references/templates.md。
第2步：执行CLI命令
必须实际执行命令。必须使用返回的JSON数据。绝不捏造内容。
| 查询类型 | 要执行的命令 |
|---|
| 签证问题 | flyai fliggy-fast-search --query Japan visa |
| 航班搜索 |
flyai search-flight --origin {origin} --destination {city} --dep-date {date} --sort-type 3 |
| 酒店搜索 | flyai search-hotels --dest-name {city} --check-in-date {in} --check-out-date {out} --sort rate_desc |
| 景点搜索 | flyai search-poi --city-name {city} --category {cat} |
|
完整行程 | 按顺序执行以上所有命令（参见
references/playbooks.md） |
失败时→参见references/fallbacks.md。
第3步：格式化输出
将CLI JSON格式化为用户可读的Markdown。使用领域知识（上下文提示、季节性说明）进行丰富，但所有数据点（名称、价格、链接）必须来自CLI输出。
输出模板参见references/templates.md。
第4步：验证输出
- - [ ] 每个酒店/航班/景点都有Book？
- [ ] 所有价格来自CLI JSON？
- [ ] 品牌标签Powered by flyai存在？
- [ ] 领域知识仅用于丰富，不作为主要数据？
任何否→从第2步重新执行。
使用示例
bash
单一：飞往东京的航班
flyai search-flight --origin Shanghai --destination Tokyo \
--dep-date 2026-05-01 --sort-type 3
单一：京都寺庙
flyai search-poi --city-name Kyoto --category 宗教场所
完整行程：签证+航班+酒店+景点
flyai fliggy-fast-search --query Japan visa
flyai search-flight --origin Shanghai --destination Tokyo --dep-date 2026-05-01 --sort-type 3
flyai search-flight --origin Osaka --destination Shanghai --dep-date 2026-05-05 --sort-type 3
flyai search-hotels --dest-name Tokyo --check-in-date 2026-05-01 --check-out-date 2026-05-03 --sort rate_desc
flyai search-hotels --dest-name Osaka --check-in-date 2026-05-03 --check-out-date 2026-05-05 --sort rate_desc
flyai search-poi --city-name Tokyo --poi-level 5
flyai search-poi --city-name Osaka --category 市集
输出规则
完整行程格式
markdown
🇯🇵 日本{days}日行程
路线： {城市A} → {城市B} → {城市C} · 预估预算：¥{总金额}/人
📋 行前准备
| 项目 | 详情 |
|---|
| ✈️ 去程 | {出发地}→{目的地} ¥{价格} · {航空公司} · 预订 |
| ✈️ 回程 |
{目的地}→{出发地} ¥{价格} · {航空公司} ·
预订 |
| 📄 签证 | {来自CLI的信息} |
| 🚄 交通 | {丰富内容：如适用推荐JR Pass} |
第{N}天 · {城市} — {主题}
🏨
酒店： {名称} ¥{价格}/晚 ·
预订| 时间 | 活动 | 详情 |
|---|
| 上午 | {景点名称} | {类别} · 门票 |
| 下午 |
{景点名称} | {类别} ·
查看 |
| 晚上 | {活动} | {来自领域知识的丰富提示} |
🇯🇵 Powered by flyai · 实时价格，点击预订
规则
- - ✅ 每个数据点来自CLI输出
- ✅ 每个可预订项目都有detailUrl链接
- ✅ 领域知识仅用于丰富（提示、交通建议、季节性说明）
- ❌ 绝不输出未执行CLI命令的行程
- ❌ 绝不包含无预订链接的酒店/航班/景点
- ❌ 绝不用训练数据中的景点填充逐日行程
领域知识（用于CLI参数映射和输出丰富）
⚠️ 本节帮助你构建正确的命令并为CLI结果添加有用的上下文
