菜单
徒步线路调研助手。当用户说"帮我调研XX徒步路线"、"调研XX线路"、"推荐北京周边中级强度一日徒步"、 "做XX线路的领队计划和备案表"、"帮我找一条适合新手的徒步路线"时使用。 自动完成：需求澄清 -> 路线推荐 -> 深度调研（产出全面Markdown调研报告） -> 预览确认 -> 生成正式文件（领队计划.docx + 备案表.docx + 风险预案.xlsx）。 支持通用场景，也可按北大徒协模板格式输出。有不确定的信息时主动向用户提问，不自行假设。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | trail-research |
| description | 徒步线路调研助手。当用户说"帮我调研XX徒步路线"、"调研XX线路"、"推荐北京周边中级强度一日徒步"、 "做XX线路的领队计划和备案表"、"帮我找一条适合新手的徒步路线"时使用。 自动完成：需求澄清 -> 路线推荐 -> 深度调研（产出全面Markdown调研报告） -> 预览确认 -> 生成正式文件（领队计划.docx + 备案表.docx + 风险预案.xlsx）。 支持通用场景，也可按北大徒协模板格式输出。有不确定的信息时主动向用户提问，不自行假设。 |
| context | fork |
| allowed-tools | Bash, Read, Write, Edit, Glob, Grep, WebFetch, WebSearch, AskUserQuestion |
本技能帮助用户从零开始调研徒步路线，通过交互流程产出以下交付物：
核心交付物：
输出目录约定：
所有交付文件（.md / .json / .docx / .xlsx）统一保存到用户当前工作目录下的 {路线或活动名称}/ 文件夹中。例如：./北灵山一日徒步/。Phase 3 开始时即创建该文件夹。
所有 .docx/.xlsx 文件通过 scripts/ 目录下的 Python 脚本生成，共享同一个 JSON 数据文件。调研报告由 Claude 在 Phase 3 直接撰写输出。
根据用户输入自动判断模式：
当用户说"调研XX路线""帮我推荐一条路线"等，执行完整五阶段流程。
当用户说"只调研XX路线""帮我查一下XX路线的路况""做一份XX路线的调研报告"等，只执行 Phase 1-3，产出 .md 调研报告，不生成 .docx/.xlsx。
当用户说"根据这份调研报告生成领队计划""把已有的JSON数据生成文件"等，跳过调研阶段，直接从已有数据（或用户提供的信息）生成 .docx/.xlsx。此时优先读取已有的 _shared/ 下的 JSON 数据或用户指定的数据文件。
判断原则： 如果不确定用户意图，默认使用模式 A（完整流程），并在 Phase 1 时向用户确认。
在开始调研前，检查 _shared/user-config.json（如存在）获取用户偏好。确认用户是否需要按北大徒协模板格式输出：
references/handbook.md（精要）和 references/leader-handbook-full.md（完整版）中的规范（分级公式、领队配比、补贴规则等）与用户对话，逐一确认以下信息。不要一次性列出所有问题，而是以自然对话方式逐步了解。
必须确认的核心信息：
决策分支：
根据用户需求，使用 WebSearch 进行多维度搜索。参考 references/research-guide.md 中的搜索策略。
必做搜索（至少 3 次）：
{地区} {难度} 徒步路线推荐 {季节}{地区} 经典徒步路线 轨迹{地区} {偏好关键词} 徒步 攻略信息收集要点：
以结构化表格呈现 3-5 条候选路线：
| # | 路线名称 | 位置 | 里程(km) | 爬升(m) | 强度等级 | 亮点 | 注意事项 |
|---|---|---|---|---|---|---|---|
| 1 | ... | ... | ... | ... | ... | ... | ... |
每条路线附 1-2 句简要说明。如果按北大徒协格式，同时计算强度分数：路程(km) + 爬升(m)/100。
使用 AskUserQuestion 让用户选择一条路线进行深入调研。选项标签使用路线名称，描述中包含关键参数。
在开始调研前，先在用户当前工作目录下创建以路线/活动名称命名的文件夹：
{用户当前目录}/{路线或活动名称}/
示例：./北灵山一日徒步/ 或 ./西四胡同CityWalk/
所有 Phase 3-5 产出的文件（.md / .json / .docx / .xlsx）均保存到此文件夹中。
Phase 3 结束时，必须产出一份完整的 Markdown 调研报告并保存为文件。 报告直接由 Claude 撰写，使用 Write 工具保存到上述文件夹。
报告命名格式：{路线名称}_徒步线路调研报告.md
报告格式模板见 references/report-template.md。
对选定路线进行全面信息搜集。参考 references/research-guide.md 中的深度调研搜索清单。每个维度需要至少 2 次 WebSearch，交叉验证信息。
时效性要求（重要）： 所有信息必须以当前年份（搜索时使用 {当前年份} 关键词）为基准进行验证。特别注意以下易过时信息的时效性：
优先使用 RedNote-MCP 搜索小红书内容。 小红书的徒步路况、实时反馈是最有价值的一手信息来源，但 WebSearch 无法直接抓取小红书页面。
检测方式： 在开始小红书相关搜索前，尝试调用 search_notes 工具（使用轻量 query 如"徒步 路况"）。调用成功即表示 RedNote-MCP 已配置且 Cookie 有效。
可用时：
search_notes 工具，设置合理的 limit（建议 10-20 条）get_note_content 获取完整内容{路线名} 徒步、{路线名} 路况、{路线名} 劝退、{路线名} {当前月份}月不可用时（三种情况）：
| 情况 | 表现 | 处理 |
|---|---|---|
| 未安装 | 无 search_notes 工具 | 向用户展示一句话提示："💡 安装 RedNote-MCP 可直接搜索小红书路况，参考 references/rednote-mcp-setup.md"。然后降级到 WebSearch |
| Cookie 过期 | search_notes 返回认证错误 | 提示用户运行 rednote-mcp init 刷新登录，本次降级到 WebSearch |
| 其他错误 | 网络/超时等 | 静默降级到 WebSearch，不打断流程 |
降级策略： 使用 WebSearch 搜索 {路线名} 徒步 小红书 或 {路线名} 路况 攻略，获取第三方平台转载/聚合的小红书内容。同时在报告"近期路线动态"章节中标注"小红书内容来自第三方转载，建议在 App 内直接搜索最新帖子"。
搜索 "{路线名}" 轨迹 两步路 "{路线名}" 轨迹 六只脚
起终点坐标精度要求：
40.123456, 116.123456）"{起点地名}" 定位 OR 坐标 交叉验证小红书搜索（RedNote-MCP 优先）：
search_notes 搜索："{路线名}" 徒步、"{路线名}" 路况、"{路线名}" 劝退 OR 排雷get_note_content 提取完整内容WebSearch 补充搜索： "{路线名}" 路况 "{路线名}" 劝退 OR 排雷 OR 注意
搜索 "{路线名}" 封山 OR 防火 OR 管控 OR 修路 {当前年份}
使用 Windy/莉景天气查询，搜索 "{山名} {日期} 天气"
搜索 "{起点地名} 停车" "{起点地名} 公交 {当前年份}"
搜索 "{区域}" 边防证 OR 入山证 OR 门票政策 {当前年份}"
当活动类型为 City walk 时，必须额外搜索以下内容：
免费讲解与公共演出：
搜索 "{区域}" 免费讲解 OR 公益导览 OR 义务讲解 {当前年份}"
搜索 "{区域}" 公共演出 OR 街头表演 OR 文化演出 时间 {当前年份}"
学生票政策：
搜索 "{景点名}" 学生票 OR 优惠票 {当前年份}"
搜索 "{路线名}" 下撤 OR 备用路线
整理所有有价值的参考资料链接，按类别分组。这是报告的重要组成部分。
每条链接必须附带资料的形成日期（发布日期/更新时间），格式为 YYYY-MM-DD。 日期来源：
2026年4月）或标注 日期不详在报告中，每条链接后紧跟日期和来源平台，例如：- [标题](URL) — 简介（2026-04-15，小红书） 或 - [标题](URL) — 简介（2026-04-10，两步路）
筛选标准： 优先收录信息密度高、有实测数据、来自一手经验的参考资料。纯营销推广、内容空洞的链接不收录。
报告按 references/report-template.md 中的模板撰写。使用 Write 工具将报告保存为：
{用户当前目录}/{路线或活动名称}/{路线名称}_徒步线路调研报告.md
向用户展示调研报告的关键发现摘要，而非完整报告。引导用户关注：
在预览中明确标注 [待确认] 的信息：
逐一请用户确认或提供以下内容（使用自然对话，不要一次性列出）：
与用户逐一确认风险级别评定是否合理，特别关注：
根据确认后的所有信息，构建完整的 JSON 数据文件。数据结构参考 scripts/data_model.py 中的 TrailResearchData。
将 JSON 保存到活动输出文件夹：{用户当前目录}/{路线或活动名称}/trail_research_data.json
前置：Python 依赖自检（每次会话首次运行脚本前执行一次）
先探测依赖是否到位：
python -c "import docx, openpyxl"
ModuleNotFoundError：立即安装依赖再重试探测pip install python-docx openpyxl
requirements.txt仅含python-docx和openpyxl两行，直接用上面命令即可，无需定位 skill 目录。
本次会话自检通过后无需重复；下一次新会话再检一次。
按顺序执行以下脚本（使用绝对路径）：
首先定位 skill 目录。skill 可能安装在不同位置，按以下优先级依次检测：
# 自动定位 skill 脚本目录（按优先级检测）
for CANDIDATE in \
"$HOME/.claude/skills/trail-research/scripts" \
".claude/skills/trail-research/scripts" \
"$HOME/.cursor/skills/trail-research/scripts" \
".agents/skills/trail-research/scripts" \
"$HOME/.agents/skills/trail-research/scripts"; do
if [ -f "$CANDIDATE/generate_risk_plan.py" ]; then
SKILL_DIR="$CANDIDATE"
break
fi
done
OUTPUT_DIR="{用户当前目录}/{路线或活动名称}"
DATA_FILE="$OUTPUT_DIR/trail_research_data.json"
# 1. 生成风险预案 .xlsx
python "$SKILL_DIR/generate_risk_plan.py" "$DATA_FILE" "$OUTPUT_DIR/{活动名称}_风险预案.xlsx"
# 2. 生成领队计划 .docx
python "$SKILL_DIR/generate_leader_plan.py" "$DATA_FILE" "$OUTPUT_DIR/{活动名称}_领队计划.docx"
# 3. 生成备案表 .docx
python "$SKILL_DIR/generate_registration_form.py" "$DATA_FILE" "$OUTPUT_DIR/{活动名称}_备案表.docx"
脚本路径： skill 安装位置因 agent 而异，上面的自动检测脚本会依次尝试 Claude Code 用户级/项目级、Cursor、Hermes/通用 agent 等常见路径，找到第一个有效路径后使用。
向用户报告生成结果，所有文件位于同一文件夹：
{用户当前目录}/{路线或活动名称}/询问用户是否需要调整任何文件的内容。如需修改：
trail_research_data.json）当用户需要按北大徒协模板输出时，遵循以下规范（详见 references/handbook.md 精要版和 references/leader-handbook-full.md 完整版）：
路程(km) + 爬升(m)/100，特殊路况 +1 级，重装 +1 级[待确认] 而非填入虚构数据