⚠️ 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.
2. Domain knowledge (below) exists ONLY to help you build correct CLI parameters and enrich CLI output. It does NOT replace CLI execution.
3. If flyai-cli is not installed, install it first. Do NOT skip to a knowledge-based itinerary.
4. Every hotel, flight, and attraction MUST have a [Book]({detailUrl}) link. No link = not from flyai = must not be included.
5. 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)#

ParameterRequiredDescription--queryYesNatural language query (e.g., "Japan visa", "Tokyo 5-day trip")

search-flight#

ParameterRequiredDescription--originYesDeparture city--destinationYesArrival city in Japan--dep-dateNoDeparture date YYYY-MM-DD``--sort-typeNo3 = price ascending (default)

search-hotels#

ParameterRequiredDescription--dest-nameYesCity name in Japan--check-in-dateNoYYYY-MM-DD``--check-out-dateNoYYYY-MM-DD``--sortNorate_desc (default for travel planning)--max-priceNoBudget cap in CNY--key-wordsNoSpecial requirements (e.g., "onsen", "温泉")

search-poi#

ParameterRequiredDescription--city-nameYesCity name--categoryNoSee category mapping in Domain Knowledge--keywordNoSpecific attraction name--poi-levelNoRating 1– 5 (5 = top tier)

Core Workflow — Multi-Command Orchestration#

Step 0: Environment Check (mandatory)#

bash

flyai --version

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:

text

Ask (max 3 questions):
"1. Where are you departing from?
 2. When do you plan to go, and for how many days?
 3. Any specific cities or activities you want?"

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 TypeCommands to ExecuteVisa questionflyai fliggy-fast-search --query "Japan visa"Flight searchflyai search-flight --origin "{origin}" --destination "{city}" --dep-date "{date}" --sort-type 3Hotel searchflyai search-hotels --dest-name "{city}" --check-in-date "{in}" --check-out-date "{out}" --sort rate_descAttraction searchflyai search-poi --city-name "{city}" --category "{cat}"Full itineraryExecute 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#

bash

# Single: flights to Tokyo
flyai search-flight --origin "Shanghai" --destination "Tokyo" \
  --dep-date 2026-05-01 --sort-type 3

# Single: Kyoto temples
flyai search-poi --city-name "Kyoto" --category "宗教场所"

# Full itinerary: visa + flights + hotels + attractions
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 "市集"

Output Rules#

Full Itinerary Format#

markdown

## 🇯🇵 Japan {days}-Day Itinerary

**Route:** {City A} → {City B} → {City C} · Estimated budget: ¥{total}/person

### 📋 Preparation
| Item | Details |
|------|---------|
| ✈️ Outbound | {origin}→{dest} ¥{price} · {airline} · [Book]({detailUrl}) |
| ✈️ Return | {dest}→{origin} ¥{price} · {airline} · [Book]({detailUrl}) |
| 📄 Visa | {info from CLI} |
| 🚄 Transport | {enrichment: JR Pass recommendation if applicable} |

### Day {N} · {City} — {Theme}
🏨 **Hotel:** {name} ¥{price}/night · [Book]({detailUrl})
| Time | Activity | Details |
|------|----------|---------|
| AM | {poi_name} | {category} · [Tickets]({detailUrl}) |
| PM | {poi_name} | {category} · [View]({detailUrl}) |
| Eve | {activity} | {enrichment tip from domain knowledge} |

---
🇯🇵 Powered by flyai · Real-time pricing, click to book

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)#

CityAirportNotesTokyoNRT (Narita), HND (Haneda)NRT = international, HND = domestic + some intlOsakaKIX (Kansai)Budget flights often land hereSapporoCTS (New Chitose)Hokkaido gatewayOkinawaOKA (Naha)Island destinationFukuokaFUKKyushu gateway

Category Mapping (for --category in search-poi)#

User Interest--category ValueNature / scenery自然风光 or 山湖田园History / ruins历史古迹 or 人文古迹Temples / shrines宗教场所Food / markets市集Theme parks主题乐园Hot springs / onsen温泉Skiing滑雪Museums博物馆Shopping / pop culture城市观光 or 文创街区

Seasonal Context (for enrichment only)#

MonthHighlightImpact on PlanningMar–AprCherry blossomHotels 1.5-2x price, book 2 months aheadJul–AugSummer festivalsHot + typhoon riskOct–DecAutumn foliageKyoto hotels tight in NovJan–FebSki season / snow festivalsPack 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#

FilePurposeWhen to readreferences/templates.mdParameter SOP + output templatesStep 1 and Step 3references/playbooks.md4 itinerary playbooks with CLI sequencesStep 2 full itineraryreferences/fallbacks.md6 failure recovery pathsOn command failurereferences/runbook.mdExecution log schemaBackground