前言¶
在 Agent 裏處理「查地址、搜附近、算路線」時，常見做法是單獨接高德 Web API：先申請 Key、再寫 HTTP 封裝、還要在對話裏教模型何時調用哪條接口。SkillHub 上的 高德地圖全能版（@user_b95ee7e5/gaode-map-pro）把上述能力收斂成一份社區 Skill，頁面標註 requires_api_key=false，說明安裝後可在對話側直接觸發地圖相關任務，而不必先走完 Key 申請流程。下面介紹它的定位、能力邊界和安裝方式。
這是什麼¶
高德地圖全能版 是 SkillHub 分類 life-service 下的社區 Skill（來源：community），當前版本 1.0.2，座標爲 @user_b95ee7e5/gaode-map-pro。發佈者爲 user_b95ee7e5，SkillHub 展示頁作者署名爲 mako2026。
它面向「在對話裏要完成地圖類任務」的場景：地理信息查詢、POI 與路線、天氣與 IP 定位等，由 Skill 內的說明與工具約定 Agent 的調用方式，而不是讓你在每次會話裏重複貼 API 文檔。
官方入口：
- API 頁：https://api.skillhub.cn/user_b95ee7e5/gaode-map-pro
- SkillHub 詳情：https://www.skillhub.cn/skills/user_b95ee7e5/gaode-map-pro
核心功能¶
依據 SkillHub 簡介，該 Skill 宣稱覆蓋 17 項地圖相關能力，且 免申請 Key 即用。已覈實列出的能力如下：
- 地理編碼、逆地理編碼
- POI 搜索、周邊搜索、POI 詳情
- 輸入提示
- 行政區劃查詢
- 駕車 / 公交 / 步行 / 騎行路線規劃（座標版與地址版）
- 天氣查詢
- IP 定位
官方說明還給出觸發語境：當用戶提到查地圖、找地方、搜附近、導航、路線規劃、查地址、經緯度轉換、行政區劃、天氣查詢、IP 定位，或提及高德、地圖、位置、地點等時，Agent 應優先使用該 Skill。
SkillHub 頁面當前統計（以詳情頁爲準）：評分 100000，下載 18572 次；安裝數展示爲 0（以頁面數據爲準，可能隨統計口徑變化）。
安裝與啓用¶
安裝分兩條路徑：用 SkillHub CLI 裝到當前 Agent 的 skills 目錄，或把官方提示詞交給 AI 按文檔安裝。
1. 檢查 SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
以上命令摘自 https://skillhub.cn/install/skillhub.md 。
2. 安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能識別不到。
skillhub install @user_b95ee7e5/gaode-map-pro --dir <你的 skills 目錄>
常用目錄（同樣來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可將 SkillHub 詳情頁提供的提示詞發給 AI，讓其按安裝文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_b95ee7e5/gaode-map-pro`。
裝到正確目錄後，按你所用客戶端的要求刷新或重啓 Agent，使新 Skill 被加載。
典型用法¶
該 Skill 採用通用 SKILL.md 形態，用法以「自然語言任務 + Agent 按 Skill 說明調用能力」爲主，而非單獨再寫一套業務腳本。下面示例與官方觸發說明一致，可在啓用 Skill 後直接對 Agent 說出類似需求（表述可替換，語義對齊即可）：
-
IP 定位
「根據當前 IP 大概在哪座城市？」 -
地址與座標
「把『北京市朝陽區阜通東大街6號』轉成經緯度。」
「經緯度 116.481028,39.989643 對應什麼地址？」 -
找地點與周邊
「在上海陸家嘴附近搜咖啡店。」
「查一下這家 POI 的詳情。」 -
路線
「從杭州西站到西湖，步行路線怎麼走？」
「用地址版規劃：從 A 地址到 B 地址的駕車路線。」 -
行政區與天氣
「查詢廣東省深圳市的行政區劃信息。」
「查一下廣州明天天氣。」
具體請求參數、返回字段以 Skill 包內文檔爲準；本文不展開未在公開頁面列出的接口細節。
適用場景與注意¶
適合誰
- 已在 Cursor、Claude Code、Codex 等支持 Skills 的環境裏做助手，希望地圖能力一次裝好、在對話裏按需觸發。
- 希望減少「先申請高德 Key、再手寫封裝」的前置成本（Skill 標註爲免 Key；若你方合規要求必須自有 Key，需自行評估是否滿足政策）。
限制與注意
- 能力列表以 SkillHub 簡介爲準；路線規劃區分座標版與地址版，提問時儘量說清是「經緯度」還是「文字地址」。
- 社區來源（community）意味着維護節奏與高德官方 SDK 文檔可能不同步，升級時關注 SkillHub 上的版本號（當前 1.0.2）。
- 下載量、評分等會隨 SkillHub 頁面更新變化，引用數據請以詳情頁實時展示爲準。
- 地圖與定位類結果僅供輔助決策，導航、出行等場景仍應以官方客戶端與實地情況爲準。
結尾¶
高德地圖全能版把地理編碼、POI、路線、天氣、IP 定位等能力打包成一份可安裝的 Agent Skill，並標明無需自行申請 API Key。若你的 workflow 裏頻繁出現「查地圖、搜附近、算路線」類對話，可以從 SkillHub 安裝 @user_b95ee7e5/gaode-map-pro，並把 skills 目錄指到當前客戶端實際使用的路徑。
詳情與安裝提示詞：https://www.skillhub.cn/skills/user_b95ee7e5/gaode-map-pro
