travel-planner-skill
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 8 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
面向中国大陆行程的 AI Agent Skill：整合官方、高德、小红书、美团和国内 OTA，生成可校验的对话攻略与响应式 HTML，支持 npx 安装和引导式线上部署。
travel-planner 是一个可安装到 Codex、Claude Code、Cursor 等 AI Agent 的中国大陆旅行规划 Skill。安装后，只需告诉 AI 目的地、日期、人数、预算和偏好，它就会调研最新信息、编排每日路线，并生成一份可以直接使用的旅行攻略。
一份行程会同时提供两种形式：
- 对话版攻略：完整内容直接显示在聊天中；
- 行程网页：响应式单文件 HTML，可在手机上查看、离线保存或分享给同行人。
为什么使用
- 信息更可靠：查询近期开放时间、票价、预约规则、交通和价格，并保留来源与核对时间；
- 路线能执行：围绕每天的主要区域排线，计算地点之间的通勤时间，兼顾酒店往返与返程缓冲；
- 准备更完整：统一整理餐厅、预算、待订事项、雨天备选和与同行人有关的安全提醒；
- 方便继续修改：更换酒店、航班或景点后，重新核对受影响的路线和费用；
- 多端阅读：同一份行程同时生成对话版和适合手机浏览的 HTML。
适合规划多日旅行、优化已有路线、出发前复核信息，以及行程临时变化后的调整。
快速开始
1. 安装
npx skills add SquirrelSong5/travel-planner-skill
安装命令使用 Skills CLI，会识别当前使用的 AI Agent。需要在所有项目中使用时加 --global。
git clone https://github.com/SquirrelSong5/travel-planner-skill.git travel-planner
2. 直接描述行程
帮我规划成都 3 天 2 晚，2 个人，住春熙路，
想看熊猫、吃川菜，最后一天 18:00 的航班。
已有方案也可以继续修改：
把第二天晚餐换到宽窄巷子附近，只重新核对受影响的路线和预算。
每次会得到什么
| 交付物 | 用途 |
|---|---|
| 对话版攻略 | 直接阅读完整日程、交通、餐饮、预算、预约和 Plan B |
trip.html |
手机查看、离线保存和分享 |
trip.json |
保存结构化行程，方便后续继续修改 |
需要在线分享时，直接告诉 AI“把行程部署到线上”。travel-planner 自带部署引导，会根据当前环境推荐 GitHub Pages、Cloudflare Pages、Netlify 或 Vercel 等托管方式，并协助生成可直接访问的网页链接。
五个信息源怎么分工
完整多日攻略默认逐一尝试 5 类来源，但每个平台只做自己擅长的事：
| 阶段 | 信息源 | 主要用途 |
|---|---|---|
| 发现 | 小红书 | 近期玩法、分区、排队和踩雷信号 |
| 确认 | 官方与运营方 | 开放、预约、票务、临时通知和交通规则 |
| 落线 | 高德地图 | POI、坐标、顺路程度和通勤时间 |
| 餐饮 | 美团攻略 | 按区域、菜系、预算和场景建立餐厅候选 |
| 交易 | 携程等国内 OTA | 酒店、交通、门票的价格和可订状态 |
交付前会再次核对开放状态、主要路线和可订价格。攻略中会显示各类来源的使用状态和核对时间；不同来源发生冲突时，以最新官方信息为准。
推荐能力
若希望获取更完整的实时数据，建议让 AI Agent 具备以下能力：
- 网页搜索或浏览器：查询官方通知、OTA 页面和餐饮攻略，通常由 Agent 自带；
- 高德地图 MCP：查询 POI、坐标和路线，见高德官方接入文档；
- 小红书 MCP Skill：补充近期玩法、排队体验和避雷信息。
npx skills add autoclaw-cc/xiaohongshu-mcp-skills --skill xiaohongshu
小红书 Skill 还需要配置对应的 MCP 服务并完成用户登录。未配置时仍可使用其他来源生成行程，但不会包含小红书的近期体验信息。配置方法见 setup-guide.md。
本地验证与渲染只需要 Python 3.10+，不需要第三方 Python 包。
python -m unittest discover -s tests -v
python scripts/validate.py examples/chengdu-2026-09-18.json --pretty --fail-on-warn --as-of 2026-08-24
python scripts/render_markdown.py examples/chengdu-2026-09-18.json -o /tmp/trip.md
python scripts/render_html.py assets/template.html examples/chengdu-2026-09-18.json -o /tmp/trip.html
完整文档
| 文档 | 内容 |
|---|---|
| SKILL.md | Agent 主工作流 |
| data-sources.md | 五类来源、证据优先级与降级 |
| planning.md | 行程编排方法 |
| validation-rules.md | V0–V13 校验规则 |
| recheck-and-safety.md | 行前复核、临场调整与安全提醒 |
Star History
如果它帮你省下了做攻略和反复核对的时间，欢迎点一个 Star。问题和真实旅行场景可以提交到 Issues。
License
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found