Travel Planner

Overview

このスキルは、Claude を包括的な旅行計画アシスタントに変え、旅行の好みを管理し、任意の目的地に対する旅程、予算内訳、梱包リスト、文化的なガイドラインを含む詳細でパーソナライズされた旅行計画を生成します。

When to Use This Skill

旅行関連のタスクにこのスキルを呼び出してください：

• 旅行計画と旅程表の作成
• 予算計画と支出追跡
• 目的地リサーチとレコメンデーション
• 梱包チェックリスト
• 文化的エチケットとマナーの注意事項
• 旅行前の準備タイムライン
• 旅行の好み管理

Workflow

Step 1: 既存の好みを確認

旅行の好みが存在するか確認します：

python3 scripts/travel_db.py is_initialized

「false」の場合、Step 2（セットアップ）に進みます。「true」の場合、Step 3（旅行計画）に進みます。

Step 2: 初期の好み収集

好みが存在しない場合、包括的な旅行情報を収集します：

旅行スタイルと予算：

• 予算レベル：budget、mid-range、luxury
• 旅行ペース：relaxed、moderate、packed
• 宿泊施設の好み：hostel、hotel、Airbnb、resort
• 旅の同伴者：solo、couple、family、group

興味とアクティビティ：

• 観光地と名所
• 食べ物とグルメ体験
• アドベンチャーとアウトドア活動
• 文化と歴史
• ビーチとリラックス
• ナイトライフとエンターテイメント
• ショッピング
• 自然と野生動物
• 写真
• ウェルネスとスパ

食事と健康：

• 食事制限（ベジタリアン、ビーガン、アレルギー）
• アクセシビリティの必要性
• 健康上の配慮
• フィットネスレベル

言語とスキル：

• 話せる言語
• 旅行経験レベル
• アドベンチャーに対する快適度

過去の旅行：

• 訪れた国と都市
• 好きな目的地
• やりたいことリスト

好みの保存：

import sys
sys.path.append('[SKILL_DIR]/scripts')
from travel_db import save_preferences

preferences = {
    "travel_style": "adventurous",
    "budget_level": "mid-range",
    "accommodation_preference": ["boutique hotels", "Airbnb"],
    "interests": ["culture", "food", "hiking", "photography"],
    "dietary_restrictions": ["vegetarian"],
    "pace_preference": "moderate",
    "travel_companions": "couple",
    "language_skills": ["English", "Spanish"],
    "previous_destinations": ["Paris", "Tokyo", "Barcelona"],
    "bucket_list": [
        {"destination": "New Zealand", "notes": "Lord of the Rings locations"},
        {"destination": "Peru", "notes": "Machu Picchu"}
    ]
}

save_preferences(preferences)

[SKILL_DIR] を実際のスキルパスに置き換えてください。

Step 3: 新しい旅行を作成

ユーザーが旅行計画を立てたい場合、以下を収集します：

基本情報：

1. 目的地：都市または国
2. 日付：出発日と帰宅日（または柔軟な日程範囲）
3. 期間：日数
4. 予算：総予算または1日の予算
5. 目的：休暇、出張、特別な機会
6. 必見・必做：特定の観光地またはアクティビティ

旅行を作成する：

from travel_db import add_trip

trip = {
    "destination": {
        "city": "Barcelona",
        "country": "Spain",
        "region": "Catalonia"
    },
    "departure_date": "2025-06-15",
    "return_date": "2025-06-22",
    "duration_days": 7,
    "budget": {
        "total": 2500,
        "currency": "USD"
    },
    "purpose": "vacation",
    "travelers": 2,
    "climate": "warm Mediterranean",
    "activities": ["sightseeing", "food tours", "beach", "architecture"],
    "accommodation": {
        "type": "boutique hotel",
        "location": "Gothic Quarter"
    }
}

trip_id = add_trip(trip, status="current")

Step 4: 目的地をリサーチ

ウェブサーチを使用して現在の情報を収集します：

基本的なリサーチ：

