Saltar al contenido
Todas las herramientas

recipe_install

Skills y recetas · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Instala una SKILL de la comunidad por id (de recipe_discover) en este Mac para que recipe_run pueda usarla. Instalar solo almacena la skill. Al ejecutarla pide una confirmación cuando tiene pasos que cambian el estado (send/write/delete), y un paso no puede confirmarse a sí mismo: `confirm` en los argumentos de un paso se elimina aquí (confirm_removed_steps) y se ignora al ejecutar, de modo que un paso cuya herramienta pide confirmación responde con su vista previa en lugar de ejecutarse. Si ya existe una skill con el mismo nombre, se guarda con un nombre que no colisione. La primera llamada muestra una vista previa; confirm: true la descarga y la guarda. Devuelve {name, installed}.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para recipe_install. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows

Propósito

Instala una SKILL de la comunidad por id (de recipe_discover) en este equipo para que recipe_run pueda usarla. Es segura: instalar solo almacena la skill; un paso no puede confirmarse a sí mismo, así que cuando luego se ejecute, un paso cuya herramienta pide confirmación (para enviar, eliminar, reemplazar un archivo o ejecutar un comando) devuelve su vista previa y no cambia nada. Si ya existe una skill con el mismo nombre, se guarda con un nombre que no colisione. La primera llamada devuelve una vista previa que nombra los pasos de la skill y no guarda nada; confirm=true la guarda. Devuelve {name, imported}.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para recipe_install. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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