前言¶
微信小程序裏的地圖能力分散在原生 map 組件、各類覆蓋物（marker、polyline、polygon、circle 等）以及騰訊位置服務 WebService API 文檔裏。實際開發時，常見問題包括：組件屬性與事件怎麼配、標記點和氣泡怎麼聯動、路線與 POI 該走哪條接口、以及後端能力是否要在小程序裏用 wx.request 直連。查文檔、拼示例往往佔掉不少時間。
下面介紹 SkillHub 上的「騰訊地圖小程序開發技能」：由騰訊地圖位置服務團隊發佈，面向微信小程序場景，把地圖組件、位置能力與 WebService 調用方式整理成可被 AI Agent 加載的 Skill，在對話裏按任務給出可落地的開發指導。
這是什麼¶
騰訊地圖小程序開發技能（座標 @tencent-adm/tencentmap-miniprogram-skill，當前版本 v1.0.5）是 SkillHub 分類 dev-programming 下的企業來源（enterprise）技能，發佈者爲騰訊地圖位置服務團隊。
一句話定位：當需求涉及微信小程序地圖功能開發時，加載該 Skill，由 Agent 按技能內指引組織實現步驟；涉及後端位置能力時，技能說明中統一採用 wx.request 直連騰訊位置服務 WebService API（全參數調用），適用平臺僅爲微信小程序。
SkillHub 頁面標註標籤 requires_api_key=true，即相關 WebService 調用通常需要配置騰訊位置服務的 Key，具體申請與域名白名單以騰訊位置服務官方文檔爲準。
核心功能¶
以下能力均來自 SkillHub 官方簡介，與頁面描述一致：
- 地圖組件：
map及常見地圖交互與展示相關開發指導。 - 位置服務：與定位、位置獲取等小程序側能力相關的實現說明。
- 標記點管理：
marker、callout等點標記與標註展示。 - 覆蓋物與圖形：折線、多邊形、圓形、弧線等（對應
polyline、polygon、circle及簡介中提到的弧線等場景）。 - 路線規劃：導航、路線相關能力與接口使用思路。
- 地理編碼：地址與座標互轉等 WebService 能力。
- POI 搜索：興趣點檢索類接口與參數用法。
- 點聚合：大量標記點時的聚合展示。
- 可視化圖層：含簡介中提到的熱力圖等圖層類能力。
技能描述中明確：當用戶提到 map 組件、marker、callout、polyline、polygon、circle、定位、導航、路線規劃、POI 搜索、地理編碼、點聚合、熱力圖、騰訊地圖 SDK 等關鍵詞時，應加載此技能。
安裝與啓用¶
技能基於通用 SKILL.md 格式，通過 SkillHub 安裝到當前 Agent 的 skills 目錄後纔會被識別。
方式一：讓 AI 按官方提示安裝¶
SkillHub 技能頁給出的安裝提示爲：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@tencent-adm/tencentmap-miniprogram-skill`。
將上述內容發給支持 Skill 的 AI 客戶端，由 Agent 按 SkillHub 安裝說明 完成 CLI 檢查與安裝。
方式二：本機使用 skillhub CLI¶
先確認是否已安裝 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 文檔執行完整安裝（含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄（裝到默認 ./skills/ 可能不會被識別）。文檔中給出的常見路徑示例：
| 客戶端 | skills 目錄（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
安裝命令形式（將 <skills 目錄> 替換爲實際路徑）：
skillhub install @tencent-adm/tencentmap-miniprogram-skill --dir <skills 目錄>
也可先搜索再安裝：
skillhub search tencentmap-miniprogram
skillhub install @tencent-adm/tencentmap-miniprogram-skill --dir <skills 目錄>
安裝完成後，按所用客戶端要求重啓或刷新 Agent，使技能生效。
典型用法¶
官方資料未單獨給出業務代碼片段，但明確了使用方式與架構約定，可按下面步驟在對話裏復現：
-
在涉及微信小程序地圖的需求會話中加載技能
例如：「在小程序裏用map展示多個門店 marker，點擊顯示 callout」「用 WebService 做路線規劃並在地圖上畫 polyline」等。Agent 應在匹配到地圖、定位、POI、編碼等意圖時讀取@tencent-adm/tencentmap-miniprogram-skill。 -
前端以微信原生地圖能力爲主
按技能指引配置頁面 WXML/WXSS/JS 中的map、markers、polyline等結構與事件，而不是脫離小程序運行環境的通用 Web 地圖寫法。 -
後端位置能力走
wx.request+ WebService
技能說明強調：後端服務能力統一通過wx.request直連騰訊位置服務 WebService API，並支持全參數調用。實現時應在小程序後臺配置 request 合法域名，並在請求中攜帶平臺要求的 Key（與requires_api_key=true一致）。 -
分模塊提問
點聚合、熱力圖、POI 搜索、地理編碼等可拆開問，便於 Agent 按技能內分主題引用對應參數與注意事項。
適用場景與注意¶
適合誰
- 正在開發或維護微信小程序，需要地圖展示、定位、檢索、路線或圖層能力的工程師。
- 希望減少在組件文檔與 WebService 文檔之間來回切換，用 Agent 按統一約定（尤其
wx.request直連）生成實現步驟的團隊。
限制與注意
- 平臺：僅適用於微信小程序，不適用於普通 H5 或 App 內嵌 WebView 的通用地圖方案（除非另行適配）。
- Key 與合規：標籤標明需要 API Key；WebService 調用需遵守騰訊位置服務的使用條款、配額與安全要求。
- 技能是開發指引，不是運行時 SDK：它指導 Agent 如何組織答案與步驟，小程序仍須在微信開發者工具中編譯、真機驗證權限（如定位授權）與地圖表現。
- 版本：SkillHub 當前展示爲 v1.0.5；升級可用
skillhub在對應 skills 目錄執行更新流程（以 skillhub 安裝文檔 爲準）。
SkillHub 統計（以頁面展示爲準）：評分 100000，下載 5305，安裝 234。
結尾¶
微信小程序地圖開發橫跨組件層與位置服務 API，參數多、文檔散。「騰訊地圖小程序開發技能」把組件、標記、路線、POI、編碼、點聚合與可視化圖層等主題收斂爲 Agent 可加載的 SKILL，並約定 WebService 側通過 wx.request 全參數調用，適合作爲地圖相關需求的默認技能來源。
- SkillHub 技能頁：https://www.skillhub.cn/skills/tencent-adm/tencentmap-miniprogram-skill
- API 入口：https://api.skillhub.cn/tencent-adm/tencentmap-miniprogram-skill
