Communitygithub.com

jsonlogic

Arbeitet mit JsonLogic-Geschäftsregeln — dem JSON-basierten Format für bedingte Logik von jsonlogic.com. Verwende dies, wenn der Nutzer eine Geschäftsanforderung in eine JsonLogic-Regel umwandeln möchte, eine vorhandene JsonLogic-Erklärung benötigt, debuggt werden soll, fragt, ob eine Regel gültig ist, JsonLogic in einer bestimmten Sprache ausführen möchte, eine JsonLogic-Bibliothek auswählt oder vergleicht oder JsonLogic in eine Anwendung integriert. Wird bei Erwähnungen von JsonLogic, json-logic, JSON-Regelobjekten wie {"var": ...} oder bei Anfragen zur Darstellung von Bedingungen und Geschäftsregeln als portables JSON ausgelöst.

Was ist jsonlogic?

Diese Fertigkeit (Skill) ermöglicht es KI-Agenten, umfassend mit JsonLogic zu arbeiten – einem standardisierten, JSON-basierten Format zur Darstellung von Geschäftslogik. Sie unterstützt Agenten dabei, JsonLogic-Regeln zu erstellen, zu erklären, zu debuggen und auszuführen. Die Fertigkeit ist plattformunabhängig (Claude Code, Cursor, Codex etc.) und bietet eine strukturierte Vorgehensweise: Zuerst wird die Datenstruktur ermittelt, dann die Regel gebaut, erläutert und anschließend validiert. Ein besonderes Feature ist der interaktive "Playground" – ein HTML-Artifact, das die aktuelle Regel und Beispiel-Daten visualisiert und live ausführt. Die Fertigkeit verweist auf umfangreiche Referenzmaterialien (Operationen, Bibliotheken, Tests) und stellt sicher, dass Regeln valide und getestet sind, bevor sie übergeben werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/valeryia-piatrova/jsonlogic-skill/tree/main

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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.

  1. 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.
  2. Ersetze __INITIAL_RULE__ und __INITIAL_DATA__ durch die Regel-/Datenobjekte, jeweils als JS/JSON-Literal (die Ausgabe von JSON.stringify(...), gültig zum direkten Einsetzen). Noch keine konkrete Regel → lasse beide unberührt, die Vorlage fällt auf einen eingebauten Standard zurück.
  3. 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.
  4. 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.
  5. 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", plus files:{"jsonlogic-core.js":"assets/jsonlogic-core.js"}, sodass der Interpreter unverändert mitgeliefert wird.
  6. 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 diesmal files weg, da jsonlogic-core.js sich 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, reduces current/accumulator usw.).
  • 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:

Verwandte Skills