MCP HubMCP Hub
← Retour aux compétences

generate-tour-report

pjt222
Mis à jour 6 days ago
18 vues
17
2
17
Voir sur GitHub
Métapdfwordaidesign

À propos

Cette compétence génère des rapports de voyage complets en utilisant Quarto, créant des documents HTML ou PDF autonomes. Elle compile des itinéraires quotidiens, des cartes intégrées, des tableaux logistiques et des détails d'hébergement en un seul fichier accessible hors ligne. Utilisez-la pour produire des plans de voyage partageables, des guides de voyage hors ligne ou une documentation de voyage professionnelle pour les clients.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/generate-tour-report

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

生遊報

生格式化遊報，含嵌入地圖、日程、後勤表、實用旅訊。

用

  • 將所計劃之遊整為可分享文檔
  • 造可離線旅遊指南
  • 記已畢之旅（照、圖、統計）
  • 造供團或客之專業遊案
  • 合路、宿、運數據於一文

入

  • 必：路數據（航點、段、距、時）
  • 必：遊日期與時長
  • 可：宿詳（名、址、確認號）
  • 可：運訂（航班、列車、租車）
  • 可：GPX 軌或空間數據供嵌圖
  • 可：預算訊（各類費）
  • 可：照或像

行

一：合路與 POI 數據

建報前收全遊數據為結構化格式。

Data Sources to Compile:
┌────────────────────┬──────────────────────────────────────────┐
│ Category           │ Required Fields                          │
├────────────────────┼──────────────────────────────────────────┤
│ Route legs         │ From, To, distance_km, time_hrs, mode   │
│ Waypoints          │ Name, lat, lon, arrival, departure, notes│
│ Accommodation      │ Name, address, check-in/out, cost, conf#│
│ Transport          │ Type, operator, depart, arrive, ref#     │
│ Activities         │ Name, time, duration, cost, booking_req  │
│ Emergency contacts │ Local emergency #, embassy, insurance    │
│ POIs               │ Name, category, lat, lon, description    │
└────────────────────┴──────────────────────────────────────────┘

按日組數據供日節構：

  1. 航點與活動按日組
  2. 各運段分配一日
  3. 宿配夜日
  4. 算日總（距、時、費）

得：全數據按日組，程無缺（每夜有宿，每段有運）。

敗：數據缺→標 [TBD] 並置報末後續清單。日期不齊（如抵宿於前站出發前）→標衝突並調時。

二：構日節

造 Quarto 文骨，含日節。

---
title: "Tour Name: Region/Country"
subtitle: "Date Range"
author: "Planner Name"
date: today
format:
  html:
    toc: true
    toc-depth: 3
    theme: cosmo
    self-contained: true
    code-fold: true
  pdf:
    documentclass: article
    geometry: margin=2cm
    toc: true
execute:
  echo: false
  warning: false
  message: false
---

文構如下：

Report Structure:
1. Overview
   - Tour summary (dates, total distance, highlights)
   - Overview map (all waypoints, full route)
   - Quick reference table (key dates, bookings, contacts)

2. Day 1: [Title]
   - Day summary (start, end, km, hours)
   - Route map for the day
   - Timeline / schedule table
   - Accommodation details
   - POIs and activities

3. Day 2: [Title]
   ... (repeat for each day)

N. Logistics Appendix
   - Full accommodation table
   - Transport bookings table
   - Packing checklist
   - Emergency contacts
   - Budget summary

得：全 .qmd 骨具 YAML 頭，諸日節為 H2 頭，各節有佔位內容。

敗：遊過長（逾 14 日）→分週部或用標籤布局（{.tabset}）。需 PDF 出→不含交互部件（用靜態圖）。

三：嵌圖與圖表

各節加空間視覺。

總覽圖：

#| label: fig-overview-map
#| fig-cap: "Tour overview with all stops"

leaflet::leaflet() |>
  leaflet::addProviderTiles("OpenTopoMap") |>
  leaflet::addPolylines(data = full_route, color = "#2563eb", weight = 3) |>
  leaflet::addMarkers(data = stops, popup = ~paste(name, "<br>", date))

日路圖：

#| label: fig-day1-map
#| fig-cap: "Day 1 route: City A to City B"

day1_route <- full_route[full_route$day == 1, ]
leaflet::leaflet() |>
  leaflet::addProviderTiles("OpenStreetMap") |>
  leaflet::addPolylines(data = day1_route, color = "#2563eb", weight = 4) |>
  leaflet::addCircleMarkers(data = day1_stops, radius = 6, popup = ~name)

高程剖（徒步/騎日）：

#| label: fig-day3-elevation
#| fig-cap: "Day 3 elevation profile"

