Todas as ferramentas

recipe_save

Skills e receitas · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Salva um SKILL reutilizável — uma receita nomeada (uma sequência ordenada de chamadas de ferramenta LMCP com parâmetros) — neste Mac para que o usuário possa executá-lo novamente a qualquer momento com recipe_run. Um usuário salvaria um para transformar um fluxo de trabalho LMCP de várias etapas que ele repete (um resumo matinal, triagem de caixa de entrada, um relatório semanal, uma extração de dados) em um único comando reutilizável. As habilidades salvas podem ser compartilhadas com outras pessoas via recipe_export. O manifesto deve ter um nome e uma matriz de etapas não vazia. Retorna {name}.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para recipe_save. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Salva um SKILL reutilizável — uma receita nomeada (uma sequência ordenada de chamadas de ferramenta LMCP com parâmetros) — nesta máquina para que o usuário possa executá-la novamente a qualquer momento com recipe_run. Um usuário salvaria um para transformar um fluxo de trabalho LMCP de várias etapas que ele repete (um resumo matinal, triagem de caixa de entrada, um relatório semanal, uma extração de dados) em um único comando reutilizável. O manifesto deve ter um nome e uma matriz de etapas não vazia. Uma string arg pode interpolar um parâmetro declarado com ${name}; um argumento que seja exatamente "${name}" mantém o tipo do parâmetro. Uma etapa posterior pode consumir a saída de uma etapa anterior com "${steps[N].result.KEY}" (baseado em 0; suporta .key e [i]). Retorna {name,step_count}.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para recipe_save. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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