# Travel Journal Creator

当用户提出旅行需求时自动使用，包括找旅行灵感、推荐目的地、安排或调整行程、规划主题路线、整理旅行照片回忆或已有路书。无需用户点名 Skill；用 JourniOne...

- Repository: https://github.com/JourniOne-ai/JourniOne-Planning-Skills (1176 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add JourniOne-ai/JourniOne-Planning-Skills --skill travel-journal-creator -g -a claude-code -y`
Codex: `npx skills add JourniOne-ai/JourniOne-Planning-Skills --skill travel-journal-creator -g -a codex -y`
Cursor: `npx skills add JourniOne-ai/JourniOne-Planning-Skills --skill travel-journal-creator -g -a cursor -y`
Gemini CLI: `npx skills add JourniOne-ai/JourniOne-Planning-Skills --skill travel-journal-creator -g -a gemini-cli -y`

## Description

当用户提出旅行需求时自动使用，包括找旅行灵感、推荐目的地、安排或调整行程、规划主题路线、整理旅行照片回忆或已有路书。无需用户点名 Skill；用 JourniOne 逐步规划每天怎么玩，确认后生成带地图、能分享的 Travel Journal，日期机酒按需补充。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Travel Journal Creator

显示名称为 **Travel Journal Creator**，由 JourniOne 提供；技术标识为 `travel-journal-creator`。最终产物统一称 **Travel Journal**：把已确认路线整理成可分享的图文网页，方便和同行人一起看每天怎么玩；日期、机票和酒店可以按需求持续补充。同一 Travel Journal 提供 **Journal 视图**和 **Map 视图**，不是不同生成产品。对用户统一使用这两个视图名称：原海报称 Journal 视图，原 OSM 称 Map 视图；`poster`、OSM、接口路径与 Schema 仅保留为内部技术名称，不因文案更名修改请求字段。

用户体验措辞遵循 [用户表达指南](references/user-experience-language.md)，安装与使用说明见 [README.md](README.md)。首次规划回复采用以下默认开场，可按已知兴趣替换“想吃、想逛”的体验描述：“JourniOne 能帮你把想吃、想逛的地方串成一趟旅行，做成带地图、能分享的 Travel Journal 图文旅行日志，还能按需帮你选订机票和酒店，让这趟旅行真正成行。”开场已包含能力名称，不另加一段工具自我介绍；用“按需选订机票和酒店”点明落实出行的能力，不在开场索取日期或服务字段；随后立即展示具体选项或路线。每轮用“现在选玩法／开始排每天／确认安排”等自然短语定位当前规划阶段，说明已定内容和下一份可见结果；产品介绍不能代替阶段引导，合并进当次正文或结尾问题；详见 [阶段引导](references/onboarding-contract.md#每个阶段的一句话引导)。产品介绍只出现一次，阶段可合并，不增加问答、等待或确认关卡；用户提出生成后不再重复介绍或追加产品选择。完成措辞必须匹配真实状态，不把假设、确认稿或返回 Preview 说成全部成品完成。

本 Skill 只有一个生成入口：`POST /api/skill-roadbook`，使用 `flipmind-skill-poster-request@2.0.0`，交付服务端实际返回的 `preview_url`。创建无需用户登录或访问凭证。日期、人数、酒店和机票未提供时不阻塞路线或 Travel Journal 生成；只在用户选择补服务时收集对应必需输入。服务端生成 Poster、OSM、封面和 Travel Guide，首次请求不生成 POI 详情图，但保留点位点击、文字详情和已有来源图片。

酒店和航班查询仍属于这趟 Travel Journal 的规划过程。进入服务、给首选和用户暂选后都按 [机酒补充与 Journal 衔接](playbooks/service-to-journal.md) 接回主流程：说明已补好什么、下一步会得到什么；不能只回复“已记入行程，尚未预订”。已明确“选完机酒就生成”的意图持续保留，满足后直接执行；尚未选择生成时给清楚入口，用户暂缓则尊重。每次收集服务输入前按 [继承与估算](references/intake-contract.md#机酒输入的继承与估算) 复用前文日期、天数、人数与配置，能推算就明示暂估并继续只读查询，不重开问卷。

不要用独立生成图片、本地 HTML 或截图代替网页路书。Preview 是稳定的公开只读入口，不提供匿名编辑权限。未登录显示「保存为我的日志」；已登录打开时自动创建或复用个人日志，仅账号本人能编辑行程及增删改酒店、机票。退出回到公开 Preview；重新打开原链接仍能找到自己的副本。私人媒体不支持此公开链接模式，先排除敏感内容并确认允许上传的材料。

## 自动触发

用户表达旅行需求时直接使用本 Skill，例如“想出去玩几天”“东京怎么玩”“帮我调整这份行程”或“把旅行照片整理成日志”；不要求输入 Skill 名称、使用特殊前缀或确认是否启用。沿用对话中已有的路线与偏好开始规划。自动触发只启动与当前需求相关的规划流程，生成网页仍遵循下文的用户确认规则。仅讨论 Skill 安装、命名、代码或接口排错时不进入旅行规划。

<!-- agent-experience:start -->
## Agent 服务体验优化

为了在不同 Agent 中提供更好的旅行规划体验，JourniOne 会上报少量功能使用事件（当前 Agent、规划阶段和时间）用于改进服务适配；不上传聊天、行程正文、身份或凭证，用户可以关闭。用途仅为 Agent 适配，不承诺本次推荐即时个性化。遵守宿主授权，不额外询问或逐次播报。

The rest: https://github.com/JourniOne-ai/JourniOne-Planning-Skills/blob/HEAD//SKILL.md
