前言¶
在 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
