Communitygithub.com

jsonlogic

JsonLogic ビジネスルール(JSON ベースの条件ロジック形式)を扱います。ルールの作成、説明、デバッグ、実行、ライブラリの選択/比較、アプリケーションへの統合を支援します。

jsonlogic とは?

JsonLogic スキルは、JsonLogic 形式(jsonlogic.com)で表現されたビジネスルールを扱うための専門ツールです。このスキルは、ユーザーがビジネス要件を JsonLogic ルールに変換する、既存の JsonLogic 式を説明・デバッグする、ルールの妥当性を確認する、JavaScript、TypeScript、Python、Ruby、Java、PHP、Go、C# などの特定言語で JsonLogic を実行する、ライブラリを選択・比較する、またはアプリケーションに統合する、といった様々なシナリオで活用できます。 主な機能は、(1) データ構造の定義に基づいた JsonLogic ルールの作成、(2) 作成したルールのインタラクティブなプレイグラウンドでの即時実行と検証、(3) テストケースを用いたルール妥当性の検証、(4) ルール実行結果のデバッグと修正、です。特に、ルールを作成・説明・修正・実行するたびに、そのルールとデータを埋め込んだプレイグラウンド(HTML アーティファクト)を自動生成し、ライブで結果を確認できる点が特徴です。このプレイグラウンドは、JsonLogic インタプリタ(jsonlogic-core.js)を含み、ルールやデータの変更に応じて更新されます。 このスキルは、Claude Code や Cursor などの AI エージェントプラットフォームで動作し、ユーザーが「JsonLogic」「json-logic」「{"var": ...}」といったキーワードや JSON ルールオブジェクトに言及した際、または条件やビジネスルールをポータブルな JSON として表現するよう要求した際に自動的に起動します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

jsonlogic は何をしますか?

JsonLogic を扱うスキルです。

JsonLogic は、条件ロジックを JSON として表現するための、小さくポータブルな形式です。

JsonLogic 標準は普遍的なルール形式であり、そのセマンティクスを定義します。このレベルのルールは言語非依存です。references/jsonlogic.md および references/operations.md を参照してください。

特定のライブラリとは、特定の言語で JsonLogic を実行するコードです。例えば、JavaScript 向けの json-logic-js や Ruby 向けの json-logic-rb などがあります。ライブラリによってサポートする演算、API の形状、エラーハンドリングが異なる場合があります。

JsonLogic の実行

ライブラリ

特定の実装(例:json-logic-js)が指定された場合は、その実装を正確に使用します。言語名のみ(例:「Python で」)が指定された場合は、references/libraries.md からその言語のライブラリを使用します。ライブラリも言語も指定されていない場合は、デフォルトで scripts/jsonlogic.rb を使用します。

サポート

ルールが有効な JsonLogic であっても、選択されたライブラリやそのバージョンでサポートされていない可能性があります。サポートされていない演算はフラグを立ててください。ライブラリが実行できないという理由だけで、有効な JsonLogic ルールを書き換えてはいけません。制限がどのレベルにあるかを示し、実際の選択肢を提示してください:

  • カスタム演算
  • 特定の実装で演算がサポートされていない場合の別のライブラリ
  • ロジックの変更

プレイグラウンドアーティファクト

具体的なルールが関係する場合(作成、説明、修正、実行)、それをテキストで説明するだけでなく、ライブで表示します。assets/playground.html にそのルールとデータをシードし、Artifact ツールで公開します。これはスキルをインストールしたアカウントで実行されます。公開のたびにそのアカウントのアーティファクトが作成されるため、共有手順なしで全てのインストーラに対して同じように機能します。アーティファクトはデフォルトでプライベートであり、ここでの公開は同じ URL を更新するだけなので、毎回個別に判断する必要はありません。

