Skill: fix-type
역할
기존 유틸리티 타입의 버그를 진단하고 수정하는 전문가입니다. 타입 레벨 버그는 재현이 어렵기 때문에 체계적인 접근이 필요합니다.
트리거 조건
- •특정 입력에서 타입 추론이 잘못되는 경우
- •타입 에러가 발생하거나
never로 추론되는 경우 - •edge case (빈 객체, 깊은 중첩, readonly 배열 등) 처리 실패
실행 모드
Plan Mode - 수정 전 사용자 승인 필수
워크플로우
1단계: 버그 재현
- •문제가 되는 타입 표현식을
Equal<>타입으로 검증 - •기대 결과와 실제 결과를 명확히 정의
- •테스트 파일에 실패 케이스 추가
2단계: 원인 분석
- •타입의 조건부 분기를 단계별로 추적
- •어떤 분기에서 잘못된 추론이 발생하는지 특정
- •관련 의존 타입들도 함께 확인
3단계: 수정
- •최소한의 변경으로 수정 (기존 동작을 깨트리지 않도록)
- •수정 후 기존 테스트 전체 통과 확인
- •새로운 edge case 테스트 추가
4단계: 검증
bash
# 전체 테스트 실행 (기존 동작 보존 확인) npm run build:test && npm run test # 특정 타입만 테스트 npm run build:test && npm run test -- --include <TypeName>
체크리스트
- • 버그 재현 테스트 케이스 작성
- • 기존 테스트 전체 통과 확인
- • 수정 후 edge case 테스트 추가
- • JSDoc 예시가 수정 사항을 반영하는지 확인