前言¶
在 Agent 裏處理出行類需求時，常見做法是分別查文檔、拼 REST 參數、再自己整理結果：地點要調 POI 搜索，路線要換路線規劃接口，地址和座標還要在解析與逆解析之間切換。對話裏用戶往往只說「附近有什麼好喫的」「從 A 到 B 怎麼坐公交」「這趟行程標在地圖上」，如果每個能力都手寫一遍接入，成本高且容易漏字段。
下面介紹 SkillHub 上的 騰訊地圖·地圖助手（@tencent-adm/tencentmap-map-assistant）。它把騰訊地圖位置服務的能力封裝成 Skill，用自然語言即可觸發搜索、規劃、天氣、地圖渲染等流程，適合在 Cursor、Claude Code 等支持 Skills 的環境裏開箱使用。
這是什麼¶
騰訊地圖·地圖助手 是騰訊地圖位置服務團隊發佈的企業來源 Skill（分類：life-service，當前版本 v1.6.3）。定位可以概括爲：用一句自然語言調用騰訊地圖全套能力，面向找地點、規劃路線、旅遊行程、查天氣、座標與地址轉換等出行場景。
Skill 在 SkillHub 的座標爲 @tencent-adm/tencentmap-map-assistant。頁面標註 requires_api_key=true，使用前需要準備騰訊地圖相關 API Key，並按 Skill 內說明完成配置（具體環境變量或配置文件字段以安裝後的 SKILL.md 爲準）。
核心功能¶
以下能力均來自 SkillHub 官方簡介，安裝後由 Agent 按 Skill 指引調用對應接口：
- AI 旅遊攻略：根據目的地與偏好生成行程類建議。
- 地點搜索：查詢 POI，簡介中明確包含評分、人均消費、營業時間等字段。
- 關鍵詞提示：輸入過程中的檢索聯想。
- 路線規劃：支持駕車、步行、公交、騎行等出行方式。
- 地址解析與逆解析：文字地址與座標之間的轉換。
- 行政區劃：省市區等層級信息查詢。
- IP 定位：基於 IP 的位置相關能力。
- 距離計算：多點或起終點之間的距離。
- 天氣查詢：與行程、出行相關的天氣信息。
- 自定義地圖輸出：可將行程或多個 POI 渲染爲網頁地圖，或生成騰訊地圖小程序指南。
與「只接一兩個開放接口」相比，該 Skill 把上述能力收斂到同一套對話入口，減少你在 Agent 側重複維護地圖 SDK 文檔與參數表的工作。
安裝與啓用¶
方式一：讓 AI 按官方指引安裝¶
SkillHub 頁面提供的安裝提示詞如下（完整引用官方表述）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@tencent-adm/tencentmap-map-assistant`。
將上述內容發給當前環境的 AI，由其讀取 SkillHub 安裝與優先源配置 並完成安裝與 API Key 配置。
方式二：使用 skillhub CLI¶
若本機已安裝 skillhub，可將 Skill 安裝到當前 Agent 識別的 skills 目錄（安裝到錯誤目錄會導致 Agent 無法加載，需用 --dir 顯式指定）：
command -v skillhub && skillhub --version
未安裝 CLI 時，可按 SkillHub 文檔執行完整安裝（節選）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 示例（將 <skills 目錄> 替換爲實際路徑）：
skillhub install @tencent-adm/tencentmap-map-assistant --dir <skills 目錄>
常用客戶端的 skills 目錄（來自 SkillHub 安裝文檔）：
| 環境 | 默認 skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
安裝完成後，在對應客戶端啓用 Skills，並配置騰訊地圖 API Key（Skill 標籤要求 requires_api_key=true）。Codex CLI、Claude Code、Cursor 的差異主要體現在 skills 目錄與配置入口，安裝命令本身一致；若某客戶端不支持 SkillHub CLI，優先採用「方式一」由 Agent 按 skillhub.md 操作。
典型用法¶
官方定位是「一句自然語言」觸發能力，而非固定 CLI 子命令。結合簡介中的能力列表，可在對話中直接描述意圖，例如：
- 找店並看詳情：「在深圳南山區找評分 4.5 以上的川菜館，列出人均和營業時間。」
- 多模式路線：「從騰訊濱海大廈到深圳北站，對比公交和駕車大概多久。」
- 行程與地圖：「幫我規劃週末杭州兩日遊，把主要景點標成網頁地圖。」
- 地址與座標：「把『北京市海淀區中關村大街 1 號』轉成經緯度。」
- 出行輔助：「明天廣州天河區天氣怎麼樣？」
Agent 會依據 SKILL.md 選擇地點搜索、路線規劃、天氣等工具鏈；你無需在對話裏手寫接口路徑或參數名。若需小程序指南或網頁地圖，在需求裏說明輸出形式即可（簡介支持網頁 / 小程序指南）。
適用場景與注意¶
適合誰
- 在 Agent 中頻繁處理地圖、出行、本地生活檢索的開發者或個人用戶。
- 希望減少自建「地圖工具函數」維護成本，又需要騰訊地圖官方數據與能力的場景。
使用注意
- API Key：必須按 Skill 說明配置密鑰；未配置時相關調用無法完成。
- 配額與合規：能力依賴騰訊地圖位置服務，需遵守其開放平臺的使用條款與配額限制。
- 數據以接口爲準：評分、營業時間、路線耗時等字段由地圖服務返回，對話中的表述應與 Skill 執行結果一致，重要決策請二次覈對。
- 版本：SkillHub 當前展示版本爲 v1.6.3；升級可通過
skillhub或讓 AI 按官方安裝文檔更新。
SkillHub 頁面統計（以抓取時 SkillHub 數據爲準）：分類 life-service，評分 100000，下載 24324 次。若你在外部渠道看到不同數字，以 SkillHub 技能頁 實時展示爲準。
結尾¶
經過上面的步驟，騰訊地圖·地圖助手 的價值可以概括爲：把分散的地圖開放能力收攏到 Agent 對話裏，用自然語言完成搜索、規劃、天氣與地圖呈現，由騰訊地圖位置服務團隊維護 Skill 與能力邊界。
- SkillHub 技能頁：https://www.skillhub.cn/skills/tencent-adm/tencentmap-map-assistant
- API 入口頁：https://api.skillhub.cn/tencent-adm/tencentmap-map-assistant
- 安裝說明：https://skillhub.cn/install/skillhub.md
