Community生產力與協作github.com

高德地圖技能

當用戶呼叫 $amap-maps-mcp、提到高德地圖或詢問支援的高德地圖工作流程時使用。

高德地圖技能 是什麼?

此技能讓 AI 代理能透過高德地圖 MCP 與其地圖服務互動。它提供一套全面的工具,用於文字搜尋、周邊探索、地理編碼、反向地理編碼、IP 定位、天氣查詢、距離計算、多種交通方式的路線規劃(駕車、步行、自行車、公共交通)以及用戶端導航 URI 建置。主要支援 Claude Code、Cursor 和 Codex 等平台,確保地圖操作能安全且精確地執行。技能遵循嚴格的規則:僅使用即時可呼叫的 MCP 工具、依賴提供者提供的資料、避免憑證暴露,並在執行資料修改動作前要求使用者明確確認。故障處理包括針對授權錯誤、逾時或無效引數進行優雅降級和重試邏輯,優先考慮透明度和使用者控管。

相容平台~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.

相關技能