SKU.md v0.9: 상호운용성, 범위가 명확한 적합성, 안전한 이용

SKU.md v0.9는 상호운용성과 일관성을 위한 릴리스입니다. Shopify 전용 필드, 순위 점수 또는 두 번째 Checkout 시스템을 추가하지 않습니다. 대신 게시자가 무엇을 검사했는지 밝히는 방법, 소비자가 그 증거를 해석하는 방법, 양쪽 모두가 실시간 커머스 시스템으로 돌아가야 하는 지점을 정의합니다.

와이어 형식은 바뀌지 않습니다

v0.9 Schema는 v0.8의 문서 유형, Profile, 필드, 필수 속성, 열거형 값, 확장 규칙과 안전 경계를 유지합니다. 따라서 데이터 계층의 마이그레이션은 의도적으로 작습니다.

1. schema_version을 sku.md/0.9-draft로 변경합니다.
2. Schema URL을 https://sku.md/schema/sku-md/0.9/schema.json으로 변경합니다.
3. 주장하려는 적합성 범위에 필요한 검사를 모두 실행합니다.

소비자는 호환성을 위해 v0.8 문서를 계속 읽을 수 있지만, 이를 v0.9 적합 문서로 표시해서는 안 됩니다. 버전 정체성과 적합성 증거는 서로 다른 주장입니다.

완전한 영문 v0.9 사양만이 규범 문서입니다. 공개 v0.9 JSON Schema는 구조를 검사하지만, 그 자체로 완전한 적합성 판정을 내리지는 않습니다.

세 가지 적합성 범위

v0.9는 검증기가 실제로 검사한 대상을 명시합니다.

범위	확인할 수 있는 것	확인할 수 없는 것
offline_document	안전한 프런트매터와 YAML, Schema, 단일 문서 의미, Markdown 일치성	HTTP 전달, 리소스 도달 가능성, 상위 그래프 무결성
published_resource	HTTP 상태, 리디렉션, MIME, 정식 URL, 소프트 폴백, 도달 가능성을 포함한 하나의 공개 URL	전체 문서군의 일관성
document_graph	상위 체인, 표현 형식, 외부 Profile, 참조 리소스, 문서 간 일관성	구매, 결제 또는 커머스 상태 변경 권한

보고서에서는 구문, Schema, 의미, 온라인 검사를 별도 계층으로 기록합니다. 필수 검사 하나라도 실패하면 전체 결과는 failed입니다. 필수 검사를 수행하지 않았고 실패도 없다면 결과는 incomplete이며, 절대 passed가 아닙니다.

이식 가능한 검증 보고서

보고서는 문서에 관한 증거이며 SKU-MD 프런트매터의 일부가 아닙니다. 성공적으로 생성된 루트 문서의 보고서는 다음과 같을 수 있습니다.

{
  "spec_version": "sku.md/0.9-draft",
  "validator": { "name": "sku-md-generator", "version": "0.2.0" },
  "target": {
    "url": "https://example.com/sku.md",
    "document_type": "catalog_manifest"
  },
  "scope": "offline_document",
  "status": "passed",
  "checked_at": "2026-08-01T00:00:00Z",
  "layers": {
    "syntax": "passed",
    "schema": "passed",
    "semantics": "passed",
    "online": "not_applicable"
  },
  "issues": []
}

안정적인 문제 코드를 사용하면 여러 도구가 결과를 동일하게 처리할 수 있습니다. 예로 YAML_DUPLICATE_KEY, SCHEMA_VALIDATION_FAILED, CANONICAL_MISMATCH, GTIN_CHECK_DIGIT_INVALID, KNOWLEDGE_DYNAMIC_STATE_FORBIDDEN, BODY_PARITY_INVALID가 있습니다. 네트워크 타임아웃을 성공으로 바꾸면 안 됩니다.

사이트 생성기는 offline_document 보고서만 만듭니다. 업로드 후에도 게시자는 HTTP 상태, text/markdown, 소프트 폴백, 정식 URL, 상위 링크, 표현 형식, 외부 Profile 참조를 온라인으로 검사해야 합니다.

Reference Consumer 동작

Reference Consumer는 독자를 위한 동작 계약이며 새로운 와이어 형식이 아닙니다. 안전한 순서는 다음과 같습니다.

