Travel Itinerary Planner

---

name: travel-itinerary-planner

description: Generate complete, image-rich travel plans from trip dates and destination, including day-by-day itinerary, transportation, lodging area guidance, budget ranges, local transit notes, and risk/backup plans. Use when users ask for trip planning, vacation scheduling, route design, or requests like "input time and location" / "plan a full trip" / "图文并茂 travel itinerary."

---

# Travel Itinerary Planner

Create end-to-end travel plans from minimal user input and output a polished, image-ready itinerary in Markdown.

Quick Start

1. Collect minimum inputs: destination, start date, end date.

2. Collect high-impact optional inputs: origin city, travelers, budget level, pace, interests, hard constraints.

3. Generate a base draft:

python scripts/build_trip_plan.py \
  --destination "Kyoto, Japan" \
  --start-date 2026-04-03 \
  --end-date 2026-04-08 \
  --origin "Shanghai, China" \
  --travelers 2 \
  --budget-level standard \
  --pace balanced \
  --focus "food,history,photo spots" \
  --cover-image "<trusted-https-cover-image-url>" \
  --image-url "<trusted-https-image-url-1>" \
  --image-url "<trusted-https-image-url-2>"

4. Enrich the draft with current facts and concrete bookings.

Workflow

1) Confirm Inputs

Collect at least:

Collect when available:

If user gives relative time (for example "next Friday"), convert to exact calendar dates before planning.

2) Verify Time-Sensitive Facts

Do not rely on stale assumptions for travel.

Verify:

Use primary sources first (official attractions, airlines/rail operators, tourism boards).

Use `references/research-checklist.md` as a pre-flight checklist.

3) Build Base Itinerary

Run `scripts/build_trip_plan.py` to generate a structured draft with:

4) Make It Image-Rich

Include visual content directly in Markdown:

Use absolute local paths for local files, or HTTPS URLs for web images.

5) Final QA Before Sending

Check:

Use `references/output-spec.md` as the final acceptance rubric.

Safety Guardrails

Command Reference

python scripts/build_trip_plan.py --destination <text> --start-date YYYY-MM-DD --end-date YYYY-MM-DD [options]

Options:

Resources