Zum Inhalt springen
Alle Werkzeuge

recipe_run

Skills und Rezepte · macOS · Windows

Wirkung: Ausführen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Führt ein Rezept von Anfang bis Ende aus: bindet Parameter, führt das Tool jedes Schritts der Reihe nach über die Registry aus, speichert den Lauf (siehe recipe_runs) und gibt das Ergebnis jedes Schritts sowie gegebenenfalls markers_path zurück. Rezepte mit zustandsändernden Schritten (schreiben/senden/löschen) zeigen zuerst eine VORSCHAU – rufen Sie erneut mit confirm:true auf, um auszuführen; reine Leserezepte laufen sofort. Diese Bestätigung startet den Lauf und sonst nichts: Ein Schritt kann sich nicht selbst bestätigen. `confirm` in den Argumenten eines Schritts wird ignoriert (die Vorschau und der Laufbericht markieren diesen Schritt als confirm_ignored), sodass ein Schritt, dessen Tool eine eigene Bestätigung verlangt, mit seiner Vorschau antwortet und NICHT ausgeführt wird (der Laufbericht markiert ihn als previewed und listet ihn in previewed_steps auf) – führen Sie dieses Tool direkt aus, um es auszuführen. Ein Schritt, der mit einem Fehler endet (ein Fehler in seiner Antwort oder eine Ablehnung), stoppt den Lauf und wird gemeldet (stopped_at, mit dem error_key des Schritts); ein Schritt, dessen Tool dieser Mac nicht in tools/list anbietet, wird abgelehnt (tool_not_advertised). Beides stoppt den Lauf, es sei denn, dieser Schritt ist mit "optional": true markiert – dann wird der Fehler in seinem Ergebnis und in skipped_optional festgehalten und der Lauf geht weiter.

Erforderliche Eingaben

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Kanonisches technisches Schema auf Englisch — macOS
{
  "properties": {
    "confirm": {
      "description": "Set true to execute a recipe that has state-changing steps; read-only recipes ignore it.",
      "type": "boolean"
    },
    "name": {
      "description": "Name of the saved skill (recipe) to run, exactly as recipe_list reports it.",
      "type": "string"
    },
    "params": {
      "description": "Param overrides (merged over the recipe defaults).",
      "type": "object"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für recipe_run. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "confirm": false,
  "name": "Demo morning brief"
}

Windows

Zweck

Führt ein gespeichertes Rezept von Anfang bis Ende aus: bindet Parameter, führt das Tool jedes Schritts der Reihe nach aus, zeichnet den Lauf auf (siehe recipe_runs) und gibt das Ergebnis jedes Schritts zurück. Bestätigungssperre: Ohne confirm:true gibt es eine DRY-RUN-VORSCHAU der geordneten Schritte mit ihren gebundenen Argumenten zurück; rufen Sie erneut mit confirm:true auf, um auszuführen. Ein Schritt, der mit einem Fehler endet, stoppt den Lauf und wird gemeldet (stopped_at), es sei denn, dieser Schritt ist mit "optional": true markiert – dann wird der Fehler in seinem Ergebnis und in skipped_optional festgehalten und der Lauf geht weiter. Ein Schritt kann sich nicht selbst bestätigen: confirm in den Argumenten eines Schritts wird ignoriert (der Schritt meldet confirm_ignored), sodass ein Schritt, dessen Tool eine Bestätigung verlangt (senden, löschen, eine Datei ersetzen, einen Befehl ausführen), die Vorschau dieses Tools zurückgibt und nichts ändert; um die Änderung vorzunehmen, rufen Sie dieses Tool direkt auf, nachdem der Benutzer zugestimmt hat.

Erforderliche Eingaben

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für recipe_run. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "confirm": false,
  "name": "Demo morning brief"
}