ggplot2::ggplot(day3_elevation, ggplot2::aes(x = dist_km, y = elev_m)) +
  ggplot2::geom_area(fill = "#bfdbfe", alpha = 0.5) +
  ggplot2::geom_line(color = "#1d4ed8", linewidth = 0.7) +
  ggplot2::theme_minimal() +
  ggplot2::labs(x = "Distance (km)", y = "Elevation (m)")

得：各日節至少有路圖。多模日（駕+徒）有道圖與高程剖。總覽節有全遊圖。

敗：leaflet 敗（PDF 常）→回退靜態圖（tmap::tmap_mode("plot") 或 ggplot2 配 ggspatial::annotation_map_tile()）。空間數據無→簡文字描路。

四：加後勤表

插宿、運、預算之結構化表。

宿表：

| Night | Date       | Accommodation      | Address            | Check-in | Cost   | Conf# |
|-------|------------|--------------------|--------------------|----------|--------|-------|
| 1     | 2025-07-01 | Hotel Alpine       | Bergstrasse 12     | 15:00    | EUR 95 | AB123 |
| 2     | 2025-07-02 | Mountain Hut       | Zugspitze Huette   | 16:00    | EUR 45 | --    |
| 3     | 2025-07-03 | Pension Edelweiss  | Dorfplatz 3        | 14:00    | EUR 72 | CD456 |

運表：

| Date       | Type  | From          | To            | Depart | Arrive | Ref#   |
|------------|-------|---------------|---------------|--------|--------|--------|
| 2025-07-01 | Train | Munich Hbf    | Garmisch      | 08:15  | 09:32  | DB1234 |
| 2025-07-03 | Bus   | Zugspitze     | Ehrwald        | 10:00  | 10:25  | --     |
| 2025-07-04 | Train | Innsbruck     | Munich Hbf    | 16:45  | 18:30  | OBB567 |

預算摘：

| Category        | Estimated | Actual | Notes                   |
|-----------------|-----------|--------|-------------------------|
| Accommodation   | EUR 212   |        | 3 nights                |
| Transport       | EUR 85    |        | Rail passes recommended |
| Food            | EUR 150   |        | EUR 50/day estimate     |
| Activities      | EUR 60    |        | Cable car, museum       |
| **Total**       | **EUR 507** |      |                         |

得：全後勤表按時序列。宿表無缺日。預算總計正確。

敗：訂詳未確→用 [TBD] 並標列。多幣→加幣列並於腳注列匯率。

五：渲染報

將 Quarto 文編為最終出格式。

# Render to self-contained HTML (best for offline use)
quarto render tour-report.qmd --to html

# Render to PDF (for printing)
quarto render tour-report.qmd --to pdf

# Preview with live reload during editing
quarto preview tour-report.qmd

渲後察：

  1. 開 HTML 驗諸圖正確載
  2. 試目錄鏈接
  3. 驗諸像與圖於合適尺寸繪
  4. 察自含 HTML 離線可（斷網重載）
  5. PDF：驗頁斷於邏輯點（日間）

得：全自含文檔離線可用，含全遊訊於可導格式。

敗：渲染敗→察 R 控台之包誤（sf、leaflet 或 ggplot2 缺）。自含 HTML 過大（>20 MB）→減瓦片分辨或用 PNG 代交互圖。PDF 渲染 LaTeX 誤→quarto install tinytex。

驗

  • 報於目標格式無誤渲
  • 總覽圖示全路與諸站
  • 各日有路圖與程
  • 宿表涵每夜
  • 運表含諸段
  • 預算總正確
  • 自含 HTML 離線可用
  • 目錄正確導至諸節
  • 無 [TBD] 佔位（除有意標）

忌

  • PDF 中交互圖：Leaflet 等 HTML 部件於 PDF 不可繪。恆備靜態圖於 PDF 出
  • 自含 HTML 過大：嵌眾瓦致極大檔。限縮放層或用靜截圖
  • 缺時區：跨國遊跨時區。恆明發抵時區
  • 訂引用陳：確認號與時或變。含「末更」日並提醒旅前驗
  • 無離線回退：倚網載瓦片→離線空白。用 self-contained: true 或預渲圖為像
  • 日期格不一：DD/MM 與 MM/DD 混致惑。用 ISO 8601（YYYY-MM-DD）

參

  • plan-tour-route
  • create-spatial-visualization
  • create-quarto-report
  • plan-hiking-tour
  • check-hiking-gear

Dépôt GitHub

pjt222/agent-almanac
Chemin: i18n/wenyan-ultra/skills/generate-tour-report
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Compétences associées

content-collections

Méta

Cette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.

Voir la compétence

polymarket

Méta

Cette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.

Voir la compétence

creating-opencode-plugins

Méta

Cette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.

Voir la compétence

sglang

Méta

SGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.

Voir la compétence