Todas las herramientas

recipe_save

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

Guarda un SKILL reutilizable, una receta con nombre (`name`) (una secuencia ordenada de llamadas a la herramienta LMCP con parámetros), en esta Mac para que el usuario pueda volver a ejecutarla en cualquier momento con recipe_run. Un usuario guardaría uno para convertir un flujo de trabajo LMCP de varios pasos que repite (un resumen matutino, clasificación de la bandeja de entrada, un informe semanal, extracción de datos) en un único comando reutilizable. Las habilidades guardadas se pueden compartir con otras personas a través de recipe_export. El manifiesto (`manifest`) debe tener un nombre y una matriz de pasos que no esté vacía. Devuelve `{name}`.

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 no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — macOS
{
  "properties": {
    "manifest": {
      "description": "The recipe manifest. Shape: {\"name\": string (required), \"description\": string, \"params\": [{\"name\": string, \"type\": \"string\"|\"int\"|\"bool\", \"default\": any}], \"steps\": [ ... ] (required, non-empty), \"outputs\": [{\"kind\": string}]}. A step is EITHER a tool call {\"tool\": <tool_name>, \"args\": {...}} OR a pause {\"wait\": {\"seconds\": N}} (also {\"wait\": N}). Any arg string may interpolate a declared param with ${name} (e.g. \"limit\": \"${count}\"); an arg that is exactly \"${name}\" keeps the param's type. Steps run in order; a later step can consume an EARLIER step's output with \"${steps[N].result.KEY}\" (0-based; supports .key and [i], e.g. \"account\": \"${steps[0].result.accounts[0].name}\"). On recipe_run a state-changing step previews first unless confirm:true.",
      "type": "object"
    }
  },
  "required": [
    "manifest"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para recipe_save. 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.

{
  "manifest": {
    "description": "Read the local date and time.",
    "name": "Demo morning brief",
    "steps": [
      {
        "args": {},
        "tool": "get_datetime"
      }
    ]
  }
}

Windows

Propósito

Guarda un SKILL reutilizable, una receta con nombre (una secuencia ordenada de llamadas a herramientas LMCP con parámetros), en esta máquina para que el usuario pueda volver a ejecutarla en cualquier momento con recipe_run. Un usuario guardaría uno para convertir un flujo de trabajo LMCP de varios pasos que repite (un resumen matutino, clasificación de la bandeja de entrada, un informe semanal, extracción de datos) en un único comando reutilizable. El manifiesto (`manifest`) debe tener un nombre y una matriz de pasos que no esté vacía. Una cadena de argumentos puede interpolar un parámetro declarado con ${name}; un argumento que es exactamente "${name}" mantiene el tipo de parámetro. Un paso posterior puede consumir el resultado de un paso anterior con "${steps[N].result.KEY}" (basado en 0; admite.key y [i]). Devuelve `{name, step_count}`.

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 no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — Windows
{
  "properties": {
    "manifest": {
      "description": "The recipe manifest. Shape: {\"name\": string (required), \"description\": string, \"schema_version\": int, \"params\": [{\"name\": string, \"type\": string, \"default\": any}], \"steps\": [{\"tool\": string, \"args\": object}] (required, non-empty)}.",
      "type": "object"
    }
  },
  "required": [
    "manifest"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para recipe_save. 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.

{
  "manifest": {
    "description": "Read the local date and time.",
    "name": "Demo morning brief",
    "steps": [
      {
        "args": {},
        "tool": "get_datetime"
      }
    ]
  }
}