VINK77aaaa/agent-skills

Utiliser lorsque l'utilisateur invoque $amap-maps-mcp, mentionne Amap Maps ou demande les workflows Amap Maps pris en charge.

Qu'est-ce que agent-skills ?

Cette compétence permet à un agent IA d'interagir avec l'API Amap Maps via le protocole MCP (Model Context Protocol). Elle expose un ensemble d'outils dédiés aux recherches de points d'intérêt (textuelles, géographiques, détails), à la géocodification/inverse, aux informations météo, au calcul de distances et d'itinéraires (voiture, marche, vélo, transports en commun), ainsi qu'à la génération de liens d'ouverture vers l'application de cartographie. L'agent peut ainsi répondre à des demandes de localisation, de navigation ou de planification. La compétence impose des règles strictes : utilisation exclusive de l'outil MCP disponible en runtime, sélection de l'opération la plus adaptée, interdiction d'inventer des informations ou de contourner l'API, et maintien de la confidentialité des données utilisateur. En cas d'échec ou d'outil indisponible, l'agent doit signaler l'incapacité et peut proposer une solution alternative après accord explicite de l'utilisateur.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VINK77aaaa/agent-skills/tree/HEAD/skills/amap-maps-mcp

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Amap Maps

Présentation

Utilisez cette compétence pour les demandes auxquelles il faut répondre via le MCP Amap Maps. Le périmètre vérifié est limité aux opérations listées dans le catalogue ci-dessous. Le catalogue provient des métadonnées de la page de détail en direct du fournisseur ; vérifiez la disponibilité en direct avant exécution.

Règles fondamentales

  • Utilisez le MCP amap-maps-mcp lié uniquement lorsque ses outils appelables en direct sont disponibles dans le runtime actuel.
  • Sélectionnez l'opération appelable en direct la plus étroite qui répond directement à la demande ; suivez l'interface en direct lorsqu'elle diffère de ce guide.
  • N'inventez pas de faits, d'identifiants, de statuts, de dates, de prix, d'enregistrements, de fichiers ou de métriques provenant du fournisseur à partir de la mémoire.
  • Gardez les secrets, le contenu privé et les éléments d'autorisation hors des invites, des journaux et des réponses finales. Ne demandez jamais à l'utilisateur de coller des identifiants dans le chat.
  • N'utilisez pas de commandes shell, d'appels HTTP directs ou de JSON-RPC écrit à la main pour recréer, sonder ou simuler le serveur MCP.
  • Considérez les résultats du fournisseur comme une preuve. Étiquetez séparément les interprétations, calculs ou recommandations du modèle.
  • Exigez une confirmation explicite avant toute écriture, envoi, achat, commande, suppression, publication, fusion ou modification de permission externe.

Outils

  • maps_text_search : Recherche des points d'intérêt par mot-clé et renvoie les informations de lieu associées.
  • maps_around_search : Recherche des points d'intérêt correspondant à un mot-clé dans un rayon autour de coordonnées.
  • maps_search_detail : Récupère les détails d'un identifiant de point d'intérêt renvoyé par une recherche par mot-clé ou à proximité.
  • maps_geo : Convertit une adresse structurée, un point de repère ou un nom de bâtiment en coordonnées géographiques.
  • maps_regeocode : Convertit une coordonnée Amap en une adresse administrative.
  • maps_ip_location : Localise la zone associée à une adresse IP.
  • maps_weather : Récupère la météo pour un nom de ville ou un code administratif standard.
  • maps_distance : Mesure la distance entre des coordonnées en utilisant des calculs de conduite, de marche ou de distance sphérique.
  • maps_direction_driving : Planifie un itinéraire en voiture particulière entre des coordonnées d'origine et de destination.
  • maps_direction_walking : Planifie un itinéraire à pied entre des coordonnées dans la plage de distance prise en charge.
  • maps_direction_bicycling : Planifie un itinéraire à vélo en tenant compte des restrictions de route telles que les ponts, les rues à sens unique et les fermetures.
  • maps_direction_transit_integrated : Planifie un itinéraire intégré en train, bus ou métro entre des lieux, y compris la planification de transit interurbain.
  • maps_schema_navi : Construit une URI qui ouvre le client cartographique sur une page de navigation pour une destination.
  • maps_schema_take_taxi : Construit une URI qui ouvre le client cartographique pour un trajet en taxi entre une origine et une destination.
  • maps_schema_personal_map : Construit une URI qui affiche les lieux de l'itinéraire dans l'ordre de voyage dans le client cartographique.
  • Sélectionnez l'outil appelable en direct le plus étroit qui répond directement à la demande. Suivez l'interface appelable en direct pour les entrées, sorties et erreurs actuelles.

