recipe_publish

macOS

Zweck

Reicht eines IHRER gespeicherten Rezepte/Skills zur Prüfung durch Dario in die Community-Moderationswarteschlange ein; das veröffentlicht es NICHT. Ohne confirm=true zeigt es eine VORSCHAU von Titel, Kategorie, Apps und Ablaufbeschreibung, die gesendet würden (nichts verlässt diesen Mac); mit confirm=true reicht es sie ein und liefert {status:"submitted", pending:true}. Nach der Freigabe erscheint es unter /community/skills, und jeder kann es mit recipe_install installieren. `workflow` ist die öffentliche Beschreibung: Standardmäßig wird das Feld `description` des Rezepts verwendet, wenn es mindestens 15 Zeichen hat; andernfalls geben Sie sie ausdrücklich an.

Erforderliche Eingaben

• name

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.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "properties": {
    "apps": {
      "description": "Free-text apps the recipe touches (e.g. \"Mail, Calendar\"), shown in the moderation queue.",
      "type": "string"
    },
    "category": {
      "description": "Free-text category shown in the moderation queue and, once approved, on /community/skills.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually submit. Without it, returns a preview — nothing is sent.",
      "type": "boolean"
    },
    "name": {
      "description": "Name of the saved recipe/skill to publish (see recipe_list).",
      "type": "string"
    },
    "title": {
      "description": "Shown once approved on /community/skills. Defaults to the recipe's own name.",
      "type": "string"
    },
    "workflow": {
      "description": "The public write-up of what the recipe does. Defaults to the recipe's own `description` if it's at least 15 characters; required otherwise.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für recipe_publish. 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"
}