Communitygithub.com

jsonlogic

JsonLogic 비즈니스 룰(JSON 기반 조건부 논리 형식)을 작업합니다. 비즈니스 요구사항을 JsonLogic 규칙으로 변환하거나, 기존 표현식을 설명/디버깅하거나, 규칙 유효성 검사, 특정 언어(JavaScript, TypeScript, Python, Ruby, Java, PHP, Go, C# 등)에서 JsonLogic 실행, 라이브러리 비교/선택, 애플리케이션에 JsonLogic 통합 시 사용합니다.

jsonlogic란 무엇인가요?

이 스킬은 JsonLogic 형식의 비즈니스 규칙을 작성, 실행, 검증, 디버깅하는 데 특화된 도구입니다. JsonLogic은 JSON으로 조건부 논리를 표현하는 경량 포맷으로, 언어 중립적인 표준 규칙 형식을 제공합니다. 이 스킬은 json-logic-js(JavaScript), json-logic-rb(Ruby), maykin-json-logic-py(Python) 등 다양한 언어별 라이브러리를 지원하며, 규칙과 데이터를 실시간으로 시각화하고 실행할 수 있는 Playground 아티팩트를 제공합니다. 사용자가 비즈니스 요구사항을 JsonLogic 규칙으로 변환하거나, 기존 규칙을 설명/디버깅하거나, 규칙의 유효성을 검사하고, 특정 언어로 JsonLogic을 실행하거나, 라이브러리를 비교/선택할 때 유용합니다. 또한 JsonLogic의 내장 연산자만으로 논리를 표현할 수 있도록 안내하고, 필요한 경우 커스텀 연산이나 다른 라이브러리 선택을 제안합니다. 참조 파일(references/)과 예제(examples/)를 통해 표준 연산, 라이브러리 목록, 테스트 방법 등을 안내합니다.

지원 대상~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를 참조하세요.

특정 라이브러리는 JavaScript용 json-logic-js나 Ruby용 json-logic-rb처럼 특정 언어로 JsonLogic을 실행하는 코드입니다. 라이브러리는 지원하는 연산, API 형태, 오류 처리 방식이 다를 수 있습니다.

JsonLogic 실행

라이브러리

json-logic-js처럼 특정 구현이 명시된 경우, 해당 구현을 정확히 사용하세요. **"in Python"**처럼 언어 이름만 명시된 경우, references/libraries.md에서 해당 언어의 라이브러리를 사용하세요. 라이브러리나 언어가 모두 명시되지 않은 경우, 기본값으로 scripts/jsonlogic.rb를 사용하세요.

지원

규칙이 유효한 JsonLogic이더라도 선택한 라이브러리나 현재 버전에서 지원되지 않을 수 있습니다. 지원되지 않는 연산이 있으면 표시하세요. 라이브러리 하나가 실행할 수 없다고 해서 유효한 JsonLogic 규칙을 다시 작성하지 마세요. 제한 사항이 어느 수준인지 말하고 실제 옵션을 제시하세요:

  • 커스텀 연산
  • 특정 구현에서 연산이 지원되지 않는 경우 다른 라이브러리
  • 로직 변경

Playground 아티팩트

구체적인 규칙이 (생성, 설명, 수정, 실행 등으로) 관련될 때마다 텍스트로만 설명하지 말고 실시간으로 렌더링하세요: 해당 규칙과 데이터로 assets/playground.html을 시드(seed)한 후 Artifact 도구로 게시하세요. 이는 스킬을 설치한 사람에 따라 실행됩니다. 각 게시 호출은 해당 사람의 계정 아래에 아티팩트를 생성하므로, 모든 설치자에게 공유 단계 없이 동일하게 작동합니다. 아티팩트는 기본적으로 비공개이며, 여기서 게시하면 동일한 URL만 업데이트되므로 매번 별도로 결정할 필요가 없습니다.

두 개의 파일(하나는 정적, 하나는 템플릿): 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 실행 → 라이브러리와 동일한 라이브러리로 바꾸세요. 이는 페이지의 "Verify in chat" 버튼이 실제 구현에 대해 확인을 요청할 때 사용하는 이름입니다. 따라서 이 파일의 자체 기본값이 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단계: 데이터 구조 파악

새 규칙을 만들기 전에 항상 데이터의 필드 이름을 어떻게 얻을지 물어보세요. 이를 선택지로 제시하세요. 가능한 경우 클라이언트의 구조화된 질문 메커니즘(버튼 또는 선택기 등)을 사용하세요. 그렇지 않으면 선택지를 일반 텍스트로 제시하세요.

질문: "데이터의 필드 이름을 어떻게 얻을까요?" 세 가지 옵션을 제공하세요:

  • 옵션 스키마 — "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 실행을 참조하세요. 아직 데이터 예제가 없으면 먼저 대표적인 예제를 만드세요. 확인하려면 규칙이 무엇을 해야 하는지에 대한 설명이 아닌 실제 입력이 필요합니다.

우려 사항 표시

JsonLogic이 JSON이라는 이유만으로 "안전하다"고 주장하지 마세요.

참조 파일

모든 것을 한 번에 로드하지 말고 필요에 따라 읽으세요:

  • references/jsonlogic.md — 핵심 의미: truthiness, 타입 강제 변환, var 경로 해석, 누락된 데이터 동작, "준수"의 의미.
  • references/operations.md — 모든 표준 연산: 구문 및 알아둘 만한 동작 참고 사항(단락 평가, 3-인수 비교, reduce의 current/accumulator 등).
  • references/libraries.md — 언어별 라이브러리 현황: 발견된 것, 확인된 것, 확인되지 않은 것. 언어별 코드를 작성하기 전에(나열되지 않은 언어 포함) 먼저 읽으세요. 존재하지 않는다고 가정하지 말고 먼저 확인하세요.
  • references/testing.md — 규칙이나 구현을 확인하는 방법과 주어진 답변에서 "확인됨"이 무엇을 의미하는지 정직하게 설명하는 방법.
  • references/tests/ — 개별 연산자 검증을 위한 번들 업스트림 테스트 케이스(핵심 사양 + 커뮤니티 확장).
  • examples/ — 작업된 예제:

관련 스킬