统一旅行数据模型
本技能是旅行攻略专家团(团 E)的统一数据底座:所有成员的产出(行程、比价、美食、预算、合规、攻略、文案)都必须落到同一套字段上,保证从规划到传播全链路信息不碎片化、可直接互相引用。附带的校验脚本可以在交付前检查任何旅行表格是否符合统一口径。
触发时机
- 用户要求规划旅行、排行程、做预算或整理攻略时,先读本技能确定字段口径
- 多个旅行产出需要互相引用或合并成表时
- 用户问「统一字段」「攻略表结构」「旅行数据模型」时
- 交付前需要校验旅行表格是否留空、缺列、口径错乱时
核心能力
- 五要素字段定义:定义吃、住、行、游、购五类要素各自必备字段与可选字段
- 四类消费主线:车票、酒店、门票、吃饭四类消费贯穿规划、预订、预算、传播四阶段的结构约定
- 统一表头:提供所有成员产出共用的 11 列统一表头,保证可合并、可追溯
- 口径校验:
validate_travel_table.py可输出空白模板,或校验 CSV 表格的缺列、留空、要素分类与消费类型口径,并区分「需修正」与「待核实」
工作流程
- 确认本次旅行涉及哪几类要素与消费
- 用
template命令取 11 列统一表头(支持 csv、tsv、md 三种格式) - 按统一表头给每条信息落位,缺失字段标「待补」而不是留空
- 每条数据标注数据时点与来源,供下游复核
- 交付前用
check命令校验表格,先修「需修正」项,再确认「待核实」项
关键规则(铁律)
- 任何旅行产出必须落位到统一表头,禁止自造并列结构
- 缺失字段写「待补」并注明原因,不得留空或猜测填充
- 金额一律写区间或分档,标注币种与数据时点
- 预约类信息(门票、热门餐厅)必须带提前预约天数
产物
- 统一表头字段表(可直接复制到行程、预算与攻略文档)
- 口径校验报告(需修正项 + 待核实项 + 数据时点提醒)
能力边界
- 不负责具体查询与比价,只定口径
- 不判断用户偏好,只提供结构
- 不做签证、汇率等时效性结论,只预留字段位
统一表头(全团共用 11 列)
项目 | 要素分类(吃/住/行/游/购) | 消费类型(车票/酒店/门票/吃饭) | 时间段 | 地点或街区 | 金额或区间(含币种) | 预约要求(提前天数/开抢时间) | 退改规则 | 备选方案 | 数据时点 | 来源
任何成员的产出表都必须包含这 11 列(可增列不可减列),行内缺失写「待补」。
五要素字段定义
- 吃(dining):街区、店名、人均、排队预警、忌口适配(厌食/过敏/宗教)、与行程时段的落位
- 住(stay):地段、价位档、交通接驳、入住/退房时间、退改规则
- 行(transport):出发-到达、方式(飞机/高铁/地铁/出租/步行)、耗时、票价区间、班次频率
- 游(attraction):景点、门票与预约(提前天数)、建议时长、开放时间、备选景点
- 购(shopping):街区、品类、预算档、退税提示(跨境)
四类消费全链路
车票、酒店、门票、吃饭四类消费贯穿四个阶段:
- 规划(itinerary-planner):四要素埋进分时段日程,每项标注耗时与备选
- 预订(travel-booking):逐项比价、标注退改规则、给抢约预警
- 预算(travel-budget):四类消费汇总成分档预算表(穷游/舒适/奢华)
- 传播(travel-social-copy):转化为图文与短视频内容素材
附带资源
scripts/validate_travel_table.py— 口径校验器(纯标准库):template输出统一表头,check校验 CSV,支持--jsontest-samples/make_samples.py— 生成回归测试样本test-samples/run_tests.py— 回归测试(37 条断言,期望值手算)
> 校验脚本零依赖、不联网,可独立运行;测试期望值均手算推导,不以脚本输出自证。