旅行规划师Skill travel-planner

旅行规划师

概览

这个技能将 Claude 转变为一个全面的旅行规划助手，维护您的旅行偏好，并生成详细的个性化旅行计划，包括行程、预算细分、打包清单和文化指南，适用于任何目的地。

何时使用此技能

调用此技能进行与旅行相关的任务：

• 规划旅行和创建行程
• 预算规划和费用跟踪
• 目的地研究和推荐
• 打包清单
• 文化礼仪和注意事项
• 旅行前的准备时间表
• 旅行偏好管理

工作流程

第1步：检查现有偏好

检查是否存在旅行偏好：

python3 scripts/travel_db.py is_initialized

如果为“false”，请进行第2步（设置）。如果为“true”，请进行第3步（行程规划）。

第2步：初始偏好收集

当不存在偏好时，收集全面的旅行信息：

旅行风格和预算：

• 预算水平：预算、中档、豪华
• 旅行节奏：放松、中等、紧凑
• 住宿偏好：旅社、酒店、Airbnb、度假村
• 旅行伴侣：独自、情侣、家庭、团体

兴趣和活动：

• 观光和地标
• 食品和美食体验
• 冒险和户外活动
• 文化和历史
• 海滩和放松
• 夜生活和娱乐
• 购物
• 自然和野生动物
• 摄影
• 健康和水疗

饮食和健康：

• 饮食限制（素食、纯素、过敏）
• 无障碍需求
• 健康考虑
• 健康水平

语言和技能：

• 语言能力
• 旅行经验水平
• 冒险舒适度

以前的旅行：

• 访问过的国家/城市
• 最喜欢的目的地
• 愿望清单目的地

保存偏好：

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]’ 为实际技能路径。

第3步：创建新行程

当用户想要规划旅行时，收集：

基本信息：

1. 目的地：城市/国家
2. 日期：出发和返回日期（或灵活的日期范围）
3. 持续时间：天数
4. 预算：总预算或每日预算
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")

第4步：研究目的地

使用网络搜索收集当前信息：

基本研究：

1. 入境要求 - 签证、护照、疫苗接种
2. 最佳访问时间 - 天气、季节、节日
3. 安全信息 - 旅行警告、安全区域、常见骗局
4. 文化规范 - 行为准则（使用 references/cultural_etiquette.md 作为指南）
5. 当地交通 - 地铁、公交、出租车、应用
6. 顶级景点 - 必看地点及开放时间和价格
7. 食品推荐 - 当地特色菜、热门餐厅
8. 社区 - 住宿地点、探索地点
9. 日游选项 - 附近景点
10. 实用信息 - 货币、小费、电源插座、语言

搜索主题涵盖：

• “[目的地] 对 [国籍] 的签证要求”
• “[目的地] 最佳访问时间天气”
• “[目的地] 文化行为准则”
• “[目的地] 顶级景点和活动”
• “[目的地] 当地交通指南”
• “[目的地] 住宿社区”
• “[目的地] 食品和餐厅”
• “[目的地] 避免的骗局”
• “[目的地] 预算指南”
• “[目的地] 7天行程”

第5步：生成详细旅行计划

创建包含所有组件的全面计划：

A. 日行程

根据用户的节奏偏好和研究结构化每一天：

第1天：到达 & 哥特区
- 上午（9:00）：到达巴塞罗那，酒店登记入住
- 晚上午（11:00）：哥特区步行游览
  - 巴塞罗那大教堂
  - Plaça Reial
  - 拉斯兰布拉斯（简短步行）
- 下午（2:00）：在 Cal Pep 吃午餐（小吃）
- 下午（4:00）：毕加索博物馆
- 晚上（7:00）：在 El Born 社区吃晚餐
- 晚上（9:00）：沿海滨散步

交通：从机场乘坐地铁（30分钟，€5）
预计费用：€120/人（餐费、博物馆、交通）
备注：提前在线预订毕加索博物馆门票

为每一天重复，确保：

• 逻辑地理分组
• 现实的时间安排与缓冲
• 活动类型的混合
• 餐饮建议
• 交通细节
• 预计费用
• 预订说明

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

呈现为：

总预算：$2,500（7天）
日均：$357