1. 入国要件 - ビザ、パスポート、ワクチン接種
2. 最適な訪問時期 - 天気、季節、祭り
3. 安全情報 - 旅行アドバイザリー、安全な地域、よくある詐欺
4. 文化的規範 - マナー（references/cultural_etiquette.md をガイドとして使用）
5. 地元交通 - メトロ、バス、タクシー、アプリ
6. トップアトラクション - 必見スポット（営業時間と料金）
7. 食べ物のレコメンデーション - 地元の特産品、人気レストラン
8. 近隣地区 - 宿泊場所、探索スポット
9. 日帰り旅行オプション - 近くのアトラクション
10. 実用情報 - 通貨、チップ、コンセント、言語

カバーするべき検索トピック：

• 「[目的地] visa requirements for [国籍]」
• 「[目的地] best time to visit weather」
• 「[目的地] cultural do's and don'ts」
• 「[目的地] top attractions and activities」
• 「[目的地] local transportation guide」
• 「[目的地] where to stay neighborhoods」
• 「[目的地] food and restaurants」
• 「[目的地] scams to avoid」
• 「[目的地] budget guide」
• 「[目的地] 7-day itinerary」

Step 5: 詳細な旅行計画を生成

すべてのコンポーネントを含む包括的な計画を作成します：

A. 日別の旅程

ユーザーのペース好みとリサーチに基づいて各日を構成します：

Day 1: Arrival & Gothic Quarter
- Morning (9:00 AM): Arrive Barcelona, hotel check-in
- Late Morning (11:00 AM): Walking tour of Gothic Quarter
  - Barcelona Cathedral
  - Plaça Reial
  - Las Ramblas (brief walk)
- Afternoon (2:00 PM): Lunch at Cal Pep (tapas)
- Afternoon (4:00 PM): Picasso Museum
- Evening (7:00 PM): Dinner in El Born neighborhood
- Evening (9:00 PM): Stroll along waterfront

Transportation: Metro from airport (30 min, €5)
Estimated Cost: €120/person (meals, museum, transport)
Notes: Book Picasso Museum tickets online in advance

各日について繰り返し、以下を確保します：

• 論理的な地理的グループ分け
• 緩衝時間を含む現実的なタイミング
• アクティビティタイプの混在
• 食事のサジェスチョン
• 交通の詳細
• 推定コスト
• 予約に関する注記

B. 予算内訳

plan_generator.py を使用するか、手動で作成します：

from plan_generator import calculate_budget_breakdown

budget = calculate_budget_breakdown(
    total_budget=2500,
    num_days=7,
    accommodation_level="mid-range"
)

以下のように提示します：

Total Budget: $2,500 (7 days)
Daily Average: $357

Breakdown:
- Accommodation: $875 (35%) - $125/night
  * Boutique hotel in Gothic Quarter
  * Includes breakfast

- Food: $625 (25%) - $89/day
  * Breakfast: Included
  * Lunch: $25-30/person
  * Dinner: $40-50/person
  * Snacks/drinks: $15/day

- Activities: $625 (25%) - $89/day
  * Sagrada Familia: $35
  * Park Güell: $13
  * Picasso Museum: $15
  * Food tour: $95
  * Day trip to Montserrat: $50
  * Other attractions: ~$100

- Transportation: $250 (10%) - $36/day
  * Airport transfers: $35 each way
  * Metro pass (7-day): $40
  * Taxis: ~$100 total

- Miscellaneous: $125 (5%)
  * Tips, emergencies, souvenirs

C. 梱包チェックリスト

plan_generator.py を使用するか、目的地の気候とアクティビティに基づいて生成します：

from plan_generator import generate_packing_checklist

checklist = generate_packing_checklist(
    destination_climate="warm Mediterranean",
    duration_days=7,
    trip_activities=["sightseeing", "beach", "dining"]
)

カスタマイズして提示します：

ESSENTIALS:
- [ ] Passport (check 6-month validity)
- [ ] Visa (if required)
- [ ] Travel insurance documents
- [ ] Hotel confirmations
- [ ] Flight tickets
- [ ] Credit cards (notify bank)
- [ ] Euros cash (€200-300)
- [ ] Phone & charger
- [ ] European plug adapter
- [ ] Medications

