---
name: ljg-travel
description: Deep cultural travel research workflow for Chinese users preparing museum, archaeology, ancient architecture, heritage, and humanities trips. Use when the user says ljg-travel, 旅行研究, 博物馆功课, 古建功课, 出发前功课, 城市文化旅行研究, or provides a city/place name and wants a mobile/PC-friendly standalone HTML research document. Preserves a 12-parallel-agent research architecture, with China-accessible source rules and built-in fallback procedures for Research and ContentAnalysis.
---

# ljg-travel: 旅行研究

版本: 1.1.0

目标: 输入一个城市或目的地名称，按考古学 Desk-Based Assessment 的思路，先做案头研究，再生成一份可在手机和 PC 直接打开的单一 HTML 文档。它不是普通旅游攻略，而是博物馆、古建、考古和人文旅行的出发前功课。

## 触发与输入

当用户只说 `ljg-travel`、`旅行研究`、`博物馆功课`、`古建功课`、`出发前功课` 但没有给城市/目的地时，先回复:

```text
请输入要做旅行研究的城市或目的地名称；如有主题偏好，也可以加 -f，例如：洛阳 -f 唐代。
```

参数:

- `城市名/目的地名`: 必填，如 `西安`、`洛阳`、`大同`、`泉州`。
- `-f <主题>`: 可选聚焦主题，如 `-f 唐代`、`-f 石窟`、`-f 青铜器`。
- `-q`: 快速模式，保留 12 个研究 agent，但跳过 URL 内容提炼。

## 必读文件

执行前读取:

- `references/research-agents.md`: 12 个并行 Agent 的任务单、Research 补全流程、ContentAnalysis 补全流程、中国可用来源规则。
- `references/html-report.md`: HTML 文档结构、设计规则、内容要求、质量检查。

完成 HTML 后，在 PowerShell 可用时运行:

```powershell
scripts/validate-html.ps1 -Path "<生成的HTML文件路径>"
```

检查失败时先修正 HTML，再交付。

## 执行流程

### 1. 解析任务

提取城市/目的地、聚焦主题、是否快速模式。若名称可能有歧义，只问一个问题确认省份、国家或具体景区。

### 2. Research: 12 个并行 Agent

必须采用 12 个并行 Agent 的写法。按 `references/research-agents.md` 中的 12 份任务单分别派发，不要把 12 个任务合并成一个大而泛的搜索。

如果当前环境有 subagent/parallel agent 工具:

- 同时启动 12 个 agent。
- 每个 agent 只执行自己的任务单。
- 每个 agent 必须按统一输出格式返回: `核心发现`、`可看实物`、`为什么看`、`看什么细节`、`来源`、`不确定项`。

如果当前环境没有 subagent/parallel agent 工具:

- 仍按 12 个任务单逐项独立执行。
- 每项研究结果先分别保存为独立笔记，不要边查边综合。
- 12 项完成后再统一合并。这是降级执行，不改变 12-agent 架构。

### 3. ContentAnalysis: 深度内容提炼

除非用户使用 `-q`，否则从 12 个 agent 的结果中选出最多 24 个高价值 URL 做内容提炼。

优先提炼:

- B站 10 分钟以上、有知识增量的讲解视频。
- 微信公众号、知乎中有作者身份、参考资料或明确知识框架的长文。
- 官方网站中关于展品、古建、遗址、保护单位的专题页。

如果有 subagent 工具，可以并行提炼 URL；如果没有，就逐条提炼。任何 URL 无法访问、无字幕、内容过浅或疑似广告，直接跳过，不阻塞最终报告。

### 4. 综合成 HTML

根据 12 个研究结果和内容提炼结果，生成:

```text
{城市或目的地}旅行研究.html
```

HTML 必须:

- 单一文件，自包含 CSS，无需构建步骤。
- 不依赖 CDN、外部 JS、外部字体或在线框架。
- 适合手机和 PC 阅读。
- 使用系统中文字体。
- 保留来源链接，但页面功能不依赖这些链接。
- 每个推荐都写清楚“为什么看”和“看什么细节”。
- 没有确切资料时写“公开资料不足”或“需现场核实”，不得编造。

### 5. 检查与交付

交付前检查:

- HTML 文件存在，文件名正确。
- 必备章节齐全。
- 12 个研究维度的核心结果都被吸收。
- 重要判断有来源。
- 中国用户可顺畅打开: 不用 Google、YouTube、Twitter/X、Facebook、Instagram、境外 CDN 或外部脚本作为页面依赖。
- 手机视图无横向溢出。
- `scripts/validate-html.ps1` 通过，或说明未能运行的原因。

最后告诉用户 HTML 文件路径，并用简短摘要说明覆盖了多少博物馆、古建/遗址、考古发现和深度内容。

## 中国可用性原则

研究优先使用在中国访问顺畅的来源:

- 政府、文旅局、文物局、博物馆、景区、遗址公园和高校/研究机构官方网站。
- 国家文物局、中国考古、地方文物部门、地方志、博物馆展陈资料。
- B站、知乎、微信公众号、抖音、小红书等国内平台中的深度内容。
- 百度、必应、搜狗、微信搜一搜等可用搜索入口。

不要依赖 Google、YouTube、Twitter/X、Facebook、Instagram、Pinterest、境外 CDN 或访问不稳定的页面。英文关键词可以用于补充检索，但只采用中国环境下可访问、可核验的结果。

## 交付语气

写给一个真正要出发的人。语气像给自己做的深度旅行笔记，不像宣传文案，也不像导游词。