dbt 인제스트 (ktx 시맨틱 레이어)

무엇을 해주나

• 업로드된 dbt 프로젝트(dbt_project.yml, models/**, sources/**, schema.yml)를 읽어 ktx 시맨틱 레이어(SL) 오버레이로 매핑합니다.
• models:와 sources:의 차이, identifier 우선 규칙, 컬럼 description을 column_overrides[].descriptions.user로 옮기는 방법을 규정합니다.
• not_null, unique, accepted_values, relationships 같은 dbt 테스트를 짧은 컬럼 힌트나 조인 정보로 변환합니다.
• 핵심은 '환각 방지'입니다. discover_data, sl_discover, entity_details, sql_execution으로 실제 웨어하우스 스키마를 확인한 컬럼만 사용하고, 확인되지 않으면 위키 노트로만 남기도록 강제합니다.
• 작성 후 반드시 sl_validate를 호출하고, 존재하지 않는 컬럼/메저 참조 오류는 하드 스톱으로 처리합니다.

이런 분께 추천

• ktx 플랫폼에서 dbt 프로젝트를 시맨틱 레이어로 온보딩하는 데이터 엔지니어
• dbt 문서/테스트 메타데이터를 분석 에이전트가 이해할 수 있는 형태로 정리하려는 애널리틱스 엔지니어
• LLM이 컬럼명을 지어내는 문제를 규칙으로 막고 싶은 데이터 플랫폼 팀

활용 예시

1. models/marts/schema.yml의 orders 모델을 읽어, 매니페스트의 실제 테이블에 설명 오버레이를 붙이고 status 컬럼에 "dbt: accepted_values = paid/pending/refunded" 힌트를 추가.
2. sources: 블록의 identifier를 이용해 논리명과 다른 물리 테이블을 찾아 연결하고, dbt 커넥션이 아닌 postgres-warehouse 커넥션에 오버레이를 기록.
3. relationships 테스트의 참조 대상이 entity_details로 확인되지 않으면 조인을 만들지 않고 emit_unmapped_fallback과 위키 노트로 의도만 보존.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/Kaelio/ktx/HEAD/packages/cli/src/skills/dbt_ingest/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 Kaelio/ktx 의 packages/cli/src/skills/dbt_ingest 폴더를 내 ~/.claude/skills/dbt-ingest/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.