Todas las herramientas

recipe_run

Skills y recetas · macOS · Windows

Efecto: ejecución. 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

Ejecuta una receta de principio a fin: vincula los parámetros (`params`), ejecuta la herramienta de cada paso en orden mediante el registro de herramientas, persiste la ejecución (consulte recipe_runs) y devuelve el resultado de cada paso más cualquier markers_path. Las recetas con pasos que cambian el estado (escribir/enviar/eliminar) VISTA PREVIA primero: llame nuevamente con confirm:true para ejecutar; las recetas de sólo lectura se ejecutan inmediatamente. Un error en cualquier paso detiene la ejecución y se informa.

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": "Set true to execute a recipe that has state-changing steps; read-only recipes ignore it.",
      "type": "boolean"
    },
    "name": {
      "type": "string"
    },
    "params": {
      "description": "Param overrides (merged over the recipe defaults).",
      "type": "object"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para recipe_run. 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,
  "name": "Demo morning brief"
}

Windows

Propósito

Ejecuta una receta guardada de principio a fin: vincula los parámetros (`params`), ejecuta la herramienta de cada paso en orden, registra la ejecución (consulte recipe_runs) y devuelve el resultado de cada paso. Puerta de confirmación: sin confirm:true devuelve un DRY-RUN (vista previa sin ejecución) de los pasos ordenados con sus argumentos enlazados; llame nuevamente con confirm:true para ejecutar. Un error en cualquier paso detiene la ejecución y se informa.

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": "Set true to execute; without it a dry-run preview is returned.",
      "type": "boolean"
    },
    "name": {
      "description": "Recipe name (from recipe_list).",
      "type": "string"
    },
    "params": {
      "description": "Param overrides (merged over the recipe defaults).",
      "type": "object"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para recipe_run. 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,
  "name": "Demo morning brief"
}