# Travel Agent

> >

- **Type:** Skill
- **Install:** `agentstack add skill-xiaoiyuyao-travel-agent-skill-travel-agent-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [XiaoiYuyao](https://agentstack.voostack.com/s/xiaoiyuyao)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [XiaoiYuyao](https://github.com/XiaoiYuyao)
- **Source:** https://github.com/XiaoiYuyao/travel-agent-skill

## Install

```sh
agentstack add skill-xiaoiyuyao-travel-agent-skill-travel-agent-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 私人旅行管家 · 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/携程/美团，只提供搜索关键词和跳转指引
- 车次/票价/酒店价格有时效性，以实际为准
- 美食推荐基于网络信息，实际体验因人而异
- 建议出发前用高德确认路线和交通时间

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [XiaoiYuyao](https://github.com/XiaoiYuyao)
- **Source:** [XiaoiYuyao/travel-agent-skill](https://github.com/XiaoiYuyao/travel-agent-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xiaoiyuyao-travel-agent-skill-travel-agent-skill
- Seller: https://agentstack.voostack.com/s/xiaoiyuyao
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.