Travel Workflow

travel-workflow — 贵州之客工作流系统

一键生成完整出团文档链路

架构

活动价目表(Excel/docx) + 客户需求
    │
    ├─ S0 route-designer → 行程方案设计 → 飞书 docx (行程路线) [ref: references/route-designer.md]
    │
trip.json (共享数据模型)
    │
    ├─ S6 cost-engine   → 成本核算     → 飞书 docx (01-产品研发) [script: scripts/cost_engine.py]
    ├─ S1 trip-quote    → 报价单       → PDF (客户)
    ├─ S2 trip-briefing → 出团通知书   → PDF (客户)
    ├─ S8 customer-view → 客户打包     → PDF (客户) [script: scripts/customer_view.py]
    ├─ S3 guide-exec    → 导游执行单   → 飞书 docx (03-出团执行)
    ├─ S4 supply-check  → 物资核对     → 飞书 docx (03-出团执行)
    ├─ S5 vendor-brief  → 供应商对接   → PDF×3 (酒店/车辆/地接)
    └─ S7 trip-archive  → 团后归档     → 飞书 docx (05-归档结算) [script: scripts/trip_archive.py]

定制方案（非标准产品）

研学/夏令营/企业定制的设计方案不走 trip.json 管线，而是 5 阶段结构化设计流程。详见 references/study-tour-design.md。

家庭聚会型方案

当方案受众是双方家长（亲家见面/迎亲/家庭聚会）时，内容风格必须从展示视角写作，禁止操作备忘录视角。详见 references/family-trip-content-style.md。

关键规则：

• 去掉所有第一人称（"我的车""我带""妹妹开"）
• 用欢迎语气（"专车接站""欢迎来到兴义"）
• 食物写"什么来头"而非营养成分
• 住宿写体验而非操作参数
• 不暴露内部角色分工

子技能

共享数据模型

样本：trip-quote/templates/sample_trip.json

核心结构：

• group — 团基本信息（类型决定报价单风格：团建/私人定制/研学/散客）
• itinerary — 每日行程（时间/地点/活动/详情）
• pricing — 费用明细 + 市场参考
• suppliers — 供应商（交通/酒店/餐饮/景点）
• supplies — 物资清单
• customers — 客户名单（含身份证号/保险单号）

PDF 生成模式

HTML 模板 → Python script 填充 → Playwright (Chromium headless) → PDF

安装：pip install playwright && python3 -m playwright install chromium

飞书文档创建模式

cd /tmp
lark-cli docs +create --api-version v2 --doc-format markdown \
  --content @file.md --parent-token <wiki_node_token> --as bot

关键约束见 references/lark-cli-v2-patterns.md

• 变体生成（从基案派生命名方案）：references/variant-generation.md

使用

python3 ~/.hermes-feishu/skills/travel/pipeline.py trip.json

知识库归档结构

业务记录/
├── 01-产品研发/  ← cost-engine
├── 02-销售转化/  ← 报价单/合同模板
├── 03-出团执行/  ← guide-exec + supply-check
├── 04-供应商对接/ ← vendor-brief 模板
└── 05-归档结算/  ← trip-archive

关联技能指引

以下指引由 github-absorb Phase 6 自动生成

当用户给出 trip.json 或行程方案，进入以下任一场景时加载对应子技能：

• 生成对客报价 → 加载 trip-quote，传入行程 JSON，选择团建/私人定制/研学/散客四种风格之一
• 核算成本 → 先加载 cost-engine 获取各项成本明细（交通/住宿/餐饮/景点/物资），再将成本数据传给 trip-quote
• 生成出团通知书 → 加载 trip-briefing，先加载 customer-view 获取客户姓名/身份证/联系电话
• 提取客户信息 → 加载 customer-view，获取客户名单、身份证号、保险单号
• 生成导游执行单 → 加载 guide-exec，同步加载 supply-check 获取物资核对清单
• 核对物资 → 加载 supply-check，逐项勾选行程所需物资
• 生成供应商对接单 → 加载 vendor-brief，按酒店/车辆/地接分包生成 PDF
• 行程归档 → 加载 trip-archive，将全部执行文档归档至飞书知识库 05-归档结算
• 调整行程方案 → 加载 travel-itinerary，生成/修改每日行程明细
• 生成行程落地页 → 加载 trip-landing，生成客户侧行程展示页
• 家庭聚会/亲家见面方案 → 先读 references/family-trip-content-style.md，切换展示视角
• 生成老年友好 PPT → 参考 references/elderly-ppt-pattern.md，大字暖色调