좋은 SKU.md는 AI Agent에게 무엇을 알려야 하는가
v1.0.0 특집
좋은 SKU.md는 AI Agent에게 무엇을 알려야 하는가 — 검증 가능한 근거와 명확한 책임 경계를 바탕으로 실무 결정을 설명합니다.
좋은 SKU.md는 AI Agent에게 무엇을 알려야 하는가 — 검증 가능한 근거와 명확한 책임 경계를 바탕으로 실무 결정을 설명합니다. 판매자가 실행하고 독립 구현이 검증할 수 있는 판단을 제시합니다.
현재 상태: 이 글은 현재 v1.0.0-beta의 경계와 안정판에 필요한 증거를 설명합니다. 플랫폼 채택, 순위, 인용, 추천 또는 매출 성과를 주장하지 않습니다.
제품이 무엇인지 답하는 사실
이 절은 ‘좋은 SKU.md는 AI Agent에게 무엇을 알려야 하는가’의 판단을 제품이 무엇인지 답하는 사실 관점에서 다룹니다. 공개 근거, 확인 시점, 권한을 가진 시스템을 구분해 기록하고 모르는 값을 추측으로 채우지 않습니다. 변하는 가격과 재고는 실시간 상거래 시스템에 맡기고 지식 파일은 상품 의미와 적합 조건에 집중합니다.
실무에서는 입력, 선택한 증거, 판단, 남은 불확실성을 한 기록에 남깁니다. 다른 구현이 같은 결과를 설명할 수 없다면 성공으로 간주하지 않습니다.
적절한 사용법을 설명하는 지침
이 절은 ‘좋은 SKU.md는 AI Agent에게 무엇을 알려야 하는가’의 판단을 적절한 사용법을 설명하는 지침 관점에서 다룹니다. 공개 근거, 확인 시점, 권한을 가진 시스템을 구분해 기록하고 모르는 값을 추측으로 채우지 않습니다. 변하는 가격과 재고는 실시간 상거래 시스템에 맡기고 지식 파일은 상품 의미와 적합 조건에 집중합니다.
실무에서는 입력, 선택한 증거, 판단, 남은 불확실성을 한 기록에 남깁니다. 다른 구현이 같은 결과를 설명할 수 없다면 성공으로 간주하지 않습니다.
제한 사항에 누가 또는 무엇을 위한 것이 아닌지 명시
이 절은 ‘좋은 SKU.md는 AI Agent에게 무엇을 알려야 하는가’의 판단을 제한 사항에 누가 또는 무엇을 위한 것이 아닌지 명시 관점에서 다룹니다. 공개 근거, 확인 시점, 권한을 가진 시스템을 구분해 기록하고 모르는 값을 추측으로 채우지 않습니다. 변하는 가격과 재고는 실시간 상거래 시스템에 맡기고 지식 파일은 상품 의미와 적합 조건에 집중합니다.
실무에서는 입력, 선택한 증거, 판단, 남은 불확실성을 한 기록에 남깁니다. 다른 구현이 같은 결과를 설명할 수 없다면 성공으로 간주하지 않습니다.
호환성은 값비싼 불일치를 방지합니다
이 절은 ‘좋은 SKU.md는 AI Agent에게 무엇을 알려야 하는가’의 판단을 호환성은 값비싼 불일치를 방지합니다 관점에서 다룹니다. 공개 근거, 확인 시점, 권한을 가진 시스템을 구분해 기록하고 모르는 값을 추측으로 채우지 않습니다. 변하는 가격과 재고는 실시간 상거래 시스템에 맡기고 지식 파일은 상품 의미와 적합 조건에 집중합니다.
실무에서는 입력, 선택한 증거, 판단, 남은 불확실성을 한 기록에 남깁니다. 다른 구현이 같은 결과를 설명할 수 없다면 성공으로 간주하지 않습니다.
식별자는 시스템 전반에 걸쳐 레코드를 연결합니다
이 절은 ‘좋은 SKU.md는 AI Agent에게 무엇을 알려야 하는가’의 판단을 식별자는 시스템 전반에 걸쳐 레코드를 연결합니다. 관점에서 다룹니다. 공개 근거, 확인 시점, 권한을 가진 시스템을 구분해 기록하고 모르는 값을 추측으로 채우지 않습니다. 변하는 가격과 재고는 실시간 상거래 시스템에 맡기고 지식 파일은 상품 의미와 적합 조건에 집중합니다.
실무에서는 입력, 선택한 증거, 판단, 남은 불확실성을 한 기록에 남깁니다. 다른 구현이 같은 결과를 설명할 수 없다면 성공으로 간주하지 않습니다.
출처를 통해 소비자가 모든 중요한 클레임을 검사할 수 있음
이 절은 ‘좋은 SKU.md는 AI Agent에게 무엇을 알려야 하는가’의 판단을 출처를 통해 소비자가 모든 중요한 클레임을 검사할 수 있음 관점에서 다룹니다. 공개 근거, 확인 시점, 권한을 가진 시스템을 구분해 기록하고 모르는 값을 추측으로 채우지 않습니다. 변하는 가격과 재고는 실시간 상거래 시스템에 맡기고 지식 파일은 상품 의미와 적합 조건에 집중합니다.
실무에서는 입력, 선택한 증거, 판단, 남은 불확실성을 한 기록에 남깁니다. 다른 구현이 같은 결과를 설명할 수 없다면 성공으로 간주하지 않습니다.
상품 지식의 역할 분리
Facts, Guidance, Limitations, Compatibility, Identifiers, Source는 서로 다른 판단에 쓰입니다. “모든 모험에 적합”은 검증하기 어렵지만 “지름 76 mm 이상 홀더에 맞음”은 실행 가능한 호환 조건입니다. 모르는 값은 추정하지 않고 Variant 범위의 식별자와 제한을 상품군 전체로 확대하지 않습니다.
결정
| 결정 | 사용할 증거 | 추론하면 안 되는 것 |
|---|---|---|
| 제품이 무엇인지 답하는 사실 | HTTP response, document bytes, Source URL, validator output | ranking, endorsement, adoption, conversion |
| 적절한 사용법을 설명하는 지침 | HTTP response, document bytes, Source URL, validator output | ranking, endorsement, adoption, conversion |
| 제한 사항에 누가 또는 무엇을 위한 것이 아닌지 명시 | HTTP response, document bytes, Source URL, validator output | ranking, endorsement, adoption, conversion |
실무 체크리스트
- 제품이 무엇인지 답하는 사실.
- 적절한 사용법을 설명하는 지침.
- 제한 사항에 누가 또는 무엇을 위한 것이 아닌지 명시.
- 호환성은 값비싼 불일치를 방지합니다.
- 식별자는 시스템 전반에 걸쳐 레코드를 연결합니다..
- 출처를 통해 소비자가 모든 중요한 클레임을 검사할 수 있음.