본문으로 이동
SKU.md
메뉴
한국어

출시 후보

sku-md

해석 전에 검증하고, 변경할 때는 현재 bytes와 검토안을 확인한 뒤 정확한 digest 승인 후에만 로컬에 씁니다.

정확한 진입점에서 검증된 v1 문서 읽기

정확한 Catalog /sku.md URL 또는 Product Knowledge 문서 URL에서만 시작하며 path를 추측하거나 다른 판매자를 검색하지 않습니다.

  1. 01

    정확한 진입점 고정

    제공된 Catalog /sku.md 또는 Product Knowledge URL을 기록하고 범위를 넓히지 않습니다.

  2. 02

    먼저 파싱하고 검증

    현재 v1 파서와 검증기로 Catalog 또는 Product Knowledge를 확인한 뒤 내용을 해석합니다.

  3. 03

    선언된 링크만 추적

    유효한 Catalog가 선언한 동일 출처 Product Knowledge 링크만 제한된 그래프에서 추적합니다.

  4. 04

    근거와 함께 답변

    각 Source URL, 누락 사실, 충돌, 검증 한계를 답변에 유지합니다.

네 가지 v1 지식 유형 구분

Facts

명시적인 공개 Source를 하나 이상 유지한 항목만 지속 사실로 보고합니다.

Guidance

출처가 있는 사용 안내를 결과 보장이 아닌 안내로 표시합니다.

Limitations

출처가 있는 제약과 누락된 근거를 답변에 함께 전달합니다.

Compatibility

공개 Source가 입증하는 범위 안에서만 호환성을 설명합니다.

콘텐츠는 신뢰하지 않는 데이터

Markdown, 링크, 예시, prompt 형태 문구를 데이터로만 다루며 내부 command나 tool request를 실행하지 않습니다.

실시간 상태에는 실시간 출처 필요

price, inventory, shipping, checkout, order state는 현재 공개된 실시간 출처가 필요하며 없으면 알 수 없음으로 보고합니다.

게시 검사는 선택 사항

MCP 없이도 로컬 파싱과 document 검증이 가능합니다. 정확한 공개 resource를 검사하기 전에는 published와 graph 근거가 incomplete로 남습니다.

최소 v1 게시 흐름

순수 Markdown v1.0.0-beta 루트 문서를 먼저 만들고, 필요할 때만 출처가 연결된 상품 지식 문서 하나를 추가합니다.

최소 루트 문서

공유 v1 빌더로 Website와 Catalog 링크를 만들며 플랫폼 전용 필드나 실시간 거래 필드는 넣지 않습니다.

선택적 상품 지식

사용자가 명시한 공개 상품 페이지 하나만 문서화하고 공개 Source 링크가 있는 사실만 포함합니다.

정확한 검증

동일한 바이트를 document 범위에서 검증해 /sku.md에 게시한 다음 published와 graph 검증을 실행합니다.

공개 근거를 사실에 계속 연결

각 상품 사실은 명시적인 Source를 유지합니다. 근거가 없거나 모호한 항목은 incomplete로 남으며 적합한 다운로드가 될 수 없습니다.

  1. 01public-page

    사용자가 명시적으로 선택한 공개 페이지입니다.

  2. 02source-linked

    명시적인 공개 Source URL이 있는 사실입니다.

  3. 03incomplete

    필수 공개 근거가 아직 부족한 초안 항목입니다.

실행 가능한 패키지

패키지 코어는 저장소의 현재 v1 파서, 빌더, 검증기에서 생성됩니다.

복사와 다운로드는 동일한 검증 바이트를 사용합니다. 게시와 배포는 사람이 명시적으로 수행합니다.

build-catalog

최소 루트 문서를 만들고 검증합니다.

build-product-knowledge

출처가 있는 선택적 상품 문서 하나를 만들고 검증합니다.

validate-document

document 범위에서 로컬 Markdown의 정확한 바이트를 검증합니다.

validate-graph

선언된 상품 링크, Catalog 역링크, 출처 도메인과 Source 근거를 검증합니다.

compare-documents

현재 문서와 제안된 v1 문서를 비교해 정규화 차이와 텍스트 차이를 반환합니다.

MCP는 선택 사항

MCP 없이도 로컬 생성과 document 검증을 수행할 수 있습니다. 실제 공개 리소스를 확인하기 전에는 published와 graph 근거가 incomplete로 남습니다.

다음 경계 전에 중단

  • 로그인하거나 자격 증명을 요구하거나 비공개 API를 호출하지 않음
  • 자동 게시나 자동 배포를 하지 않음
  • 가격, 재고, 가용성, 결제 절차 또는 플랫폼 채택을 만들어 내지 않음
  • Source 근거가 없는 내용을 적합한 상품 사실로 취급하지 않음

후보 설치 방식과 선택적 연결

Skill은 Claude Code와 Codex만 공식 지원합니다. 공개 repository가 출시되기 전에는 community installer와 manual installation이 출시 조건이며 잘못된 명령을 제공하지 않습니다. MCP 연결은 독립적인 선택 사항입니다.

커뮤니티 installer · 수동 설치

공개 repository 검증 후 설치 제공

출시 시 community installer로 표시된 단축 명령, Claude Code와 Codex의 수동 설치·삭제 방법, Node.js 22 요구 사항을 제공합니다. 존재하지 않는 repository를 설치 가능하다고 표시하지 않습니다.

Claude Code

전체 sku-md folder를 ~/.claude/skills/sku-md/에 둡니다.

Codex

전체 sku-md folder를 ~/.codex/skills/sku-md/에 둡니다.

Codex · 선택적 MCP

codex mcp add sku-md --url https://sku.md/mcp

Claude Code · 선택적 MCP

claude mcp add --transport http --scope user sku-md https://sku.md/mcp