1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | azure-maps-MicrosoftDocs-Agent-Skills |
| 作者/维护者 | Microsoft（MicrosoftDocs 官方文档团队） |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-maps |
| 许可证 | CC BY 4.0（仓库整体，来自 GitHub API） |
| GitHub Stars | 733（仓库整体；来自 GitHub API，合集仓库共享，不代表本技能自身热度） |
| Forks | 117（仓库整体，来自 GitHub API） |
| 最新版本 | 无独立版本号，随 Microsoft Learn 文档同步滚动生成；本子技能最近一次内容生成于 2026-08-31（来自 SKILL.md metadata） |
| 安装方式 | 插件市场一键安装，或手动克隆仓库后复制子目录 |
2. 功能介绍与亮点
这是一份把 Azure Maps 官方文档蒸馏成的结构化专家知识库。SKILL.md 用“分类索引表”组织七大主题——最佳实践、决策指南、架构与设计模式、限额配额、安全、配置、集成与编码模式，每个主题标注精确行号区间，agent 按需读取对应片段；正文附带近 90 条 Microsoft Learn 官方链接，覆盖 Web/REST/Power BI 三种 SDK、地理编码、路由、天气、瓦片渲染、空间数据 IO 等具体能力。
亮点：① 官方第一方出品，内容生成于 2026-08-31，更新及时；② 覆盖面广——从鉴权（API Key/SAS/Entra ID/私有终结点）到 Power BI 可视化插件配置、WebGL 自定义图层，均有独立条目；③ 单列一份“从 Bing Maps / Google Maps 迁移到 Azure Maps”的完整指南集，覆盖地理编码、路由、静态图、时区、瓦片等十余项逐一对照迁移步骤，对存量迁移项目尤其实用。
3. 适用场景
所属分类：集成与工作流自动化（该技能的核心价值是指导开发者把 Azure Maps 的 Web/REST/Power BI SDK 与 API 接入自己的应用，属于“给应用接入第三方服务 SDK/API”）。
适合正在给 Web 应用、移动端或 Power BI 报表添加地图能力的开发者：实现地理编码与地址搜索、路线规划与多站点优化、实时交通与天气图层、自定义地图渲染与空间数据可视化，或是正在把现有 Bing Maps / Google Maps 集成迁移到 Azure Maps 的团队，都可以用它快速定位官方文档里的具体接入步骤。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——SKILL.md 格式原生识别，官方提供插件市场一键安装命令，文档抓取可用 mcp_microsoftdocs 或内置 WebFetch。
- Codex CLI：⚠️ 需适配——官方仓库虽列出 Codex CLI 安装路径，但 Codex 默认沙箱不带网络访问，本技能的文档抓取功能依赖联网，需用户显式开启网络权限才能完整发挥效果。
- OpenClaw：✅ 原生支持（格式层面）——SKILL.md 与 Claude Code 采用同一开放标准，可直接复制安装，但需自行确认平台是否提供等效的网页抓取工具。
- Hermes Agent：❓ 未验证——遵循同一 SKILL.md 开放标准，具体网络抓取能力未逐一核实。
5. 推荐理由
把分散在 Microsoft Learn 里的 Azure Maps 开发知识整理成可按需检索的结构化索引，尤其是“从 Bing/Google Maps 迁移”这类分散在多篇文档里才能拼齐的操作步骤，一份索引就能定位齐全。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Microsoft 是 Azure Maps 所属产品的第一方所有者；所属仓库共 733 星（合集仓库整体数据，不代表本技能自身热度）；目前未见该子技能自身独立的第三方引用或讨论 |
| 可用性 | 9 | 插件市场一条命令即可安装，SKILL.md 索引结构完整、覆盖面广、附近 90 条官方链接；内容生成于 2026-08-31，近期有更新，无付费依赖 |
| 安全性 | 9 | 纯参考文档类内容，无代码执行；联网仅为抓取 Microsoft 官方文档页面，目标透明；License（CC BY 4.0）明确，未发现可疑指令或隐蔽外发 |
安全检查清单：①无 shell 命令执行；②仅联网抓取 microsoft.com/learn 官方文档页面，无其他数据外发；③无需 API key/凭据（Azure Maps 服务本身的鉴权仅作为文档指导内容出现）；④SKILL.md 全文为文档索引与链接，未见 prompt injection 迹象；⑤作者为 Microsoft 官方团队，无造假迹象；⑥License 明确（CC BY 4.0）；⑦最近内容生成于 2026-08-31，维护活跃。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| Google Maps Platform 官方文档 | 竞品地图云服务的官方参考站点 | 内容权威但分散在多个产品页面，需要自行搜索定位；本技能按 agent 可读的行号索引组织，且专为迁移到 Azure Maps 场景准备了逐项对照指南 |
| Mapbox 官方文档 | 开源生态地图云服务的参考站点 | 定制化程度高、社区生态活跃，但同样是面向人工阅读的传统文档站；本技能针对 AI coding assistant 的按需检索场景做了结构化重排 |
8. 用户评价
该技能目前在第三方平台（Reddit、Hacker News、具名技术博客）尚无具名用户评价。
9. 安装使用方式
方式一：插件市场一键安装（推荐）
/plugin marketplace add MicrosoftDocs/agent-skills
/plugin install azure-agent-skills@microsoft-agent-skills方式二：手动安装
git clone https://github.com/MicrosoftDocs/agent-skills.git
# 将 skills/azure-maps/ 复制到目标位置，例如：
# 项目级：{你的项目}/.claude/skills/azure-maps/
# 全局级：~/.claude/skills/azure-maps/安装后无需重启，agent 下次对话即可按需加载该技能；触发方式为对话中提及 Azure Maps 相关开发问题。
10. 注意事项
- 本技能本体只含分类索引与官方文档链接，完整文档正文需联网通过 mcp_microsoftdocs 工具或通用网页抓取能力实时获取，离线环境下只能看到索引与链接。
- SKILL.md 内建提醒：若
generated_at超过 3 个月，建议从仓库拉取最新版本，避免依据过期文档操作。 - 仓库整体 733 星与 117 fork 为共享数据，不代表本技能自身独立采用度。