CLOTHING (June weather: 70-80°F, sunny):
- [ ] 3 pairs shorts
- [ ] 2 pairs long pants
- [ ] 5-7 t-shirts/tops
- [ ] 1-2 dresses/nice shirts for dinner
- [ ] Light jacket for evenings
- [ ] Swimsuit
- [ ] Comfortable walking shoes
- [ ] Sandals
- [ ] Sun hat
- [ ] Sunglasses

ACTIVITIES:
- [ ] Day backpack
- [ ] Reusable water bottle
- [ ] Camera
- [ ] Beach towel (compact)
- [ ] Sunscreen SPF 50
- [ ] Walking tour comfortable shoes

D. 文化的なマナーと注意事項

国固有のガイドラインをリサーチして提示します（references/cultural_etiquette.md をテンプレートとして使用）：

SPAIN / BARCELONA - Cultural Etiquette

DO'S:
✓ Greet with "Hola" and a kiss on each cheek (friends)
✓ Learn basic Spanish/Catalan phrases
✓ Eat dinner late (9-10 PM is normal)
✓ Take your time with meals
✓ Dress stylishly (locals dress well)
✓ Respect siesta time (2-5 PM, some shops close)
✓ Say "Bon profit" before meals
✓ Tip 5-10% for good service

DON'TS:
✗ Don't expect early dinner (restaurants open at 8 PM)
✗ Don't wear beach clothes in city center
✗ Don't assume everyone speaks English
✗ Don't call it Spain - it's Catalunya to locals
✗ Don't rush through meals
✗ Don't yell or be loud in public
✗ Don't take photos in churches during mass

DINING ETIQUETTE:
- Lunch: 2-4 PM
- Dinner: 9-11 PM
- Service charge sometimes included (check bill)
- Say "La cuenta, por favor" for bill
- It's okay to share tapas
- Bread is not free at all restaurants

SAFETY TIPS:
- Watch for pickpockets on Las Ramblas and metro
- Keep bag in front in crowded areas
- Don't leave valuables on beach
- Be cautious accepting help from strangers
- Use official taxis or Uber/Cabify

E. 旅行前の準備タイムライン

plan_generator.py を使用するか、出発日に基づいて作成します：

from plan_generator import generate_pre_trip_checklist

prep_checklist = generate_pre_trip_checklist(
    destination_country="Spain",
    departure_date="2025-06-15"
)

タイムラインとして提示します：

PRE-TRIP CHECKLIST

2 MONTHS BEFORE (April 15):
- [ ] Book flights
- [ ] Book hotel
- [ ] Purchase travel insurance
- [ ] Check passport expiration
- [ ] Research visa requirements
- [ ] Start researching activities

1 MONTH BEFORE (May 15):
- [ ] Book Sagrada Familia tickets (sell out!)
- [ ] Book food tour
- [ ] Book any other popular activities
- [ ] Notify bank of travel dates
- [ ] Set up international phone plan
- [ ] Download offline maps (Google Maps, Citymapper)
- [ ] Make dinner reservations (popular restaurants)

2 WEEKS BEFORE (June 1):
- [ ] Confirm all reservations
- [ ] Print/save all confirmations offline
- [ ] Exchange some currency (~€200)
- [ ] Check weather forecast
- [ ] Create packing list
- [ ] Arrange pet/plant care
- [ ] Hold mail delivery

1 WEEK BEFORE (June 8):
- [ ] Check in for flights (24 hours before)
- [ ] Pack luggage
- [ ] Charge all electronics
- [ ] Download language apps (Google Translate, Duolingo)
- [ ] Save emergency numbers
- [ ] Make copies of passport
- [ ] Clean out fridge

DAY BEFORE (June 14):
- [ ] Re-check flight time
- [ ] Prepare carry-on
- [ ] Take out trash
- [ ] Adjust thermostat
- [ ] Unplug electronics
- [ ] Set multiple alarms for departure

Step 6: 旅行と予算を追跡

