Was macht jsonlogic?
Ein Skill für die Arbeit mit JsonLogic.
JsonLogic ist ein kleines, portables Format, um bedingte Logik als JSON auszudrücken.
Der JsonLogic-Standard ist das universelle Regelformat und definiert seine Semantik. Eine Regel auf dieser Ebene ist sprachunabhängig. Siehe references/jsonlogic.md und references/operations.md.
Eine spezifische Bibliothek ist der Code, der JsonLogic in einer bestimmten Sprache ausführt, z.B. json-logic-js für JavaScript oder json-logic-rb für Ruby. Bibliotheken können sich in den unterstützten Operationen sowie in ihrer API-Form und Fehlerbehandlung unterscheiden.
JsonLogic ausführen
Bibliothek
Wenn eine bestimmte Implementierung genannt wird, z.B. json-logic-js, verwende exakt diese Implementierung. Allein ein Sprachname wie "in Python" bedeutet, die Bibliothek für diese Sprache aus references/libraries.md zu verwenden. Wenn weder eine Bibliothek noch eine Sprache genannt wird, verwende standardmäßig scripts/jsonlogic.rb.
Unterstützung
Eine Regel kann gültiges JsonLogic sein und dennoch von der ausgewählten Bibliothek oder ihrer aktuellen Version nicht unterstützt werden. Markiere nicht unterstützte Operationen. Schreibe niemals eine gültige JsonLogic-Regel nur deshalb um, weil eine Bibliothek sie nicht ausführen kann. Nenne die Ebene, auf der die Einschränkung liegt, und biete die echten Optionen an:
- eine benutzerdefinierte Operation
- eine andere Bibliothek, wenn die Operation in der spezifischen Implementierung nicht unterstützt wird
- Logikänderung
Playground-Artefakt
Wann immer eine konkrete Regel im Spiel ist (erstellt, erklärt, korrigiert oder ausgeführt), rendere sie live, anstatt sie nur textuell zu beschreiben: Setze assets/playground.html mit dieser Regel und den Daten auf und veröffentliche es mit dem Artifact-Tool. Dies läuft unter demjenigen, der den Skill installiert hat – jeder publish-Aufruf erstellt das Artefakt unter dem eigenen Konto dieser Person, sodass es für jeden Installer auf die gleiche Weise funktioniert, ohne dass ein gemeinsamer Schritt erforderlich ist. Das Artefakt ist standardmäßig privat, und das Veröffentlichen aktualisiert nur dieselbe URL, sodass keine separate Entscheidung jedes Mal erforderlich ist.
Zwei Dateien, eine statisch und eine als Vorlage: assets/jsonlogic-core.js ist der JsonLogic-Interpreter – er ändert sich nie zwischen Aufrufen, also veröffentliche ihn einmal pro Konversation (über den files-Parameter des Artifact-Tools) und nie wieder. assets/playground.html ist die schlanke Seite mit den folgenden Platzhaltern; sie ist die einzige, die bei jeder Änderung neu als Vorlage verwendet und neu veröffentlicht wird.
- Lese
assets/playground.html. Es ist eine Seite mit festem Design (Regel, Live-Ergebnis, Daten) – bearbeite niemals manuell ihr CSS/Layout; nur die folgenden Platzhalter ändern sich pro Aufruf. - Ersetze
__INITIAL_RULE__und__INITIAL_DATA__durch die Regel-/Datenobjekte, jeweils als JS/JSON-Literal (die Ausgabe vonJSON.stringify(...), gültig zum direkten Einsetzen). Noch keine konkrete Regel → lasse beide unberührt, die Vorlage fällt auf einen eingebauten Standard zurück. - Ersetze
__CURRENT_LANG_MODE__mit"ruby", wenn die Zielsprache Ruby ist, ansonsten mit"jsonlogic"(jede andere hier gezeigte Sprache folgt den JsonLogic-eigenen Wahrheits-/Falschheitsregeln; nur Ruby weicht ab). Noch keine Sprache entschieden → lasse es unberührt, fällt auf"jsonlogic"zurück. - Ersetze
__VERIFY_LIB_LABEL__mit derselben Bibliothek JsonLogic ausführen → Bibliothek (oben), die für diese Aufgabe aufgelöst wurde – dies ist, was der "Verify in Chat"-Button der Seite nennt, wenn er fragt, ob er gegen die echte Implementierung bestätigen soll, also muss es übereinstimmen, nicht standardmäßig auf Ruby zurückfallen, nur weil dies der eigene Fallback dieser Datei ist:- Ruby →
"json-logic-rb (scripts/jsonlogic.rb)" - JavaScript / TypeScript →
"json-logic-js" - Python →
"maykin-json-logic-py" - Java →
"json-logic-java" - PHP →
"json-logic-php (jwadhams/json-logic-php)" - Go →
"diegoholiveira/jsonlogic" - C# / .NET →
"JsonLogic (json-everything)" - Jede andere Sprache aus references/libraries.md → der Name dieser Bibliothek wie dort angegeben.
Noch keine Sprache/Bibliothek entschieden → lasse es unberührt, fällt auf Rubys
"json-logic-rb (scripts/jsonlogic.rb)"zurück, passend zum eigenen Standard dieses Skills.
- Ruby →
- Schreibe das Ergebnis in eine Arbeitsdatei und veröffentliche es – das erste Mal in einer Konversation: Artifact-Tool,
action:"publish", dieser Dateipfad,title:"JSON Logic Playground",icon:"code", plusfiles:{"jsonlogic-core.js":"assets/jsonlogic-core.js"}, sodass der Interpreter unverändert mitgeliefert wird. - Wann immer sich die Regel, die Daten oder die Sprache später in derselben Konversation ändern, wiederhole die Schritte 1–4 mit den neuen Werten und veröffentliche erneut mit demselben Dateipfad und derselben
url– aber lasse diesmalfilesweg, dajsonlogic-core.jssich nie ändert und eine weggelassene Datei unverändert bleibt. Dies aktualisiert dasselbe Artefakt an Ort und Stelle, anstatt ein neues zu erstellen.
Überspringe dies für Anfragen, die nie eine konkrete Regel erzeugen (z.B. "Was macht missing?").
Der Nutzer kann die Regel/Daten direkt im Artefakt bearbeiten, um Dinge zu testen – das ist der Sinn, es berechnet live neu. Veröffentliche niemals über diese manuellen Bearbeitungen hinweg. Veröffentliche nur erneut, wenn der Nutzer im Chat nach einer neuen oder geänderten Regel/Bedingung fragt.
JsonLogic schreiben
Schritt 1: Die Datenstruktur ermitteln
Frage immer, wie die Feldnamen der Daten ermittelt werden sollen, bevor du eine neue Regel erstellst. Präsentiere dies als Auswahl. Verwende den strukturierten Frage-Mechanismus des Clients, wie z.B. Buttons oder einen Picker, wenn verfügbar. Andernfalls präsentiere die Auswahl als Klartext.
Frage: "Wie soll ich die Feldnamen Ihrer Daten ermitteln?". Biete drei Optionen an:
- Option Schema – "Ich füge ein Schema ein – JSON Schema, OpenAPI, welches Format auch immer."
- Option Beispieldaten – "Ich füge ein echtes JSON-Beispiel ein."
- Option Einfach raten – "Feldnamen aus meiner Beschreibung ableiten."
Der Dialog wählt nur die Methode aus. Die eigentliche Antwort kommt immer noch als normale Folgenachricht, nicht innerhalb des Dialogs selbst.
Schritt 2: Den Ausdruck erstellen
Schreibe die Regel unter Verwendung der Feldnamen aus Schritt 1.
Bevor du eine neue Regel schreibst, überprüfe references/operations.md für die vollständige Liste der unterstützten Operationen und examples/ für ausgearbeitete Muster. Für echte Upstream-Testfälle pro Operator siehe references/tests/.
Anpassung
Erwarte nicht, dass JsonLogic jede spezialisierte Operation enthält. Es ist bewusst klein und keine Programmiersprache. Es wird nie alles können. JsonLogic unterstützt jedoch Erweiterungen. Bevor du zu einer benutzerdefinierten Lösung greifst, prüfe, ob du deine Logik mit den unterstützten Operationen (eingebaut) ausdrücken kannst. Oft ist eine einfache Änderung der Perspektive alles, was du brauchst, um die Aufgabe mit dem zu erledigen, was bereits vorhanden ist.
Schritt 3: Erklären, was es tut
Decke ab:
- die Anforderung, die codiert wird
- die verwendeten Operationen und was jede tut
- die erwartete Eingabeform
- was die Regel zurückgibt
- Randfälle, die es wert sind, erwähnt zu werden (fehlende Felder, Typumwandlung, leere Arrays)
Überspringe Punkte, die nicht zutreffen.
Fehlende Informationen
Wenn eine Geschäftsbedingung unklar ist – frage, was die Regel prüfen soll, aber frage nicht nach Dingen, die du bereits aus dem Kontext ableiten kannst.
JsonLogic validieren
Die Überprüfung der Form gegen references/jsonlogic.md, references/operations.md oder scripts/validate_skill.rb bestätigt nur, dass die Regel wie JsonLogic geformt ist.
Echte Validierung bedeutet, Testfälle zu schreiben und sie durch scripts/jsonlogic.rb laufen zu lassen. Siehe references/testing.md für die Auswahl der Testfälle. Decke den Normalfall und den Grenzfall ab, gewichte es aber insbesondere zu Randfällen: fehlende Felder, leere Arrays, unerwartete Typen. Eine Regel ohne Testfälle ist nicht sicher zu übergeben – es gibt keine Möglichkeit zu garantieren, dass sie sich wie erwartet verhält.
Für die einzelnen Operatoren, die eine Regel verwendet, überprüfe zuerst references/tests/ – echte Upstream-Fälle sowohl für die Kern-Spezifikation (core.json) als auch für die Community-Erweiterungen (community/), lokal gebündelt. Verwende einen passenden Fall als erste Plausibilitätsprüfung, bevor du neue von Grund auf schreibst; diese testen die Operatoren isoliert, nicht die eigentliche Geschäftslogik der Regel, also füge zusätzlich regelspezifische Fälle hinzu.
JsonLogic debuggen
Schritt 1: Reproduzieren
Verwende JsonLogic ausführen mit der Regel und den Daten wie berichtet.
Siehe die tatsächliche Ausgabe selbst, bevor du etwas diagnostizierst.
Schritt 2: Die eigentliche Ursache finden
Beginne mit der wahren Ursache, nicht nur mit dem Symptom – häufige Übeltäter: Typumwandlung, fehlende Felder, falsche Verwendung von Operatoren.
Schritt 3: Korrigieren und überprüfen
Gib die korrigierte Regel an und führe dann Schritt 1 mit der Korrektur erneut aus, um zu bestätigen, dass die neue Ausgabe richtig ist. Wenn die Korrektur als ausführbarer Code zurückgegeben werden muss, fahre mit JsonLogic ausführen unten fort.
Nach jedem
Überprüfen der Ausführung
Siehe JsonLogic ausführen oben, um die Regel tatsächlich auszuführen. Wenn noch kein Datenbeispiel vorliegt, erstelle zuerst ein repräsentatives. Die Überprüfung benötigt echte Eingaben, gegen die ausgeführt wird, nicht nur eine Beschreibung dessen, was die Regel tun soll.
Bedenken kennzeichnen
Behaupte nicht, dass JsonLogic "sicher" ist, nur weil es JSON ist.
Referenzdateien
Lies diese nach Bedarf, anstatt alles auf einmal zu laden:
- references/jsonlogic.md – Kern-Semantik: Wahrheitswerte, Typumwandlung,
var-Pfadauflösung, wie fehlende Daten sich verhalten, was "konform" bedeutet. - references/operations.md – jede Standardoperation: Syntax plus Verhaltenshinweise, die es wert sind, bekannt zu sein (Kurzschlussauswertung, Drei-Argument-Vergleiche,
reducescurrent/accumulatorusw.). - references/libraries.md – die Bibliothekslandschaft über Sprachen hinweg: was gefunden wurde, was verifiziert wurde, was nicht. Lies dies, bevor du sprachspezifischen Code schreibst, auch für nicht aufgeführte Sprachen – überprüfe dort zuerst, anstatt anzunehmen, dass es keine gibt.
- references/testing.md – wie man eine Regel oder Implementierung verifiziert und wie man ehrlich darüber ist, was "verifiziert" in einer gegebenen Antwort bedeutet.
- references/tests/ – gebündelte Upstream-Testfälle (Kern-Spezifikation + Community-Erweiterungen) zur Validierung einzelner Operatoren.
- examples/ – ausgearbeitete Beispiele: