recipe_install

Skills et recettes · macOS · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Installe une COMPÉTENCE (SKILL) communautaire par id (issu de recipe_discover) sur ce Mac pour que recipe_run puisse l’utiliser. L’installation ne fait que stocker la compétence. L’exécuter demande une confirmation lorsqu’elle comporte des étapes qui modifient l’état (envoi/écriture/suppression), et une étape ne peut pas se confirmer elle-même : `confirm` dans les args d’une étape est retiré ici (confirm_removed_steps) et ignoré à l’exécution, de sorte qu’une étape dont l’outil demande une confirmation répond par son aperçu au lieu de s’exécuter. Si une compétence du même nom existe déjà, elle est enregistrée sous un nom sans conflit. Le premier appel affiche un aperçu ; confirm: true la télécharge et l’enregistre. Renvoie {name, installed}.

Entrées requises

id

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to download and save the skill. Without it the call returns a preview and contacts nothing.",
      "type": "boolean"
    },
    "id": {
      "description": "The community skill id from recipe_discover.",
      "type": "integer"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour recipe_install. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "confirm": false,
  "id": 101
}

Windows

Objectif

Installe une COMPÉTENCE (SKILL) communautaire par id (issu de recipe_discover) sur cette machine pour que recipe_run puisse l’utiliser. Sans risque : l’installation ne fait que stocker la compétence ; une étape ne peut pas se confirmer elle-même, donc lors de son exécution ultérieure, une étape dont l’outil demande une confirmation (pour envoyer, supprimer, remplacer un fichier, exécuter une commande) renvoie son aperçu et ne change rien. Si une compétence du même nom existe déjà, elle est enregistrée sous un nom sans conflit. Le premier appel renvoie un aperçu indiquant les étapes de la compétence et n’enregistre rien ; confirm=true l’enregistre. Renvoie {name, imported}.

Entrées requises

id

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to save the skill. Without it, returns a preview naming its steps.",
      "type": "boolean"
    },
    "id": {
      "description": "The community skill id from recipe_discover.",
      "type": "integer"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Exemple documentaire

{
  "confirm": false,
  "id": 101
}