awangwang123/jianhao-travel-planner

见好 · 旅行规划器

What it is – 一个 Claude‑AI skill，能将“我这周末想去 X 地旅游”这类简单需求，转化为一份完整的、可离线阅读的旅行手册。该技能遵循固定的工作流程：收集用户偏好、从公开来源获取最新资讯，并产出两项产出物：

1. 单文件 HTML 旅行手册（无需网络即可运作的完整版，以及可自行部署的轻量化线上版）。
2. “美食情报卡”，能随时间累积特定城市的餐饮数据。

产出文件结构丰富，包含十个章节——概览、交通、每日行程、票务、小贴士、住宿、预算、紧急状况、美食清单与在地特产——每一项都配有真实照片、手绘路线图以及经过验证的价格与可用性数据。

---

你将获得的功能

• 📄 单文件 HTML 旅行手册 – 在电脑、手机或打印出来皆美观，且可完全离线开启。
• 🌐 可选的一键线上部署 – 可托管在您自己服务器上的精简 HTML 版本。
• 🔍 经过验证的资讯 – 关键事实（价格、营业时间、交通选项）会与即时来源（如大众点评、高德地图、小红书）进行交叉比对，并包含来源引用。
• 🖼 真实照片 + 手绘地图 – 没有通用的库存图片；该技能会抓取近期的 Wikimedia 图片，或者若您偏好，也可使用 Pexels 或您自己 AI 生成的占位符。
• 🍜 结构化美食推荐 – 按天、按餐次的清单，包含必吃菜色与平均花费。
• ✅ 内建检查清单 – tools/checklist.py 会在 AI 完成文件前执行 11 项自动化一致性检查，确保没有遗漏任何资讯。
• 🔒 无个人资料泄露 – 该技能绝不会储存敏感的用户资讯。

---

运作方式（高阶流程）

1. 触发 – 对 Claude 说出触发语句（例如：“周末想去厦门玩”）。
2. 偏好收集 – 技能会读取 SKILL.md 中的用户档案模板（出发城市、饮食偏好、旅游风格等）。
3. 即时数据抓取 – 查询公开 API / 网络来源以获取天气、交通选项、票价、餐厅评论等。
4. 文件生成 – 填充 Markdown 原始档（md 事实文件），然后渲染位于 assets/ 中的两个 HTML 模板。
5. 自我检查 – 执行 tools/checklist.py（以及用于数据清理的 tools/desource.py）。若 11 项检查中有任何失败，Claude 会被提示修正问题。
6. 交付 – 您将收到单文件的 HTML 旅行手册与美食情报卡。

---

快速安装（约 2 分钟）

1. 下载 仓库并解压缩。顶层文件夹名称必须保持为 jianhao‑travel‑planner。
2. 放置文件夹 到 Claude 的技能目录：
   • 全局：~/.claude/skills/ (Windows: C:\Users\<User>\.claude\skills\)。
   • 或项目本地：<your‑project>/.claude/skills/。
3. 验证路径 – 您应该能看到 …/skills/jianhao-travel-planner/SKILL.md。
4. (选填) 设定 Pexels API key 若您想使用 Pexels 图片：在仓库根目录的 .env 文件中加入 PEXELS_API_KEY=your_key。
5. 填写您的档案 – 开启 SKILL.md，滚动至“用户档案（填空模板）”章节，并完成占位符（居住城市、饮食偏好、旅游节奏等）。
6. 与 Claude 对话 – 说出如“周末想去成都玩”的触发语句，技能即会开始工作流程。

---

适用对象

• 旅游爱好者，想要一份精美、可打印的行程表，而无需手动拼凑资讯。
• 内容创作者 / 旅游博主，需要一份可复制、有来源引用的旅行手册与粉丝分享。
• 小型旅行社或自由职业者，想要自动化生成行程，同时保有对数据与品牌形象的完全控制。

---

当前状态

• 持续维护中（最新版本 v1.7，发布于 2026‑10‑08）。
• 以 MIT 授权条款开源。
• 通过 GitHub Discussions 进行社区驱动的功能请求（例如：“城市愿望池”）。

---

TL;DR – 见好·旅行规划器 是一个 Claude‑AI 技能，只需一个口头请求，即可产出一份格式精美、可离线使用的旅行指南，内容包含验证过的数据、真实照片与美食推荐卡，且无需任何付费 API。