인수인계서 — 세션 25 (kdyextract v2 전면 개선)
작성일: 2026-02-18 이전 세션: session24
작업 요약
kdyextract 스킬을 v2로 전면 업그레이드. Mode A(프로젝트 코드 추출) 10가지 이슈 수정 + Mode B(웹사이트 프론트엔드 자산 추출) 신규 구현 + 02-reusable-design/ 디자인 자산 저장소 생성.
수정 파일 (7개)
| # | 파일 | 변경 내용 |
|---|---|---|
| 1 | 03-skills/kdyextract/SKILL.md | v2 전면 재작성 (Phase 0 추가, 듀얼 모드 A/B/C, 인수 처리, 10가지 이슈 수정) |
| 2 | 03-skills/kdyextract/references/refinement-rules.md | 신규: Phase 6 정제 규칙 상세 (6.1~6.6) |
| 3 | 03-skills/kdyextract/references/category-extraction-criteria.md | 신규: 카테고리별 추출 기준 13개 |
| 4 | 03-skills/kdyextract/references/category-placement-rules.md | 신규: 배치 우선순위 (도메인>기술>형태) |
| 5 | 03-skills/kdyextract/references/mode-b-web-scan.md | 신규→재작성: "향후 구현 예정" → 완전 구현 스펙 |
| 6 | 02-reusable-design/README.md | 신규: 디자인 자산 저장소 인덱스 |
| 7 | CLAUDE.md | 폴더 구조에 02-reusable-design 추가 + 관련 문서 링크 |
상세 변경 사항
1. SKILL.md v2 전면 재작성
스킬 컨벤션 준수 수정:
- Phase 0 (컨텍스트 탐지) 추가
## 인수 처리+$ARGUMENTS표준 형식## 관련 스킬/에이전트테이블 (도구/역할/관계)- 섹션 순서: Phase → 예외사항 → 관련 스킬 → 사용 예시 → 주의사항 → 참조 문서
- 500줄 초과 →
references/4개 파일로 분리 (최종 270줄)
Mode A 10가지 이슈 해결:
- 카테고리 맵 동적 Glob 스캔 (하드코딩 제거)
- 테스트 코드 추출 에이전트 4 + 정제 규칙 6.5
--dry-run/--category/--skip-tests플래그 구현- 충돌 해결 4옵션 (덮어쓰기/병합/스킵/백업) + 일괄 적용
- Phase 4-B 구문 검증 (
tsc --noEmit,ast.parse, CSS 구문) - 카테고리 배치 우선순위 규칙 (도메인>기술>형태)
- Phase 7 트랜잭션 롤백 (역순 정리)
- 유사도 3축 구조적 기준 (시그니처 40% + 로직 40% + 의존성 20%)
- 라이선스 자동 검출 (Phase 2 수집 + Phase 4-A 판정)
- Phase 8-3에서
/kdyupdate연동 안내
Mode B 신규 구현:
- Phase 0: URL 자동 감지 → Mode B, 경로+URL → Mode C
- Phase 1: 웹사이트 타겟 확인 + 윤리 고지 자동 출력
- Phase 2-3: 4에이전트 (Playwright 크롤링, CSS 분석, 에셋 수집, 인터랙션 관찰)
- Phase 2-W: 7카테고리 분류 + 코드 재구성 (DOM→TSX, CSS→토큰)
- Phase 3~8: Mode A와 동일 흐름 합류
- CLI 플래그:
--pages,--focus(Mode B 전용) - 안전장치: robots.txt, 이미지 복사 금지, Rate limiting 1초
2. 02-reusable-design/ 저장소 생성
4개 최상위 카테고리 + 10개 하위 폴더:
tokens/(color-palettes, typography, spacing-scale)css-patterns/(animations, layouts, utilities)tailwind-configs/(themes, plugins)assets/(icon-sets, patterns)
검증 결과
- SKILL.md 270줄 (500줄 제한 이내)
- "미구현"/"향후"/"예정" 마커 0건 (Grep 검증)
- code-reviewer 에이전트 2회 실행: 1차(Mode A) 13건 지적 → 수정, 2차(Mode B) 5건 지적 → 수정
- 스킬 컨벤션 준수: Phase 0, $ARGUMENTS, 관련 스킬 테이블, 섹션 순서 모두 적합
터치하지 않은 영역
02-reusable-code/,02-reusable-code-python/,02-reusable-page/기존 파일- 다른 스킬/에이전트 파일 (kdypick, kdyupdate 등 — 향후 02-reusable-design 대응 필요)
- 글로벌 스킬 (
~/.claude/skills/kdyextract/) — 동기화 필요
알려진 이슈
/kdypick이02-reusable-design/를 아직 대상으로 인식하지 못함 → 향후 kdypick 업데이트 필요- 글로벌 스킬에 kdyextract v2 미동기화 →
~/.claude/skills/kdyextract/업데이트 필요 - Mode B의 Playwright 의존성: 사용자 환경에
npx playwright install chromium필요할 수 있음 _COMPONENT_MAP.md에 02-reusable-design/ 연결 미반영 → 다음/inception실행 시 갱신
다음 작업 제안
- 글로벌 스킬 동기화 — kdyextract v2를
~/.claude/skills/kdyextract/에 반영 - kdypick 02-reusable-design 대응 — pick 대상에 디자인 저장소 추가
- Mode B 실전 테스트 — 실제 URL로
/kdyextract https://...실행하여 전체 흐름 검증 - inception 갱신 — 02-reusable-design/ 연결 반영