2 つのファイルがあり、1 つは静的、もう 1 つはテンプレートです。assets/jsonlogic-core.js は JsonLogic インタプリタで、呼び出し間で変更されません。そのため、会話ごとに一度だけ公開し(Artifact ツールの files パラメータ経由)、その後は再度公開しないでください。assets/playground.html は、以下のプレースホルダを持つ薄いページです。変更があるたびに再テンプレート化されて再公開されます。

  1. assets/playground.html を読み込みます。これは固定デザインのページ(ルール、ライブ結果、データ)です。CSS/レイアウトを手動で編集しないでください。呼び出しごとに変更されるのは以下のプレースホルダだけです。
  2. __INITIAL_RULE__ と __INITIAL_DATA__ を、それぞれルールとデータオブジェクトに置き換えます。これらは JS/JSON リテラル(JSON.stringify(...) の出力をそのまま挿入できるもの)にします。具体的なルールがまだない場合は、両方をそのままにしておきます。テンプレートは組み込みのデフォルトにフォールバックします。
  3. __CURRENT_LANG_MODE__ を、ターゲット言語が Ruby の場合は "ruby" に、それ以外の言語(ここに示されている他の全ての言語は JsonLogic 自身の truthy/falsy ルールに従います。Ruby だけが異なります。)の場合は "jsonlogic" に置き換えます。言語が決定していない場合は、そのままにしておきます。"jsonlogic" にフォールバックします。
  4. __VERIFY_LIB_LABEL__ を、上記の JsonLogic の実行 → ライブラリ でこのタスク用に解決されたものと同じライブラリに置き換えます。これはページの「チャットで確認」ボタンが実際の実装に対して確認を依頼する際に使用する名前であるため、このファイル自身のフォールバックが Ruby だからといってデフォルトの Ruby にせず、一致させる必要があります:
    • 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)"
    • references/libraries.md のその他の言語 → そこに記載されているライブラリ名。 言語/ライブラリがまだ決定していない場合は、そのままにしておきます。このスキルのデフォルトに合わせて、Ruby の "json-logic-rb (scripts/jsonlogic.rb)" にフォールバックします。
  5. 結果を作業ファイルに書き込み、公開します。会話の中で 最初 のとき:Artifact ツール、action:"publish"、そのファイルのパス、title:"JSON Logic Playground"、icon:"code"、さらに files:{"jsonlogic-core.js":"assets/jsonlogic-core.js"} を含め、インタプリタが変更されずに一緒に提供されるようにします。
  6. 同じ会話の中で後でルール、データ、言語が変更された場合は、ステップ 1~4 を新しい値で再度実行し、同じファイルパス と 同じ URL で再度公開します。ただし、今回は files は省略します。jsonlogic-core.js は決して変更されず、ファイルを省略してもそのまま保持されるためです。これにより、新しいアーティファクトを作成する代わりに、同じアーティファクトがその場で更新されます。

具体的なルールを生成しないリクエスト(例:「missing は何をするか」)については、これをスキップします。

ユーザーはアーティファクト内のルール/データを直接編集してテストできます。それが目的であり、ライブで再計算されます。手動編集を上書きして再公開しないでください。ユーザーがチャットで新しいルールや変更されたルール/条件を要求した場合にのみ再公開してください。

JsonLogic の作成

ステップ 1: データ構造を取得する

新しいルールを作成する前に、必ずデータのフィールド名を取得する方法を尋ねてください。これを選択肢として提示します。利用可能な場合は、クライアントの構造化質問メカニズム(ボタンやピッカーなど)を使用します。それ以外の場合は、選択肢をプレーンテキストで提示します。

質問:「データのフィールド名をどのように取得しますか?」。3 つのオプションを提供します:

  • オプション スキーマ — 「スキーマ(JSON Schema、OpenAPI、その他任意の形式)を貼り付けます。」
  • オプション サンプルデータ — 「実際の JSON サンプルを貼り付けます。」
  • オプション 推測する — 「説明からフィールド名を推測します。」

ダイアログは方法を選択するだけです。実際の回答は、ダイアログ内ではなく、通常のフォローアップメッセージとして送信されます。

ステップ 2: 式を作成する

ステップ 1 のフィールド名を使用してルールを記述します。

