# Travel Agent

> 私人旅行管家 — 从出发地到目的地的完整行程规划+Word攻略导出。 输入出发地、目的地、天数、预算、风格偏好，自动输出闭环行程， 包含交通推荐、酒店推荐、美食路线、每日预算，并可选生成 带路线地图的Word文档攻略。 当用户提到「做攻略」「旅行规划」「旅游计划」「行程安排」时使用。

- Skill: `xiaoiyuyao/travel-agent` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds add xiaoiyuyao/travel-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiaoiyuyao/travel-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: XiaoiYuyao (https://skillmd.com/u/xiaoiyuyao)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/xiaoiyuyao/travel-agent

---


# 私人旅行管家 · Travel Agent Skill

> 「不是给你一堆信息，是给你一张可以直接执行的日程表。」

---

## 核心能力

| 功能 | 说明 |
|:---|:---|
| 📋 行程规划 | 输入地点/天数/预算/风格，输出完整行程 |
| 🚄 交通推荐 | 高铁车次/航班 + 票价 + 购票指引 |
| 🏨 住宿推荐 | 区域+档次+价格+预订平台指引 |
| 🍜 美食路线 | 餐厅推荐+人均+平台链接 |
| 💰 预算透明 | 每日花费小计 + 总预算汇总 + 省钱方案 |
| 📄 导出Word | 一键生成带路线地图的攻略文档 |

---

## 工作流

### Step 1：收集信息

一次性问清以下问题（使用 AskUserQuestion 工具）：

1. **出发地和目的地**（从哪到哪）
2. **出行天数**（几天几晚）
3. **预算**（总预算，单位元/人）
4. **出行时间**（具体日期或大概月份）
5. **同行人**（独自/情侣/朋友/带老人小孩）
6. **风格偏好**（休闲/特种兵/美食/文化/自然/混合）
7. **特殊要求**（有没有不想去或特别想去的）

### Step 2：研究

使用 WebSearch 获取实时信息：

| 查什么 | 为什么 |
|:---|:---|
| 高铁/航班信息 | 确保推荐的车次存在且价格合理 |
| 酒店区域+价格 | 推荐的档次和预算匹配 |
| 景点+门票 | 景点真实存在且时间安排合理 |
| 当地美食 | 推荐真实店铺，不瞎编 |
| 当地天气 | 影响行程安排 |

### Step 3：输出完整行程

按天输出，包含：交通、住宿、美食、景点、每日小计。

### Step 4：可选 — 生成Word攻略

如果用户说「导出」「生成文档」「做成Word」等，使用配套脚本生成：
- `scripts/generate_travel_doc.py` — 带行程数据 → 生成Word + 交互地图
- 脚本需要根据实际行程修改数据后运行

---

## 配套网页版

本 Skill 附带 **Gradio 网页版**（`gradio_app/app.py`），供非 Claude Code 用户使用。
数据互通——Skill 对话可输出到网页版数据格式，网页版可离线生成攻略。

```
cd gradio_app && python app.py
# → http://localhost:7870
```

```bash
pip install python-docx folium matplotlib Pillow
python scripts/generate_travel_doc.py
```

输出：
- `攻略.docx` — 带路线地图的Word文档
- `route_map.html` — 交互式地图（可缩放）

---

## 输出模板

```
📋 行程总览
├── 路线：广州 → 贵阳
├── 天数：3天2晚
├── 预算：¥2,000/人
├── 预估总花费：¥1,568/人 ✅ 预算内
└── 风格：休闲+美食

───── Day 1 ─────

🚄 交通
  推荐：G2942 广州南 07:44 → 贵阳北 11:10
  票价：¥406 | 用时：3h26min
  🔗 12306搜索「广州南→贵阳北」

🏨 住宿
  推荐区域：喷水池/大十字 | 舒适型酒店 ¥250~350/晚
  🔗 携程搜「贵阳喷水池酒店」

🍜 午餐
  推荐：亮欢寨酸汤鱼（飞山街店）| 人均¥80
  🔗 高德导航「亮欢寨飞山街」

💰 Day 1 小计：¥723

───── 预算汇总 ─────
📊 总计：¥1,568/人 | 预算剩余：¥432
```

---

## 边界情况

| 情况 | 处理 |
|:---|:---|
| 预算过低 | 提示预算紧张，推荐省钱方案 |
| 时间太短 | 减少景点，保证行程不赶 |
| 带老人小孩 | 减少走路，安排午休 |
| 季节不适合 | 提示替代目的地 |
| 目的地不熟 | WebSearch先做功课 |

---

## 局限

- 不直接链接12306/携程/美团，只提供搜索关键词和跳转指引
- 车次/票价/酒店价格有时效性，以实际为准
- 美食推荐基于网络信息，实际体验因人而异
- 建议出发前用高德确认路线和交通时间