1. 판매자가 호스팅하는 루트를 찾고 오리진과 표현 형식을 확인합니다.
2. 숨은 상품을 추측하지 않고 선언된 Catalog 진입점과 파티션을 따라갑니다.
3. 안정적인 식별자, 선택 항목, 시장, 언어, 정식 Variant URL로 정확한 Variant를 선택합니다.
4. 사실, 주장, 고지 사항, 안내, 제한 사항, 호환성, 출처 URL, 검증 날짜를 서로 구분합니다.
5. offer_snapshot을 관찰값으로 취급하고 현재 가격, 재고, 배송, 세금, 합계에는 live_lookup 또는 live_verification을 사용합니다.
6. 장바구니, Checkout, 결제, 주문은 명시적인 사용자 확인과 함께 선언된 실시간 권한 시스템으로 돌려보냅니다.

정체성, 증거, 최신성 또는 권한이 충분하지 않다면 소비자는 모델 추론으로 빈틈을 채우지 말고 안전하게 실패해야 합니다.

출처 거버넌스는 도구 계층에 둡니다

게시자에게는 소비자에게 전달해서는 안 되는 상태도 필요합니다. 비공개 출처 지도는 각 값의 출처와 그 값이 Detected, Derived, Verified 중 무엇인지 기록할 수 있습니다. 감사-계획-적용 흐름은 HTML, Product JSON-LD, 판매자 피드, 플랫폼 Catalog, 기존 SKU-MD를 비교하고 검토 가능한 변경 사항을 준비한 뒤, 사람의 승인 후에만 게시할 수 있습니다.

출처 지도, 검토 기록, 초안 상태, 릴리스 변경 사항, 문제 로그, 채널 지표는 공개 Schema에 들어가지 않습니다. 증분 재빌드 또는 온라인 검증이 실패하면 전달 시스템은 부분 출력으로 덮어쓰지 말고 마지막 유효 버전을 유지해야 합니다.

복제가 아닌 플랫폼 협업

SKU-MD는 안정적인 지식과 명시적인 출처 경계를 설명해야 합니다. 플랫폼 Catalog는 현재 배포, 가격, 재고에 대한 권한 있는 정보원으로 남고, 실시간 API 또는 UCP/MCP가 현재 조회를 처리하며, Checkout은 구매자 인증, 합계, 결제, 주문 생성을 담당합니다.

2026-08-01 현재 Shopify는 Shopify Catalog와 UCP 호환 Catalog, Cart, Checkout, Order 인터페이스를 문서화합니다. 그러나 해당 시스템, ChatGPT 또는 다른 Shopify 채널이 SKU-MD를 읽거나 신뢰한다고 설명하지는 않습니다. 따라서 통합 지침은 결제나 주문 상태를 복사하지 않고 포인터와 권한 경계를 사용합니다.

결과를 약속하지 않고 SEO, GEO, AEO 측정하기

유용한 질문은 정적 파일이 “AI 순위를 올리는가”가 아닙니다. 통제된 실험에서는 다음을 측정할 수 있습니다.

• 정확한 Variant 식별률
• 홍보 문구 대신 출처가 있는 사실을 인용하는지
• 고지 사항과 제한 사항을 재현하는지
• 시간에 민감한 답변 전에 실시간 검증을 사용하는지
• HTML, Product JSON-LD, 판매자 피드, 플랫폼 Catalog, SKU-MD 간 일관성

이 측정값은 게시 계약이 모호성과 오래된 답변을 줄이는지 보여 줄 수 있습니다. 그러나 크롤러가 문서를 가져오거나 플랫폼이 상품의 순위를 매기고, 인용하고, 추천하거나 구매 전환으로 이어지게 한다는 사실을 입증하지는 않습니다.

실용적인 마이그레이션 순서

먼저 버전 식별자를 갱신하고 오프라인 보고서를 생성합니다. 사람의 검토 후에만 게시하고, 이어서 공개 리소스와 문서 그래프를 검증합니다. 변동하는 커머스 상태는 Knowledge 밖에 두고, 자동화가 실패하면 마지막 유효 개정판을 유지하며, 근거 없는 채택 주장 대신 통제된 테스트로 결과를 비교합니다.

더 읽기

현재 v0.10의 전달 절차는 첫 SKU.md 게시하기에서 확인하세요.