新しいルールを書く前に、references/operations.md でサポートされている全リストを確認し、examples/ でパターンの実例を確認してください。各演算子の実際の上流テストケースについては、references/tests/ を参照してください。

カスタマイズ

JsonLogic があらゆる特殊な演算を含むとは期待しないでください。意図的に小さく、プログラミング言語ではありません。全てを実行できるわけではありません。ただし、JsonLogic は拡張をサポートしています。カスタムソリューションに頼る前に、サポートされている演算(組み込み)を使用してロジックを表現できるかどうかを確認してください。多くの場合、視点を少し変えるだけで、既存のもので十分に目的を達成できます。

ステップ 3: 動作を説明する

以下の項目をカバーします:

  • エンコードされている要件
  • 使用されている演算とそれぞれの動作
  • 期待される入力構造
  • ルールが返すもの
  • フラグを立てる価値のあるエッジケース(フィールド欠落、型強制、空配列)

該当しない項目はスキップします。

情報不足

ビジネス条件が不明確な場合は、ルールが何をチェックすべきか尋ねる必要がありますが、コンテキストから既に解決できることについては尋ねないでください。

JsonLogic の検証

references/jsonlogic.md、references/operations.md、または scripts/validate_skill.rb に対して構造をチェックしても、ルールが JsonLogic のような形をしていることが確認できるだけです。

実際の検証とは、テストケースを作成し、scripts/jsonlogic.rb で実行することを意味します。テストケースの選び方については references/testing.md を参照してください。通常のケースと境界をカバーしますが、特にエッジケース(フィールド欠落、空配列、予期しない型)に重点を置きます。テストケースのないルールは引き渡しには安全ではありません — 期待通りに動作する保証がありません。

ルールが使用する個々の演算子については、まず references/tests/ を確認してください。コア仕様(core.json)とコミュニティ拡張(community/)の両方の実際の上流ケースがローカルにバンドルされています。新しいケースをゼロから作成する前に、一致するケースを健全性チェックとして再利用します。これらは演算子を単独でテストするものであり、ルールの実際のビジネスロジックをテストするものではないため、その上にルール固有のケースを追加してください。

JsonLogic のデバッグ

ステップ 1: 再現する

報告されたルールとデータを使用して JsonLogic の実行 を行います。診断する前に、実際の出力を自分で確認します。

ステップ 2: 実際の原因を見つける

症状ではなく、実際の原因から説明します。よくある原因:型強制、フィールド欠落、演算子の誤用。

ステップ 3: 修正して確認する

修正したルールを提示し、修正を適用してステップ 1 を再実行し、新しい出力が正しいことを確認します。修正を実行可能なコードとして引き渡す必要がある場合は、以下の JsonLogic の実行 に進みます。

任意の処理の後

実行の確認

上記の JsonLogic の実行 を参照して、実際にルールを実行します。まだデータ例がない場合は、まず代表的なものを作成します。確認には、ルールが何をすべきかの説明だけでなく、実行対象となる実際の入力が必要です。

懸念事項のフラグ

JSON だからといって JsonLogic が「安全」であると主張しないでください。

参照ファイル

全てを一度に読み込むのではなく、必要に応じて以下のファイルを参照してください:

  • references/jsonlogic.md — コアセマンティクス:truthiness、型強制、var パス解決、欠落データの動作、「準拠」の意味。
  • references/operations.md — 全ての標準演算:構文と、知っておく価値のある動作メモ(短絡評価、3 引数比較、reduce の current/accumulator など)。
  • references/libraries.md — 各言語のライブラリ状況:見つかったもの、確認されたもの、確認されなかったもの。言語固有のコードを書く前に読んでください。リストにない言語についても同様です。存在しないと決めつけて先に確認してください。
  • references/testing.md — ルールや実装を検証する方法、および特定の回答において「検証済み」が何を意味するかを正直に伝える方法。
  • references/tests/ — 個々の演算子を検証するための、バンドルされた上流テストケース(コア仕様 + コミュニティ拡張)。
  • examples/ — 実例:

関連スキル