과거 SQL 테이블 사용 요약기

무엇을 해주나

historic-sql 어댑터가 만든 tables/<schema>.<name>.json 파일 하나를 읽어, 그 테이블이 실제 쿼리 로그에서 어떻게 쓰였는지를 짧은 서술과 구조화된 필드로 요약합니다.

• WorkUnit 노트 → 원본 테이블 JSON 순서로 읽고, 필요할 때만 manifest.json을 참조
• columnsByClause.where → 공통 필터, groupBy → 공통 그룹핑, observedJoins → 공통 조인으로 매핑
• 실행 횟수/사용자 수/최근성 버킷을 근거로 frequencyTier(high·mid·low·unused) 판정
• 최종적으로 emit_historic_sql_evidence를 kind: "table_usage"로 정확히 한 번 호출하고 종료
• 위키 쓰기·SL 소스 편집·근거 중복 발행을 명시적으로 금지하고, 스테이징 JSON에 없는 컬럼/조인/테이블 창작을 차단
• 식별자 검증 프로토콜: discover_data, entity_details, sql_execution 프로브로 schema.table.column이 실제 존재하는지 확인하고, 확인 불가 시 [unverified - from <rawPath>]로 표시

이런 분께 추천

• ktx(Kaelio) 메모리 에이전트 파이프라인을 운영·확장하는 개발자
• 쿼리 로그 기반으로 데이터 웨어하우스 스키마 문서를 자동 생성하는 데이터 플랫폼 팀
• LLM이 존재하지 않는 테이블·컬럼을 만들어내는 문제(할루시네이션)를 막는 설계 패턴을 참고하려는 분

활용 예시

1. tables/public.orders.json이 변경되어 WorkUnit이 생성됨 → 이 스킬이 "결제/환불 라이프사이클 분석과 고객 단위 롤업에 반복 사용됨"이라는 서술과 함께 frequencyTier: "high", 공통 필터 status, created_at을 담은 evidence를 1건 발행.
2. 최근 템플릿이 전혀 없는 테이블 → frequencyTier: "unused", staleSince 설정 후 종료.
3. 원본에 등장한 public.plans.tier 값이 실제 존재하는지 불확실할 때 → sql_execution으로 SELECT DISTINCT tier ... LIMIT 50 프로브를 돌려 검증하고, 실패 시 미검증 표기.

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

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

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