旅游攻略助手

技能文档

---
name: travel-guide-assistant
description: 旅游攻略助手。当用户需要规划行程、制定旅行路线、推荐景点/美食/住宿、估算预算或生成多日旅行攻略时使用。触发词包括「旅游攻略」「行程规划」「去XX玩几天怎么安排」「帮我做一份XX的旅行计划」「亲子游/情侣游/毕业旅行推荐」等。
category: 通用技能
title: 旅游攻略助手
---

# 旅游攻略助手

## 概述
将用户的旅行想法转化为结构清晰、可执行的成稿攻略。覆盖需求采集、目的地调研、行程编排、配套建议与多格式输出（Markdown / HTML / 图片 / PDF，最终交付图片）。

## 何时使用
- 用户请求规划行程、制定路线、生成旅行攻略
- 用户询问某目的地「怎么玩」「玩几天」「带娃/情侣去哪」
- 用户需要景点、美食、住宿、交通、预算、行李、避坑等实用信息

## 使用说明
直接描述旅行需求即可触发，例如：
- 「帮我做一份成都 4 日游攻略」
- 「五一去重庆 3 天怎么安排，带爸妈」
- 「三亚亲子游 5 天，预算人均 3000」

技能自动补齐缺失信息后，依次执行：需求采集 → 目的地调研 → 行程编排 → 成稿输出 → 渲染导出（默认交付 PNG 长图）。需其他格式时执行：
`python scripts/build_itinerary.py input.json out.html`（或 `out.pdf` / `out.md`）

## 工作流程

### 1. 采集需求（先补后做）
先用提问或合理默认补齐以下 6 项，单次不要超过 3 个问题：
- 目的地（城市 / 国家 / 区域）
- 天数与大致日期（判断季节、天气、人潮）
- 预算区间与人均预期
- 同行人（独行 / 情侣 / 亲子 / 长辈 / 朋友）
- 兴趣偏好（人文 / 自然 / 美食 / 购物 / 冒险 / 休闲）
- 特殊限制（无障碍、带娃、体力、签证、忌口）

若用户已给出足够信息则直接进入调研。

### 2. 目的地调研（实时）
用 WebSearch / WebFetch 检索并交叉验证：
- 必玩景点 Top 名单、门票、开放时间、建议游览时长
- 最佳季节、近期天气、节庆活动
- 市内交通方式、抵达方式、热门住宿分区
- 特色美食与推荐餐馆、当地物价水平
每条结论附信息来源链接。

### 3. 行程编排
- 按天排路线，遵循：相邻景点就近、单日主景点 ≤ 3–4 个
- 预留用餐与缓冲时间，标注预计花费与时长
- 兼顾节奏：上午精力好排远郊 / 大景点，傍晚排休闲 / 夜景
- 亲子 / 长辈行程降低密度、增加休息点

### 4. 成稿输出
套用 references/itinerary-template.md 生成结构化攻略，至少包含：
行前速览、每日行程表、美食地图、住宿分区、交通指南、预算拆分、行李清单、避坑提示。

### 5. 渲染与导出（最终交付图片）
- 直接导出图片（默认最终交付物，整页长图）：scripts/build_itinerary.py input.json out.png
  - 脚本优先用 Playwright（Chromium）整页截图，完美保留 guide-style.css 样式与中文、长图不断页
  - 若无 Playwright，回退到本机 Edge / Chrome 高窗无头截屏 + 裁剪底部留白
  - 也支持 .jpg / .webp 格式
- 需网页版预览时渲染 HTML：scripts/build_itinerary.py input.json out.html
- 需 PDF 时用 .pdf 输出：scripts/build_itinerary.py input.json out.pdf
- 也可用 .md 输出纯文本版：scripts/build_itinerary.py input.json out.md

### 6. 地图合规（如涉及中国地图）
若成稿包含中国地图（含港澳台），先加载 geo-map-compliance-guard 做合规校验，使用合规底图与标注，确保领土完整与正确命名。

## 资源
- references/itinerary-template.md：成稿结构与段落规范，直接套用
- references/research-checklist.md：调研维度与检索提示词清单
- scripts/build_itinerary.py：把 JSON 行程数据渲染为 Markdown / HTML / 图片 / PDF（最终交付图片）
- assets/guide-style.css：HTML 攻略样式

## 输出约定
- 最终交付图片（PNG 长图）；同时可附 HTML 预览与 Markdown 文本版、PDF 版
- 金额默认用人民币 ¥，涉外币种时注明
- 信息注明时效（「以出行前最新为准」）

## 错误处理
- 调研失败：WebSearch / WebFetch 无结果或来源冲突时，标注「信息待核实」并提示用户出行前再确认，不编造数据。
- 渲染失败：`build_itinerary.py` 优先 Playwright，回退本机 Edge / Chrome，均不可用时抛出 `无法生成图片` 错误；PDF 在浏览器不可用且无 fpdf2 / 中文字体时提示缺失依赖。
- 输入异常：JSON 字段缺失时按空值降级渲染，不中断；文件不存在由脚本报错退出。
- 地图合规：含中国地图时先过 geo-map-compliance-guard，未通过不输出地图。

## 禁止事项
- 禁止编造景点、票价、开放时间等事实数据；无可靠来源时明确标注待核实。
- 禁止输出未通过合规校验的中国地图。
- 禁止在未补齐关键需求（目的地 / 天数 / 同行人）时直接臆造完整攻略。
- 禁止将 SKILL.md 篇幅扩展到 500 行以上。

使用说明

# 旅游攻略助手（travel-guide-assistant）

将旅行想法转化为结构清晰、可执行的成稿攻略，覆盖需求采集、目的地调研、行程编排、配套建议与多格式输出（Markdown / HTML / 图片 / PDF，最终交付图片）。

## 使用方式

在 AI 对话中描述旅行需求即可触发，例如「帮我做一份成都 4 日游攻略」。信息不足时会先补齐目的地、天数、预算、同行人、兴趣偏好、特殊限制，随后自动执行调研、编排、成稿与渲染。

## 输出格式

默认交付整页 PNG 长图，可按需输出 HTML 预览 / PDF / Markdown 文本版。

## 构建脚本

`scripts/build_itinerary.py` 把结构化行程 JSON 渲染为多种格式：

```bash
python build_itinerary.py input.json out.png    # 图片（默认最终交付）
python build_itinerary.py input.json out.html   # HTML 预览
python build_itinerary.py input.json out.pdf    # PDF
python build_itinerary.py input.json out.md     # Markdown
```

依赖：图片裁剪 / 格式转换用 `Pillow`，整页截图（可选）用 `playwright`，PDF 兜底（可选）用 `fpdf2`。

## 输出约定

- 金额默认人民币 ¥，涉外币种注明
- 信息注明时效（「以出行前最新为准」）
- 涉及中国地图（含港澳台）先过合规校验，确保领土完整与正确命名

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。