旅行中に支出を追跡します：

from travel_db import add_expense

expense = {
    "category": "food",
    "amount": 45.00,
    "description": "Dinner at Cervecería Catalana",
    "date": "2025-06-16"
}

add_expense(trip_id, expense)

予算状況を表示します：

from travel_db import get_budget_summary

summary = get_budget_summary(trip_id)
# Shows: total_budget, spent, remaining, percentage_used, by_category

Step 7: 旅行後のアップデート

旅行後、過去の旅行に移動してアップデートします：

from travel_db import move_trip_to_past, add_previous_destination

move_trip_to_past(trip_id)
add_previous_destination("Barcelona, Spain")

Best Practices

1. 徹底的にリサーチする - ウェブサーチを使用して、現在の正確な情報を入手する
2. 現実的である - スケジュールに余裕を詰め込みすぎず、休息と自発性の時間を確保する
3. 事前に予約する - 人気のアトラクション、特にピークシーズンでは売り切れることがある
4. 予算バッファを追加する - 予期しないコストに備えて、10～20% 多めに計上する
5. 文化的に尊重する - 地元の慣習をリサーチして従う
6. 安全が第一 - 旅行アドバイザリーを確認し、大使館に登録する
7. 柔軟性を保つ - 天気と状況は変わる
8. すべてを記録する - 確認メール、重要な情報をオフラインで保存する

Example Interaction

User: "I want to plan a 7-day trip to Barcelona in June"

Claude: [Checks preferences - finds initialized]

Great! I'll create a detailed travel plan for Barcelona. Based on your preferences,
I know you enjoy culture, food, and moderate-paced travel with a mid-range budget.

First, a few questions:
1. What are your exact travel dates?
2. What's your total budget?
3. Any specific must-see attractions?
4. Traveling solo or with someone?

User: "June 15-22, $2500 budget, want to see Gaudí architecture, traveling with partner"

Claude: [Creates trip in database, performs web research]

Perfect! I've created your Barcelona trip plan. Let me present the complete itinerary:

[Generates detailed 7-day itinerary with Sagrada Familia, Park Güell, Casa Batlló, etc.]
[Creates budget breakdown: $2500 over 7 days]
[Generates packing checklist for June Mediterranean weather]
[Provides Spanish cultural do's and don'ts]
[Creates timeline of pre-trip tasks]

Key highlights:
✓ Day 2: Sagrada Familia (book tickets NOW - they sell out)
✓ Day 4: Food tour in El Born (€95/person, worth it!)
✓ Day 6: Day trip to Montserrat
✓ Budget: $357/day average (€325)
✓ Accommodation: €125/night in Gothic Quarter

Important notes:
- Book Sagrada Familia tickets immediately
- Dinner reservations needed for Tickets Bar, Cervecería Catalana
- Pickpocket awareness on Las Ramblas
- Bring European plug adapter (Type C/F)

Would you like me to adjust anything in the itinerary?

Technical Notes

データストレージ：

• Preferences: ~/.claude/travel_planner/preferences.json
• Trips: ~/.claude/travel_planner/trips.json

CLI コマンド：

# Check initialization
python3 scripts/travel_db.py is_initialized

# View data
python3 scripts/travel_db.py get_preferences
python3 scripts/travel_db.py get_trips current
python3 scripts/travel_db.py stats

# Generate plan
python3 scripts/plan_generator.py --trip-id <id> --output plan.json

# Export backup
python3 scripts/travel_db.py export > backup.json

Resources

scripts/travel_db.py

好み、旅行、予算追跡、旅程表、旅行統計のためのデータベース管理。

scripts/plan_generator.py

旅程表、予算内訳、梱包チェックリスト、準備タイムラインを生成します。

references/travel_guidelines.md

目的地リサーチ、予算計画、旅程表作成、梱包戦略、安全のヒントのための包括的なガイド。

references/cultural_etiquette.md

国固有の慣習、ドレスコード、ダイニングエチケット、宗教的配慮、よくある間違いをリサーチするためのテンプレートとガイドライン。