ljg-travel
Original:🇨🇳 Chinese
Translated
Deep travel research workflow for museums and ancient architecture. Input a city name to automatically generate a structured knowledge document (org-mode) and portable reference cards (PNG). It covers historical background, museum highlights, archaeological significance, and architectural heritage. This workflow is activated when users say '旅行研究', '博物馆功课', '古建功课', 'travel research', '出发前功课', or provide a city name with the intention of conducting in-depth cultural travel preparation.
14installs
Sourcelijigang/ljg-skills
Added on
NPX Install
npx skill4agent add lijigang/ljg-skills ljg-travelTags
Translated version includes tags in frontmatterSKILL.md Content (Chinese)
View Translation Comparison →ljg-travel-flow: Travel Research
Complete with one command: Full-dimensional cultural research → Content refinement → org document + portable reference cards.
Methodology draws on archaeological Desk-Based Assessment (DBA): Exhaust all documentary evidence before arrival.
Mode
Mandatory NATIVE Mode. This workflow is a multi-skill pipeline (Research → ContentAnalysis → ljg-card) and does not follow the Algorithm seven-step process.
Parameters
| Parameter | Description | Example |
|---|---|---|
| City Name | Required, target city | Xi'an, Luoyang, Datong |
| Focus theme (optional) | |
| Quick mode, skip content refinement, only conduct research + document generation |
Execution
1. Parse Parameters
Extract the city name and optional parameters from the user's message. If there is a focus theme, all subsequent searches will revolve around this theme.
2. Full-Dimensional Research (Research extensive — single call, 12 Agents in parallel)
Call the Skill tool to execute using the extensive mode.
ResearchCore Design: No separation between "knowledge base mapping" and "platform discovery" — they are different search angles of the same research operation. 12 Agents start simultaneously, half conducting academic/encyclopedic research and half searching platform content.
Research Outline (prompt passed to Research):
Conduct in-depth cultural travel research on「{City}」. This is not a travel guide, but an archaeological-style desk-based assessment (Desk-Based Assessment) before departure.
The research covers the following dimensions, and each dimension requires bilingual (Chinese and English) searches:
**Dimension A — Historical Layers**
What important historical periods has this city experienced? What material remains did each period leave in this city? How did dynastic changes affect the city's layout?
**Dimension B — Museum Highlights**
What important museums are there in this city? What are the treasure pieces and core collections of each museum? Which exhibits have significant archaeological value? Must provide specific cultural relic names and exhibition hall locations.
**Dimension C — Ancient Architectural Remains**
What important ancient buildings and sites are preserved? Construction era, architectural form, structural features. Which are key national cultural relic protection units? What details should be paid attention to when viewing the buildings (brackets, colored paintings, inscriptions, etc.)?
**Dimension D — Archaeological Discoveries**
What major archaeological discoveries are there in and around the city? Where are the unearthed cultural relics now collected? What important stories are there during the excavation process?
**Dimension E — Cultural Context**
Important historical figures, literary works, and cultural traditions related to the city. Help understand the cultural character of this city.
**Dimension F — In-Depth Content Discovery**
Search for in-depth explanations about the city's museums and ancient buildings on Bilibili (bilibili.com), Zhihu (zhihu.com), WeChat Official Accounts (mp.weixin.qq.com), Douyin (douyin.com), and Xiaohongshu (xiaohongshu.com).
Selection criteria:
- Preferred: Content with knowledge increment (explaining background, craftsmanship, excavation process, architectural details)
- Not allowed: Pure check-in photos, pure recommendations without analysis, advertising soft articles
- Prioritize Bilibili videos of 10 minutes or longer that are explanatory
- Prioritize official account articles with references or clear author identities
Return content title, URL, and one-sentence summary.
{If there is a focus theme: Pay special attention to content related to「{Focus Theme}」, with other dimensions as background supplements.}Wait for Research to complete and obtain full-dimensional research results.
3. Content Refinement (ContentAnalysis — Optional)
If the user specifies the quick mode, skip this step.
-qExtract all valid URLs (article links, video links) from the results returned in Step 2.
Launch Agent subagents in parallel for each URL:
Each subagent calls the Skill tool to execute , passing in the URL, using fast depth level, to extract core knowledge points.
ContentAnalysisDegradation Rules:
- If ContentAnalysis fails for a certain URL (unable to access, no subtitles, etc.), skip the URL without blocking the process
- If all URLs fail, the process does not interrupt — the research results from Step 2 are sufficient to generate the document
- ContentAnalysis is an enhancement layer, not a necessary layer
Collect all successfully refined content summaries.
4. Synthesize org-mode Document
Combine the results from Step 2 (research results) and Step 3 (content refinement, if any) into a structured org-mode document.
Document Structure:
org
#+title: {City} Travel Research
#+date: {Current Date}
#+filetags: :travel:museum:architecture:
* City Overview
The civilization coordinates of {City} — why it is worth visiting and what to see there. A paragraph outlining the city's position in Chinese civilization history.
* Historical Layers
** {Period 1} ({Time Range})
Core events, remaining traces, corresponding visible artifacts.
** {Period 2}
...
* Museum Guide
** {Museum 1 Name}
Address, opening hours, reservation method (if required).
*** Treasure Pieces
- {Cultural Relic Name}: {Why it is important} | Key details to observe: {Specific Observation Points}
*** Key Exhibition Halls
- {Exhibition Hall Name}: {Core Highlights}
*** Easily Missed Spots
- {Neglected but Worthwhile Content}
** {Museum 2 Name}
...
* Ancient Architectural Remains
** {Ancient Building 1 Name} ({Dynasty}, {Protection Level})
Overview of its form.
*** Key Observation Points
- {Observation Point 1}: {Why it is noteworthy}
- {Observation Point 2}
** {Ancient Building 2 Name}
...
* Archaeological Discoveries
** {Site/Discovery 1}
Excavation process, significance, current collection location of unearthed relics. If there are interesting excavation stories, include them.
* Visiting Routes
** Route 1: {Theme Name} ({Estimated Time})
Suitable for: {Description}
1. {Location} → Focus on {What to See} ({Suggested Stay Time})
2. ...
** Route 2: {Theme Name}
...
* In-Depth Content Recommendations
Worthwhile content to review before departure, discovered from various platforms.
** Videos
- [[{URL}][{Title}]] — {One-Sentence Summary}
** Articles
- [[{URL}][{Title}]] — {One-Sentence Summary}
** Books (if recommended)
- {Book Title} — {Why it is worth reading}File Naming: Use the denote naming schema and save to the directory:
~/Documents/notes/{YYYYMMDDTHHMMSS}==z--{City}TravelResearch.orgWriting Requirements:
- Each recommendation must include "why to visit" and "what details to observe"; no vague descriptions allowed
- The tone should be like notes written for oneself, not a tour guide's script
- Include exact information where available; leave blank rather than fabricate if information is uncertain
5. Generate Portable Cards (ljg-card)
Extract core content from the org-mode document in Step 4 and generate two cards, executed in parallel:
Card A — City Civilization Overview (Infographic):
Call the Skill tool to execute , with input content being the condensed summary of the city's historical layers + core museum list + must-see ancient building list. Understand the city's civilization framework at a glance with one image.
ljg-card -iCard B — Visiting Route Quick Reference (Long Image):
Call the Skill tool to execute , with input content being the visiting route suggestions + core highlights of each location. Accessible anytime on mobile phones.
ljg-card -l6. Summary Report
════ Travel Research Completed ═══════════════════════
🏛️ City: {City Name}
📝 Knowledge Document: {org File Path}
🖼️ Civilization Overview Card: {PNG File Path}
🖼️ Route Quick Reference Card: {PNG File Path}
📊 Research Coverage: {N} Museums | {M} Ancient Buildings | {K} Archaeological Sites
📎 In-Depth Content: {X} Videos | {Y} ArticlesKey Constraints
- Step 2 is the core — 12 Agents in parallel cover academic research and platform content, completed in one go
- Step 3 (content refinement) is an enhancement layer; failure does not block the process
- The two cards in Step 5 are executed in parallel
- The org document is the main output, and the cards are derivative outputs — document quality takes priority
- No generic travel guides are produced; each recommendation must include "why to visit" and "what details to observe"
- Research searches use bilingual (Chinese and English) keywords to expand coverage
- Leave blank rather than fabricate when exact information is unavailable
Known Pitfalls
(First creation, no records yet. Accumulate during use.)