细分：
- 住宿：$875（35%）- $125/晚
  * 哥特区精品酒店
  * 包含早餐

- 食品：$625（25%）- $89/天
  * 早餐：包含
  * 午餐：$25-30/人
  * 晚餐：$40-50/人
  * 零食/饮料：$15/天

- 活动：$625（25%）- $89/天
  * 圣家堂：$35
  * 古埃尔公园：$13
  * 毕加索博物馆：$15
  * 食品之旅：$95
  * 蒙特塞拉特一日游：$50
  * 其他景点：~$100

- 交通：$250（10%）- $36/天
  * 机场接送：$35 单程
  * 地铁通行证（7天）：$40
  * 出租车：~$100 总计

- 杂项：$125（5%）
  * 小费、紧急情况、纪念品

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"]
)

自定义并呈现：

必备品：
- [ ] 护照（检查6个月有效期）
- [ ] 签证（如果需要）
- [ ] 旅行保险文件
- [ ] 酒店确认函
- [ ] 机票
- [ ] 信用卡（通知银行）
- [ ] 欧元现金（€200-300）
- [ ] 手机 & 充电器
- [ ] 欧洲插头适配器
- [ ] 药物

服装（6月天气：70-80°F，晴朗）：
- [ ] 3条短裤
- [ ] 2条长裤
- [ ] 5-7件T恤/上衣
- [ ] 1-2条连衣裙/晚餐时穿的漂亮衬衫
- [ ] 晚上穿轻便夹克
- [ ] 泳衣
- [ ] 舒适的步行鞋
- [ ] 凉鞋
- [ ] 太阳帽
- [ ] 太阳镜

活动：
- [ ] 日背包
- [ ] 可重复使用的水瓶
- [ ] 相机
- [ ] 紧凑的海滩毛巾
- [ ] SPF 50 防晒霜
- [ ] 步行游览舒适的鞋子

D. 文化行为准则

研究并呈现特定国家的指南（使用 references/cultural_etiquette.md 作为模板）：

西班牙/巴塞罗那 - 文化礼仪

要做的：
✓ 用 "Hola" 打招呼并亲吻每边脸颊（朋友）
✓ 学习基础的西班牙语/加泰罗尼亚语短语
✓ 晚餐吃得晚（9-10 PM正常）
✓ 慢慢享用餐点
✓ 穿着时尚（当地人穿着讲究）
✓ 尊重午睡时间（2-5 PM，一些商店关闭）
✓ 饭前说 "Bon profit"
✓ 优质服务支付5-10%小费

不要做的：
✗ 不要期望晚餐早（餐厅8 PM开门）
✗ 不要在市中心穿海滩装
✗ 不要假设每个人都说英语
✗ 不要称之为西班牙 - 对当地人来说是加泰罗尼亚
✗ 不要匆忙用餐
✗ 不要在公共场合大声喧哗
✗ 不要在教堂做弥撒时拍照

用餐礼仪：
- 午餐：2-4 PM
- 晚餐：9-11 PM
- 服务费有时包含（检查账单）
- 说 "La cuenta, por favor" 要求结账
- 可以分享小吃
- 并非所有餐厅的面包都是免费的

安全提示：
- 在 Las Ramblas 和地铁上小心扒手
- 在拥挤地区将包包放在前面
- 不要在海滩上留下贵重物品
- 对陌生人的帮助要谨慎
- 使用官方出租车或 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"
)

作为时间表呈现：

旅行前清单

2个月前（4月15日）：
- [ ] 预订航班
- [ ] 预订酒店
- [ ] 购买旅行保险
- [ ] 检查护照有效期
- [ ] 研究签证要求
- [ ] 开始研究活动

1个月前（5月15日）：
- [ ] 预订圣家堂门票（卖完就完了！）
- [ ] 预订食品之旅
- [ ] 预订其他热门活动
- [ ] 通知银行旅行日期
- [ ] 设置国际电话计划
- [ ] 下载离线地图（谷歌地图，Citymapper）
- [ ] 预订晚餐（热门餐厅）

2周前（6月1日）：
- [ ] 确认所有预订
- [ ] 打印/保存所有确认信息离线
- [ ] 兑换一些货币（~€200）
- [ ] 检查天气预报
- [ ] 创建打包清单
- [ ] 安排宠物/植物护理
- [ ] 暂停邮件递送

