关于 trip-map-builder
trip-map-builder 是通过规划、调研和构建三个阶段制作行程参考文档与地图页面的技能,适用于旅行规划。它结合地点安排、餐饮调研和地图标注,并将行程视为可随实际情况调整的参考。
主要功能
- 01按规划、调研、构建分阶段处理
- 02根据约束安排每日行程
- 03用大众点评和小红书调研餐饮
- 04生成含地点信息的地图页面
- 05记录可长期使用的旅行偏好
适用场景
- 01按日期和航班约束规划旅行
- 02结合点评与近期分享筛选餐馆
- 03把每日安排整理为交互地图页面
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ hiyeshu/ trip-map-builder --skill trip-map-builder安装后在 Claude Code 中输入/trip-map-builder确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
CLAUDE.mdREADME.mdassets/template.htmlreferences/dianping-research.mdCLAUDE.mdxhs-research.mdtrip-planning.md详细介绍
Trip Map Builder
三阶段流程:规划 → 调研 → 构建。
输出的是参考行程,而不是旅行者必须遵守的脚本。 旅行期间,天气、当前位置、疲劳程度和饥饿感都可能优先于 原计划。
共享记忆
规划或构建之前,如果 ~/.trip-map-builder/MEMORY.md 存在,请先阅读。
仅将其用于记录旅行者的长期背景信息:
- 行程节奏偏好
- 餐饮和饮品偏好
- 预算习惯
- 支付和导航偏好
- 之前生成的旅行输出
- 反复出现的限制条件和未解决的后续事项
如果文件不存在,照常继续。不要因设置记忆而阻塞流程。
不要存储原始截图、护照数据、预订代码、完整聊天记录或 其他敏感/私人资料。
每次完成行程规划、调研阶段或地图构建后,只将长期有效的信息
更新到 ~/.trip-map-builder/MEMORY.md:
# Trip Map Builder Memory
## Traveler Defaults
- Departure city:
- Pace:
- Food preferences:
- Budget habits:
- Payment preference:
- Navigation preference:
- Language preference:
## Past Trips
| Trip | Dates | Destination | Output | Notes |
|------|-------|-------------|--------|-------|
## Reusable Preferences
-
## Open Threads
-
阶段 1:规划行程
阅读 references/trip-planning.md,了解完整方法。
核心流程:
- 提取硬性限制——日期、航班时间、航站楼、酒店位置
- 整理用户的愿望清单——市区方便到达/需要预约/远郊/顺路经过
- 优先删减高风险项目——距离太远、节假日拥挤、受天气影响。说明删掉了什么以及原因。
- 按区域安排——每天一个主要区域,第一天轻松安排,最后一天安排在机场附近
- 安排用餐——先考虑每日所在区域的候选地点,其次参考大众点评 + 小红书信号,最后才考虑名气。
- 添加门票和交通——仅添加关键项目(博物馆门票、机场接送)
- 撰写参考文档——先写结论,再写每日计划、受天气影响的地点、用餐区域和删减项目
核心原则:
- 用户列出的项目不一定都能安排进去。替他们做删减。
- 每天一个区域。每天最多安排一个需要预约的地点。
- 行程应顺畅,而不是塞得满满当当。
- 计划提供坐标,便于之后调整;不要假装现实会按时间表发展。
- 所有面向用户的问题都遵循四步格式:重新确认背景 → 简化问题 → 给出建议 → 提供选项。示例和反模式见
references/trip-planning.md§ 用户交互。
阶段 2:通过大众点评 + 小红书调研
阅读 references/dianping-research.md,了解大众点评 OpenCLI 工作流。
阅读 references/xhs-research.md,了解小红书 OpenCLI + CDP 工作流。
餐厅调研中,以大众点评作为判断口味、排队风险、性价比和明显陷阱的主要中文餐饮信息来源。用小红书补充氛围、近期体验、是否值得拍照以及软性提醒。除非名店本来就在路线沿途,否则不要围绕一家名店安排整天行程。
小红书核心流程:
- 使用
--remote-debugging-port=9223启动 Chrome - 通过 OpenCLI 的
CDPBridge连接 - 前往
xiaohongshu.com/search_result?keyword=<encoded>(不要模拟输入搜索框) - 拦截
POST /api/sns/web/v1/search/notes响应 - 按相关性选出排名靠前的 2-3 篇笔记,并打开详情页
- 通过 DOM 提取:
#detail-title、#detail-desc、.author-container .username - 将每家店的调研压缩成一句有助于决策的话,并写回本地
.md
筛选规则:
- 保留:具体店名、地址、菜品、个人体验、重复出现的关键词
- 删除:泛泛的区域盘点、转发内容、纯情绪表达、“氛围很好” x3
- 输出:店名 + 一个代表性链接 + 2-3 句结论
阶段 3:构建地图页面
- 复制
assets/template.html→index.html - 使用阶段 1+2 的结构化数据填充
HOTEL对象和DAYS数组 - 每个地点需要包含:名称、lat/lng、类型、时间、描述;可选:预算、详情、支付方式、小红书链接、预订信息、gmap
- 在
overviewContent()中填写旅行摘要和支付提醒 - 应用设计系统——默认模板使用 Apple 风格,但也可以切换为 awesome-design-md 中的任意风格
地点类型:food | spot | drink | hotel | transport
支付标记取值:1 = 确认支持(绿色),0.5 = 可能支持(橙色),省略 = 不显示
设计系统(可选)
默认模板使用 Apple 设计系统(SF Pro、浅色主题、磨砂玻璃效果)。
如需使用其他样式,请从 awesome-design-md 获取 DESIGN.md:
# Browse available design systems
# Apple, Vercel, Linear, Stripe, Notion, Airbnb, Nike, Spotify, etc.
curl -O https://raw.githubusercontent.com/VoltAgent/awesome-design-md/main/design-md/<brand>/DESIGN.md
然后调整 template.html 中的 :root CSS 变量(颜色、字体、间距、圆角),使其与所选 DESIGN.md 令牌匹配。
部署(可选)
git init && git add . && git commit -m "trip map"
gh repo create REPO --public --source=. --push
# Import from vercel.com/new — auto-deploys on push
依赖项
| 工具 | 用途 | 安装 |
|---|---|---|
| OpenCLI | 大众点评适配器 + 小红书调研 | npm install -g @jackwener/opencli |
| Chrome/Chromium | 浏览器 + 远程调试 | 已有 |
| Leaflet.js | 地图渲染(通过 CDN 引入,无需安装) | template.html 内置 |
| gh CLI | 创建 GitHub 仓库(可选) | brew install gh |
资源
references/trip-planning.md— 行程规划方法、输入/输出模板、筛选原则、常见问题references/dianping-research.md— 大众点评 OpenCLI 搜索/店铺工作流、用餐决策信号、回写格式references/xhs-research.md— OpenCLI 安装、Chrome CDP 配置、小红书搜索工作流、API 详情、筛选标准assets/template.html— 单文件 HTML 地图模板(Leaflet + Apple 设计系统)- awesome-design-md — 60+ 种品牌设计系统(Apple、Vercel、Stripe、Linear 等),可供选择其他样式