본문으로 이동

SKU.md v1.0.0 정식 출시: 상품 설명에서 AI가 읽는 상품 지식으로

v1.0.0 특집

SKU.md v1.0.0의 설계 선택, 출처가 있는 상품 지식, 판매자 도구와 참여 방법을 소개합니다.

SKU.md v1.0.0을 정식 출시합니다. 독립 쇼핑몰 판매자, 개발자, 쇼핑 에이전트 구현자를 위한 개방형 상품 지식 규격입니다. 읽고 관리하기 쉬운 Markdown으로 무엇을 판매하는지, 어떤 사실을 검토했는지, 그 근거가 어디에 있는지 설명합니다.

이번 릴리스는 파일 형식에 그치지 않습니다. 판매자는 누락과 충돌을 확인하고, 근거를 검토하고, 명시적인 구매 조건으로 상품을 비교한 뒤 검토한 내용을 내보낼 수 있습니다. 에이전트가 상품을 이해하도록 검증 가능한 기반을 제공합니다. SKU.md는 여전히 개방형 제안이며, 정식 버전 번호가 업계 표준 채택을 의미하지는 않습니다.

출발점: 상품 페이지에 흩어진 맥락

쇼핑몰에는 이미 상세 설명, 사양표, FAQ, 거래 시스템이 있습니다. 하지만 특정 용도에 맞는 상품을 찾으려면 흩어진 맥락을 연결해야 합니다. 치수가 어느 옵션에 해당하는지, 호환성에 어떤 전제가 있는지, 성능 수치가 어떤 조건에서 측정됐는지 알아야 합니다.

SKU.md는 기계가 이를 추측하도록 두는 대신 판매자가 직접 관리할 수 있어야 한다는 생각에서 출발했습니다. 저장소에는 2026년 7월 초기 사이트와 규격 개발 기록이 남아 있습니다. 이는 개발 과정의 근거이며 특정 버전의 공개 출시일을 증명하지 않습니다.

초기 실험에서 v1까지

v0.8 초안은 카탈로그, 상품 문서, 정보 출처를 정리하는 방법을 탐색했습니다. v0.9는 상호 운용성, 범위별 검증, 안전한 소비를 구체화했습니다. 문서를 해석할 수 있는지, 공개 주소에 접근할 수 있는지, 카탈로그 연결이 올바른지는 각각 확인해야 합니다.

v0.10은 상품 지식과 거래 시스템의 관계를 탐색했습니다. 지식의 발견, 실시간 시스템으로의 연결, 페이지 도구의 경계를 다루면서 개방형 상품 지식 규격이 어디까지 책임져야 하는지 검토했습니다.

v1은 책임 범위를 좁혔습니다. 기존 YAML 매니페스트, 분할 구성, 거래 프로필 대신 루트 카탈로그와 선택적인 상품 지식 문서를 순수 Markdown으로 표현합니다. 과거 규격은 보관하며 현재 도구는 1.0.0만 받습니다. 이전 문서를 자동 변환하지 않습니다. 기능을 추가하는 것만큼 불필요한 책임을 덜어내는 것도 중요한 변화였습니다.

읽을 수 있는 형식, 추적할 수 있는 근거

판매자는 자신이 공개하는 내용을 직접 읽고 일반 웹 자료로 제공할 수 있어야 합니다. Markdown은 본문, 링크, 변경 사항을 드러냅니다. 구조화된 기록으로 식별 정보, 옵션, 속성, 근거를 표현하므로 별도의 게시 형식을 관리할 필요가 없습니다.

출처 링크, 인용문, 검토 상태, 확인 날짜는 판매자의 판단을 기록합니다. URL이 열린다는 사실과 그 내용이 주장을 뒷받침한다는 사실은 다릅니다. 검토 완료 표시는 자동 인증이 아닙니다.

알 수 없는 값은 그대로 두고, 상품 전체 속성을 각 옵션의 사실로 자동 상속하지 않습니다. 적용 범위가 명확하면 소비자는 근거 없는 확신 대신 정보 부족을 인식할 수 있습니다.

정식 버전이 제공하는 것

구성 역할
개방형 규격 카탈로그, 출처가 있는 상품 지식, 식별 정보, 옵션, 속성, 조건과 실시간 시스템 링크
상품 개선 도구 누락과 충돌 확인, 근거 검토, 작업 초안 저장, 검토된 내용 내보내기
비교 작업 공간 명시한 조건에 대해 일치, 제외, 정보 부족을 구분하고 수정 전후 비교
CLI, Agent Skill, 읽기 전용 MCP 환경이 달라도 같은 규칙 활용. 구체적인 기능과 출시 상태는 각 도구 설명 참조

규격과 도구 패키지의 버전은 독립적입니다. 규격 1.0.0 출시가 모든 도구의 1.0.0 출시나 후보 Skill 패키지의 별도 공개를 뜻하지 않습니다. 웹 도구, 다운로드 파일, 서비스 주소를 각각 확인해야 합니다.

지식은 설명하고 실시간 시스템은 거래를 담당합니다

가격, 재고, 배송, 세금, 결제, 주문 상태는 바뀝니다. 정적인 상품 지식이 해당 시스템을 대신할 수 없습니다. SKU.md가 연결 대상을 알려줄 수는 있지만 링크 자체가 거래 권한을 부여하지는 않습니다.

비교 도구는 제출된 사실과 조건을 대조합니다. 모델의 순위나 매출 예측이 아닙니다. 로컬 검수 기록은 규격, 도구, 일곱 언어의 흐름을 다룹니다. 외부 에이전트의 채택과 실제 판매 채널 성과는 별도의 근거가 필요합니다.

검증할 수 있는 상품 하나로 참여하세요

판매자는 공개 자료가 충실한 상품부터 시작할 수 있습니다. 개발자는 문서 해석과 소비 기능을 구현하고 재현 가능한 문제를 제출할 수 있습니다. 구체적인 실패, 누락, 플랫폼 제약이 규격 개선에 도움이 됩니다.

1.0.0 규격을 읽고 상품 개선 도구에서 상품 하나를 검토한 뒤 비교 작업 공간에서 정보 변화가 판단에 미치는 영향을 살펴보세요. Agent 연동은 Skill과 MCP의 기능 및 상태를 각각 확인하세요.

개발 과정과 버전 근거

  • 저장소 기록: 개발 근거이며 공개 출시일과 구분합니다.
  • v0.8, v0.9, v0.10: 과거 설계 자료입니다.
  • 1.0.0 변경 기록과 로컬 검수 기록: 준비와 검증의 근거이며 실제 공개 환경 검증을 대신하지 않습니다.