1周前（6月8日）：
- [ ] 办理登机手续（24小时前）
- [ ] 打包行李
- [ ] 为所有电子产品充电
- [ ] 下载语言应用（谷歌翻译，Duolingo）
- [ ] 保存紧急电话号码
- [ ] 复印护照
- [ ] 清理冰箱

出发前一天（6月14日）：
- [ ] 再次检查航班时间
- [ ] 准备随身携带物品
- [ ] 扔垃圾
- [ ] 调整恒温器
- [ ] 拔掉电器插头
- [ ] 设置多个闹钟出发

第6步：跟踪行程和预算

旅行期间，跟踪费用：

from travel_db import add_expense

expense = {
    "category": "food",
    "amount": 45.00,
    "description": "晚餐在 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)
# 显示：total_budget, spent, remaining, percentage_used, by_category

第7步：旅行后更新

旅行结束后，移动到过去的行程并更新：

from travel_db import move_trip_to_past, add_previous_destination

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

最佳实践

1. 彻底研究 - 使用网络搜索获取当前、准确的信息
2. 现实一点 - 不要过度安排；允许休息和自发性
3. 提前预订 - 热门景点会售罄，特别是在旺季
4. 预算缓冲 - 额外增加10-20%以应对意外费用
5. 文化尊重 - 研究并遵循当地习俗
6. 安全第一 - 检查旅行警告，向大使馆注册
7. 保持灵活 - 天气和情况会变化
8. 记录一切 - 保存确认信息，重要信息离线

示例互动

用户："我想计划6月份去巴塞罗那的7天旅行"

Claude：[检查偏好 - 已初始化]

太好了！我将为您创建巴塞罗那的详细旅行计划。根据您
的偏好，我知道您喜欢文化、美食和中等节奏的旅行，预算适中。

首先，有几个问题：
1. 您的确切旅行日期是什么时候？
2. 您的总预算是多少？
3. 有没有特别想看的景点？
4. 独自旅行还是和某人一起？

用户："6月15日至22日，$2500预算，想看高迪建筑，和伴侣一起旅行"

Claude：[在数据库中创建行程，执行网络研究]

完美！我已经为您创建了巴塞罗那旅行计划。让我向您介绍完整的行程：

[生成详细的7天行程，包括圣家堂、古埃尔公园、巴特罗之家等]
[创建预算细分：$2500超过7天]
[为6月地中海天气生成打包清单]
[提供西班牙文化行为准则]
[创建旅行前任务时间表]

关键亮点：
✓ 第2天：圣家堂（立即预订门票 - 它们会售罄）
✓ 第4天：在 El Born 的食品之旅（€95/人，值得！）
✓ 第6天：蒙特塞拉特一日游
✓ 预算：$357/天平均（€325）
✓ 住宿：€125/晚在哥特区

重要说明：
- 立即预订圣家堂门票
- 晚餐需要预订 Tickets Bar, Cervecería Catalana
- 在 Las Ramblas 上小心扒手
- 带欧洲插头适配器（Type C/F）

您想让我调整行程中的任何内容吗？

技术说明

数据存储：

• 偏好：~/.claude/travel_planner/preferences.json
• 行程：~/.claude/travel_planner/trips.json

CLI命令：

# 检查初始化
python3 scripts/travel_db.py is_initialized

# 查看数据
python3 scripts/travel_db.py get_preferences
python3 scripts/travel_db.py get_trips current
python3 scripts/travel_db.py stats

# 生成计划
python3 scripts/plan_generator.py --trip-id <id> --output plan.json

# 导出备份
python3 scripts/travel_db.py export > backup.json

资源

scripts/travel_db.py

用于偏好、行程、预算跟踪、行程和旅行统计的数据库管理。

scripts/plan_generator.py

生成行程、预算细分、打包清单和准备时间表。

references/travel_guidelines.md

目的地研究、预算规划、行程创建、打包策略和安全提示的全面指南。

references/cultural_etiquette.md

研究特定国家习俗、着装规范、用餐礼仪、宗教考虑和常见错误的模板和指南。