RéférenceOutils MCPrecall_cloud_skill

Tool Reference

recall_cloud_skill

Découvrez les Cloud Skills, chargez un manifeste racine ou récupérez une ressource à partir d'une révision explicitement épinglée.

Ne charger que la couche nécessaire

Commencez par une recherche Level 0 avec query lorsque le slug n'est pas encore connu, puis chargez le manifeste racine Level 1 ou épinglez une révision pour la ressource Level 2 dont vous avez besoin.

Outil MCP public

recall_cloud_skill

Objectif

Lire les métadonnées et ressources de Cloud Skill selon un modèle progressif à 3 niveaux : découverte Level 0, manifeste racine Level 1 et ressource de révision épinglée Level 2.

Quand l'utiliser

  • Découvrir les compétences disponibles par une requête en langage naturel lorsque vous ne connaissez pas encore le slug exact.
  • Charger le manifeste racine d'une compétence pour inspecter ses instructions, sa révision actuelle et ses composants déclarés.
  • Récupérer le contenu d'un composant de ressource spécifique pour une révision immuable épinglée avant exécution.

Quand NE PAS l'utiliser

  • Ne l'utilisez pas pour exécuter un composant de script ; utilisez execute_cloud_skill une fois la révision et le composant inspectés.
  • Ne l'utilisez pas pour créer ou mettre à jour des compétences ; utilisez save_cloud_skill pour produire la révision suivante.
  • N'omettez pas revision_id pour la récupération de ressources Level 2 ; la lecture de ressources requiert un épinglage strict de révision.
  • Ne demandez pas de ressources de compétences non publiées ou archivées ; l'outil n'expose que les compétences actives autorisées.

Périmètre requis

  • memory:read est requis sur la surface MCP.
  • La compétence doit être résolue dans le périmètre personnel ou d'équipe de l'appelant authentifié ; les compétences d'équipe requièrent l'appartenance à l'équipe.

Paramètres

NomTypeDescription
querystring · par défaut : emptyTexte de découverte Level 0 ; utilisé lorsque skill_id et slug sont vides.
skill_idstring · par défaut : emptyIdentifiant stable de Cloud Skill pour le rappel de racine ou de ressource.
slugstring · par défaut : emptyIdentifiant lisible de compétence pour le rappel de racine ou de ressource.
revision_idstring · par défaut : emptyÉpinglage facultatif de la révision racine ; requis pour le rappel de ressource Level 2.
resourcestring · par défaut : emptyChemin logique ou ID du composant pour le rappel Level 2.

Schéma de retour

Une enveloppe JSON CloudSkillResponseEnvelope avec object='cloud_skill', schema_version='xmemo.cloud_skill.v1', render_status, avertissements et data contenant la liste de découverte Level 0, le manifeste de compétence racine Level 1 ou la ressource de révision typée Level 2.

Exemples

Découvrir une compétence publiée
recall_cloud_skill({ query: "deployment verification" })
Charger une ressource de script épinglée
recall_cloud_skill({
  slug: "deployment-procedure",
  revision_id: "revision-id-from-root-recall",
  resource: "scripts/check.py"
})

Erreurs

  • Échec d'autorisation : le jeton MCP ne dispose pas de memory:read ou l'appelant ne peut pas lire le périmètre personnel/équipe résolu.
  • SKILL_NOT_FOUND : la compétence demandée n'existe pas dans le périmètre de l'appelant ou a été archivée.
  • REVISION_NOT_FOUND : le revision_id demandé n'appartient pas à la compétence ou n'existe pas.
  • RESOURCE_NOT_FOUND : le chemin logique ou l'ID de ressource demandé n'existe pas dans la révision épinglée.
  • Échec de validation : les identifiants sont manquants, la longueur de la requête dépasse les limites, ou la récupération de ressources omet revision_id.
  • save_cloud_skill — Créer la compétence durable ou publier sa prochaine révision.
  • execute_cloud_skill — Exécuter un composant de script rappelé via le bac à sable (sandbox).
  • recall_context — Utiliser la récupération de contexte de mémoire lorsque la cible est la mémoire d'agent plutôt qu'une ressource Cloud Skill.

Source : Cloud Skills