BLOG / product-facts-claims-disclosures-evidence.mdx
상품 지식의 사실·주장·고지·한계: 근거 관리하기
상품 지식 분류, 출처 URL, 검증일, 본문 일관성, 검토 결정, 신뢰할 수 없는 자유문 처리를 설명합니다.
상품 지식은 분류, 출처, 검토일, 제한이 드러날 때만 신뢰할 수 있습니다. 문장을 구문 분석했다고 Fact로 승격되지는 않습니다.
SKU.md는 판매자가 직접 호스팅하는 상품 탐색 및 안정적인 상품 지식 계층입니다. Agent가 상품을 찾고, 출처가 있는 사실을 이해하며, 실시간 상거래 정보를 어디에서 다시 확인해야 하는지 알도록 돕습니다. 새로운 Checkout 프로토콜이 아닙니다.
네 가지 상품 지식 분류
| 분류 | 의미 | 처리 예시 |
|---|---|---|
| Facts | 근거가 뒷받침하고 게시자가 승인한 문장 | 소재 구성을 기술 자료에 연결 |
| Claims | Claim으로 남는 귀속된 주장 | “온종일 편안하도록 설계”를 판매자 주장으로 표시 |
| Disclosures | 사용자가 알아야 할 조건 | 알레르기 유발 물질, 안전, 관리, 호환성 고지 |
| Limitations | 근거나 상품이 입증하지 않는 범위 | 실험실 결과가 한 Variant와 한 시험 방법만 포괄 |
분류에 따라 소비자가 말하는 방식이 달라집니다. Claim을 중립적 사실로 바꾸지 말고, Limitation은 제한하는 근거와 함께 전달해야 합니다. 안전 Disclosure가 자격이나 동의에 영향을 주면 라이브 구매 흐름에도 나타나야 합니다.
source_url과 verified_at으로 검토를 추적하기
source_url은 검토자가 근거를 얻은 위치이고 verified_at은 게시자가 확인한 시각입니다. 어느 필드도 출처가 옳다고 단독으로 증명하지 않지만, 소비자와 편집자가 다시 확인할 경로를 제공합니다.
| 검토 질문 | 승인 조건 | 거부·보류 조건 |
|---|---|---|
| 어느 Product·Variant인가 | 안정적 식별이 정확히 일치 | 출처가 다른 품목을 다룸 |
| 출처가 무엇을 말하는가 | 문장이 출처 범위 안에 있음 | 근거 없는 최상급 추가 |
| 언제 확인했는가 | verified_at 기록 |
날짜 추측 또는 누락 |
| 무엇을 제외하는가 | Limitations 명시 | 한정 조건 삭제 |
프런트매터와 본문은 같은 이야기를 해야 합니다
구조화된 지식은 결정적 검증을 돕고 본문은 사람이 이해하게 합니다. 프런트매터가 “방수 기능”이라고 하는데 본문이 “완전 방수”라고 하면 유효한 YAML도 문서를 구하지 못합니다. 본문 일치 검사는 파생 모순을 찾아야 하며 게시 전 편집 검토로 해결해야 합니다.
v0.10 사양은 Markdown 본문을 규범적 필드와 비교하기 전까지 신뢰할 수 없는 입력으로 취급합니다. 링크, HTML, 프롬프트 형태 지침은 비활성 데이터이며 Product Document에 나타난다는 이유로 실행하면 안 됩니다.
모호하면 중단하는 검토 절차
- 후보 텍스트와 원본 공개 근거를 수집합니다.
- 정확한 Product와 Variant를 맞춥니다.
- 문장을 Fact, Claim, Disclosure, Limitation으로 분류합니다.
source_url,verified_at, 검토 결정, 범위를 기록합니다.- 본문 일관성을 확인하고 근거 없는 홍보를 거부합니다.
- 승인 바이트열을 게시하고 수정 경로를 유지합니다.
검토되지 않은 설명, 후기, 평점, AI 출력, 숨겨진 HTML, 홍보 문구는 후보가 될 수 있지만 신뢰할 수 있는 상품 지식은 아닙니다. 책임 있는 게시자가 검증하기 전에는 생략하는 것이 안전합니다.
더 읽기
식별은 ProductGroup, Variant, SKU, GTIN에서, 문서 범주는 SKU.md란 무엇인가에서 확인하세요.