前言¶
在 Agent 裏做旅遊攻略，常見問題是輸出停留在零散要點：目的地、天數、交通各說一段，難以直接拿去訂酒店、算預算或發給同行。自己拼 HTML 或公衆號排版又費時，且里程、票價、酒店價格若靠模型臆測，方案可信度會明顯下降。
下面介紹 SkillHub 社區技能「旅行藍圖」（座標 @user_e1d00e01/travel-planning-expert，原名稱「旅遊規劃專家」）。它用固定三階段對話收集需求，最終生成結構化的 HTML 旅遊規劃，並針對自駕與公共交通兩類場景接入路線與價格相關能力。當前版本爲 v2.2.0，分類爲 life-service，發佈者爲 user_e1d00e01。
這是什麼¶
「旅行藍圖」是面向 life-service 場景的 Agent Skill，定位是高效、貼心的旅遊行程規劃助手：根據用戶意圖產出可直接參考的規劃方案，覆蓋旅行路線、每日安排、交通指南、住宿推薦、美食推薦、預算估算與實用貼士。
技能以通用 SKILL.md 形式分發，通過 SkillHub 安裝後在支持 Skills 的 AI 客戶端中觸發。官方 API 地址：https://api.skillhub.cn/user_e1d00e01/travel-planning-expert；展示與安裝頁：https://www.skillhub.cn/skills/user_e1d00e01/travel-planning-expert。
核心功能¶
以下能力均來自 SkillHub 頁面與已抓取元數據，可按需裁剪使用。
三階段工作流¶
技能按順序推進，避免一次性問過多問題：
- 環境檢測與安裝：確認運行依賴與技能環境是否就緒。
- 信息收集：補齊目的地、天數、出行方式等規劃所需信息。
- 生成規劃：輸出結構化 HTML 格式的完整方案；頁面說明支持一鍵複製爲微信公衆號文本格式（正文不做公衆號 HTML 排版時，仍可直接使用 HTML 結構）。
規劃內容範圍¶
生成結果面向「可執行參考」，通常包含：
- 目的地與整體路線
- 分日安排
- 交通指南（含自駕或公共交通差異）
- 住宿與美食推薦
- 預算估算
- 實用貼士
自駕與公共交通¶
技能區分兩類行程：
- 自駕：調用內置真實路線管線，獲取真實里程、車程、過路費，並繪製內嵌路線圖。
- 公共交通：在相同三階段流程下生成對應交通與日程安排（具體字段以對話收集結果爲準）。
價格與評分數據來源¶
酒店評分與價格、景區票價優先通過 同程程心（tc-chengxin） 實時查詢；住宿費用另按 每日系數法 估算。標籤 requires_api_key=true 表示部分能力依賴 API 密鑰，安裝後需按技能內說明配置，否則實時查詢類信息可能不可用。
觸發意圖¶
當用戶表達類似以下意圖時，Agent 可掛載該技能：
- 「幫我規劃一次旅行」
- 「做一份旅遊攻略」
- 「我要去 XX 玩幾天」
- 「XX 自駕遊規劃」
- 「XX 旅遊規劃」
安裝與啓用¶
方式一：讓 AI 按官方指引安裝¶
將下面提示詞發給當前 Agent（Cursor、Claude Code、Codex CLI 等均可，以客戶端是否支持 Skills 爲準）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_e1d00e01/travel-planning-expert`。
Agent 會按 SkillHub 安裝文檔檢查 CLI、選擇當前環境的 skills 目錄並完成安裝。
方式二：使用 skillhub CLI¶
若本機已有 skillhub，可先確認版本：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 文檔執行完整安裝（示例爲文檔中的推薦命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝技能時 必須 使用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能無法被識別。常用路徑示例（以 SkillHub 文檔爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝命令形式如下（將 <skills 目錄> 替換爲實際路徑）：
skillhub install @user_e1d00e01/travel-planning-expert --dir <skills 目錄>
安裝完成後，按所用客戶端要求重啓或刷新 Skills 列表。因標籤含 requires_api_key=true，啓用前請完成技能要求的 API Key 配置。
典型用法¶
經過上面的安裝步驟後，用自然語言發起規劃即可，技能會在三階段流程中追問缺失信息。
示例 1：多日目的地攻略
幫我規劃一次旅行：想去成都玩 4 天，公共交通，預算中等，希望包含美食和市區經典景點。
示例 2：自駕遊
做一份川西自駕遊規劃，從上海出發，7 天，重點看自然風光，需要真實車程和過路費估算。
示例 3：簡短觸發
我要去西安玩 3 天，生成行程單，用 HTML 輸出。
對話結束後，應得到一份結構化 HTML 規劃；若需要公衆號發文，可按技能說明將內容複製爲微信公衆號文本格式，再自行排版。
適用場景與注意¶
適合誰
- 需要把「聊出來的想法」變成結構化行程、預算與交通說明的個人或小團隊。
- 自駕場景下希望里程、車程、過路費與路線圖來自路線管線，而非純文本估算。
- 希望酒店評分、景區票價儘量對齊同程程心實時數據的用戶（需配置 API）。
限制與注意
- 技能來源爲 community，質量與數據時效依賴發佈者與外部接口；出行前仍建議覈對官方票務與路況。
- 實時查詢與自駕路線能力受
requires_api_key=true及網絡環境影響；未配置密鑰時，規劃可能退化爲通用建議。 - SkillHub 統計（以已抓取資料爲準）：評分 100000，下載 9308 次；安裝數在抓取時爲 0，以頁面實時數據爲準。
- 用戶線索中的「基本信息收集 → 偏好選擇 → 生成規劃」與官方當前描述略有差異；以官方三階段 環境檢測與安裝 → 信息收集 → 生成規劃 爲準。
結尾¶
「旅行藍圖」把旅遊規劃從散點回答收斂爲可複製的 HTML 方案，並在自駕與價格維度上接入了路線管線和同程程心查詢。若你經常在 Agent 裏做攻略，可從官方頁安裝 v2.2.0 並按文檔配置 skills 目錄與 API Key：https://www.skillhub.cn/skills/user_e1d00e01/travel-planning-expert。
