Andrew Yim
1706a820fe
Unify the two schema-generation scenarios into a single slot-17 skill, both feeding one claims register -> build -> validate(16) pipeline: - Mode 1 (existing site): NEW scripts/extract_site_claims.py turns URLs / local HTML / a directory into a claims register. Existing JSON-LD -> CONFIRMED; title/OpenGraph -> PENDING (never auto-shipped). + site-extraction-methodology.md and bundled fixtures/site/ demo pages. - Mode 2 (not-yet-published site): land the source-to-schema engine (build_schema_drafts.py, type_templates.json, claims/source registers, 3 refs, sample_claims.csv) from the Desktop builder. - Rewrite SKILL.md (v2.0) around the two-mode framing; the claims register is the shared pivot. Only CONFIRMED, non-conflicting claims become schema; unfilled template slots are pruned, never emitted as placeholders. - Retire the old template-fill generator (code/ + desktop/); update root CLAUDE.md. Self-tested both chains end-to-end: Mode 2 sample -> build -> validate PASS (P0=0); Mode 1 fixtures -> extract -> build -> validate PASS (P0=0), JSON-LD round-trips with nested address intact. Fixed two adapter bugs (nested node promotion; relative-path URI). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.1 KiB
2.1 KiB
Schema 초안 리뷰 가이드 (7단계)
원칙: 사람은 원본 JSON을 직접 보지 않는다. 기계가 잡을 수 있는 결함은 검증기 게이트(8단계)가 먼저 0건으로 만들고, 사람은 "기계가 못 잡는 것"만 본다. 그래야 "오류 과다" 문제가 재발하지 않는다.
검토 순서
- 먼저 검증기 통과 →
zero P0확보 (P0가 남은 초안은 검토 대상 아님) - 아래 항목은 사람만 판단 가능 → 검토
- 고객 검토는 P0=0인 깨끗한 초안 + 결함 리포트로만 진행
사람이 검토할 항목 (기계가 못 잡는 것)
A. 사실 정확성 (출처 대조)
name/legalName이 공식 표기와 정확히 일치하는가 (공백·영문병기 포함)- 주소·전화가 현재 유효한 값인가 (출처가 오래되지 않았는가)
foundingDate등 날짜가 공시값과 일치하는가- 인물의
jobTitle이 현직 기준인가
B. 엔티티 정합
sameAs가 정확히 그 엔티티를 가리키는가 (동명 오정합 없는가)@id참조가 의도한 엔티티로 연결되는가 (Hotel→올바른 Organization)- 브랜드 티어(
brand.name)가 프로퍼티와 일치하는가 (The Shilla/Monogram/Stay)
C. 언어·번역
- 언어별 초안의
inLanguage와 실제 값 언어가 일치하는가 - 번역값이 공식 다국어 표기와 일치하는가 (임의 번역 아님)
D. 범위 적절성
- 스키마를 붙이면 안 되는 페이지(mypage/login/booking)에 초안이 없는가
- 누락된 핵심 엔티티가 없는가 (엔티티-타입 맵 대조)
검토 결과 처리
- 수정 필요 → 클레임 레지스터에서 값 수정 후 빌더 재실행(JSON 직접 수정 금지: 원천은 항상 클레임)
- 충돌 발견 →
conflict=Y,status=PENDING→ 출처 권위로 해소 - 검토 완료 → 저작자·검수자 서명, P1은
decision-log에 기록
서명
- 저작(빌드): ______ / 일자: 2026--
- 검수(사실확인): ______ / 일자: 2026--
- 게이트(검증기 PASS) 확인: ______ / 일자: 2026--