前言¶
微信小程序里的地图能力分散在原生 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
