Travel Planner Skill

travel-planner

一个 **Claude Agent Skill**：会记住用户偏好、生成完整行程，并能把攻略做成移动端优先的精致 HTML 单页。面向任意 agent / LLM（含非 SOTA 模型），自包含、可移植。

通用 LLM 给的是"标准攻略"。这个 skill 给的是**记得你偏好、且能做成杂志级单页**的攻略。

封面 · 路线速览	约束时间轴 · 逐日行程	比价 · 每条链接生成时验过

*真实产出（印尼潜水 + 火山 14 天，示例已随仓库附带：`references/examples/indonesia-v2.html`）。每个目的地一套皮肤——换目的地时骨架复用、视觉重做，不套模板。*

它解决什么

问 AI 规划旅行的三个通病：

• 不记得你 — 每次重问忌口/预算/作息
• 千篇一律 — 给所有人同一份通用行程
• 产物难看 — 一坨 markdown，发同行看体验差

核心能力

1. 跨会话偏好记忆 — 饮食/住宿/作息/节奏/兴趣存本地库，渐进式收集（一轮 ≤3 问），第二次只问这次缺的
2. 约束驱动 + 可修改 — 硬约束（已订航班/酒店、不可动日期）零违规；已确认项可 lock 锁定，改行程只重排未锁部分；缺关键输入（天数/预算/币种）时报错追问而非默默编数
3. 完整产出 — 逐日行程 + 预算(带 10-20% 应急预留) + 装备清单 + 文化禁忌 + 出发前倒排 timeline（热门项标 "Book NOW"）
   • 反幻觉三条硬规则：车程/船程时间必须搜索核实、禁凭空估算（规则 7）；写进攻略的链接必须当场核实，核实不了只给搜索入口、绝不编 URL（规则 7b）；预算由代码硬加总，分类合计 + 应急预留 == 总预算，越界直接报错（规则 4，见 scripts/plan_generator.py）
4. 可选的精致 HTML 单页 — 一屏一天信息架构、把领域硬约束画成"约束时间轴"（潜水禁飞/高原海拔/时差/签证时限）、每地点专属色系统、按目的地主题推导配色、等比例真地图、一键发布到文档平台

快速开始

# 1. 无需安装依赖（核心为 Python3 标准库；可选照片管线需 Pillow）
# 2. 让 agent 加载本 skill，然后直接说需求：
#    "下个月去冰岛 8 天，预算两万，帮我规划"
#    "把这份攻略做成好看的单页发我"

# 数据库自检（首次）：
python3 scripts/travel_db.py is_initialized

目录结构

SKILL.md                     # agent 入口：触发条件 / 8 步工作流 / 规则 / gotchas
references/
  ├── html-delivery.md       # ★ HTML 单页骨架方法论（一屏一天/约束时间轴/配色推导/地图/发布）
  ├── examples/              # 黄金范例（印尼潜水攻略单页 + 代表块，已脱敏）——只读学骨架，勿照抄皮肤
  ├── preference-fields.md   # 偏好字段
  ├── trip-info-fields.md    # 行程字段
  ├── destination-research.md# 目的地调研 10 主题
  ├── plan-generation.md     # 产出格式
  ├── cultural_etiquette.md  # 文化禁忌模板
  └── travel_guidelines.md   # 综合指南
scripts/
  ├── travel_db.py           # 偏好/行程/锁定持久化
  ├── plan_generator.py      # 预算/装备/timeline 计算（缺输入报错，不生成行程）
  ├── deliver.py             # ★ 统一交付入口（探测凭据→发文档/退回HTML，不崩）
  ├── make_map.py            # 等比例地图 SVG 引擎（纯标准库）