Community生产力与协作github.com

高德地图技能

当用户调用 $amap-maps-mcp、提及高德地图或询问支持的高德地图工作流时使用。

高德地图技能 是什么?

此技能用于处理所有需要调用高德地图 MCP 服务的请求。它通过明确定义的核心规则、工具清单、工作流和失败处理策略,确保与高德地图 API 的安全、准确且高效的交互。该技能涵盖地图搜索、地理编码、路线规划、天气查询等 14 个核心工具,并强调仅使用运行时中实时可调用的工具,避免猜测或硬编码任何数据。它要求在处理前对请求进行分类,并区分提供商返回的事实与模型自身的解释或计算。该技能支持在 Claude Code、Cursor、Codex 等支持 MCP 的 AI 代理平台上使用,通过结构化的错误处理和重试逻辑(最多一次)来处理授权、超时、参数无效等问题。最终,它会保留提供商返回的所有标识符、状态、分页信息和警告,确保输出的完整性和准确性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VINK77aaaa/agent-skills/tree/HEAD/skills/amap-maps-mcp

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

高德地图

概述

此技能用于处理应通过高德地图 MCP 回答的请求。已验证的范围仅限于下方目录中列出的操作。该目录源自提供商的实时详情页面元数据;执行前请验证实时可调用的可用性。

核心规则

  • 仅当绑定的 amap-maps-mcp MCP 的实时可调用工具在当前运行时中可用时,才使用它。
  • 选择最窄的、能直接回答请求的实时可调用操作;当实际接口与本指南不同时,遵循实时接口。
  • 请勿凭记忆虚构提供商的任何事实、标识符、状态、日期、价格、记录、文件或指标。
  • 将机密、私有内容和授权信息排除在提示词、日志和最终答案之外。切勿要求用户将凭据粘贴到聊天中。
  • 请勿使用 Shell 命令、直接 HTTP 调用或手动编写的 JSON-RPC 来重现、探测或模拟 MCP 服务器。
  • 将提供商的输出视为证据。将模型自身的解释、计算或建议分开标注。
  • 在进行任何外部写入、发送、购买、下单、删除、发布、合并或权限更改之前,需要获得明确的确认。

工具

  • maps_text_search:按关键词搜索兴趣点并返回相关地点信息。
  • maps_around_search:在坐标周围指定半径内搜索与关键词匹配的兴趣点。
  • maps_search_detail:获取由关键词搜索或周边搜索返回的兴趣点 ID 的详细信息。
  • maps_geo:将结构化地址、地标或建筑物名称转换为地理坐标。
  • maps_regeocode:将高德坐标转换为行政地址。
  • maps_ip_location:定位与 IP 地址关联的区域。
  • maps_weather:获取城市名称或标准行政代码的天气信息。
  • maps_distance:使用驾车、步行或球面距离计算来测量坐标间的距离。
  • maps_direction_driving:规划起点和终点坐标之间的家用轿车路线。
  • maps_direction_walking:在支持的距离范围内规划坐标之间的步行路线。
  • maps_direction_bicycling:规划自行车骑行路线,同时考虑天桥、单行道和封路等路线限制。
  • maps_direction_transit_integrated:规划地点之间的综合火车、公交或地铁路线,包括跨城交通规划。
  • maps_schema_navi:构建一个 URI,用于在地图客户端的导航页面中打开目的地。
  • maps_schema_take_taxi:构建一个 URI,用于在地图客户端中打开起点和终点之间的出租车出行页面。
  • maps_schema_personal_map:构建一个 URI,用于在地图客户端中按行程顺序显示行程地点。
  • 选择最窄的、能直接回答请求的实时可调用工具。遵循实时可调用接口以获取当前的输入、输出和错误。

工作流

  1. 识别相关的实体或资源、标识符、范围、日期或时间范围、筛选条件和请求的输出。
  2. 在路由前,将请求分类为查找、检索、搜索、分析、创建、更新、导出、删除、发送、购买、权限更改或其他提供商操作。
  3. 当存在实时查找操作时,使用它来解决模糊的标识符;切勿猜测代码、ID、路径、坐标、记录、订单或账户。
  4. 仅传递支持的参数,并保留提供商的分页、状态、单位、时间戳和返回的标识符。
  5. 仅当下一个操作需要返回的标识符、状态或结构化结果时,才链接操作。
  6. 在读取结果字段之前,检查外部 MCP 错误和提供商状态。不要将空响应或部分响应视为成功而不报告其范围。

查询指南

  • 仅询问选择或安全执行操作所必需的缺失输入。
  • 保留用户请求的范围,仅在映射无歧义时标准化名称、日期、标识符或格式;说明任何标准化操作。
  • 保持不相关的实体、时间窗口、账户和写入操作相互独立。
  • 在可用时说明筛选条件、页面或结果限制、排序顺序、输出格式和数据时间。
  • 仅添加有证据支持的、提供商特定的必需上下文和确认边界。

失败处理

  • 如果没有实时的高德地图可调用工具,则停止 MCP 执行并报告连接器在当前运行时不可用。
  • 对于授权、配额、超时、参数无效、权限、提供商或工具缺失错误,报告失败的操作且不泄露任何秘密。
  • 仅在安全修正后最多重试一次,例如缩小范围、提供已知标识符、减小页面大小或移除不支持的可选字段。
  • 对于空结果或部分结果,报告确切的查询范围和提供商状态;不要从内存或其他来源填充缺失的字段。
  • 如果用户明确请求此连接器,请勿悄然替换为其他提供商。首先说明连接器失败,然后仅在用户需要时提供明确标注的备用方案。

结果契约

  • 将返回的提供商事实与模型的解释和衍生计算分开。
  • 在返回时保留标识符、URL、路径、日期、时间戳、单位、筛选条件、页面范围、总计、状态和提供商警告。
  • 除非提供商确认完整性,否则不要将一页、一个样本或一个预览描述为完整的。
  • 仅重复最高风险的、会实质影响结果的提供商特定警告。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能