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