Workflow

  1. Identifiez l'entité ou la ressource pertinente, l'identifiant, le périmètre, la plage de dates ou d'heures, les filtres et le résultat demandé.
  2. Classez la demande comme une recherche, une récupération, une analyse, une création, une mise à jour, une exportation, une suppression, un envoi, un achat, un changement de permission ou une autre opération du fournisseur avant de l'acheminer.
  3. Résolvez les identifiants ambigus par une recherche en direct lorsque cela est disponible ; ne devinez jamais un code, un ID, un chemin, une coordonnée, un enregistrement, une commande ou un compte.
  4. Transmettez uniquement les arguments pris en charge et conservez la pagination, le statut, les unités, les horodatages et les identifiants renvoyés par le fournisseur.
  5. Enchaînez les opérations uniquement lorsqu'un identifiant, un statut ou un résultat structuré renvoyé est requis par l'opération suivante.
  6. Inspectez l'erreur MCP externe et le statut du fournisseur avant de lire les champs de résultat. Ne traitez pas une réponse vide ou partielle comme un succès sans signaler son périmètre.

Directives de requête

  • Ne demandez que les entrées manquantes nécessaires pour choisir ou exécuter l'opération en toute sécurité.
  • Préservez le périmètre demandé par l'utilisateur et normalisez les noms, dates, identifiants ou formats uniquement lorsque le mappage est sans ambiguïté ; indiquez toute normalisation.
  • Gardez les entités, fenêtres temporelles, comptes et écritures non liés séparés.
  • Indiquez les filtres, la limite de page ou de résultats, l'ordre de tri, le format de sortie et la date des données lorsqu'ils sont disponibles.
  • Ajoutez uniquement le contexte spécifique au fournisseur requis et les limites de confirmation étayées par des preuves.

Gestion des échecs

  • Si aucun outil Amap Maps appelable en direct n'est présent, arrêtez l'exécution MCP et signalez que le connecteur n'est pas disponible dans le runtime actuel.
  • Pour les erreurs d'autorisation, de quota, de délai d'attente, d'argument invalide, de permission, de fournisseur ou d'outil manquant, signalez l'opération ayant échoué sans exposer les secrets.
  • Réessayez au maximum une fois seulement après une correction sûre telle qu'un rétrécissement du périmètre, la fourniture d'un identifiant connu, la réduction de la taille de la page ou la suppression d'un champ facultatif non pris en charge.
  • Pour les résultats vides ou partiels, signalez le périmètre exact de la requête et le statut du fournisseur ; ne comblez pas les champs manquants à partir de la mémoire ou d'une autre source.
  • Si l'utilisateur demande spécifiquement ce connecteur, ne le remplacez pas silencieusement par un autre. Indiquez d'abord l'échec du connecteur et proposez un repli clairement étiqueté uniquement si l'utilisateur le souhaite.

Contrat de résultat

  • Séparez les faits renvoyés par le fournisseur de l'interprétation et des calculs dérivés du modèle.
  • Préservez les identifiants, URL, chemins, dates, horodatages, unités, filtres, périmètre de page, totaux, statut et avertissements du fournisseur lorsqu'ils sont renvoyés.
  • Ne décrivez pas une page, un échantillon ou un aperçu comme complet sauf si le fournisseur confirme la complétude.
  • Répétez uniquement l'avertissement spécifique au fournisseur le plus risqué lorsqu'il affecte matériellement le résultat.

Individual skills in this repo

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

Skills associés