테스트와 디버깅 - 스킬 검증 방법
목차
스킬을 만들었는데 제대로 동작하는지 어떻게 확인하나요?
스킬도 코드처럼 테스트와 디버깅이 필요합니다. 문제가 생겼을 때 원인을 찾고 해결하는 방법을 알아야 합니다.
이 글에서는 스킬을 검증하고 문제를 해결하는 방법을 알아봅니다.
스킬 테스트 기본
스킬 테스트는 어떻게 해요? 유닛 테스트 같은 게 있나요?
스킬은 코드가 아니라 프롬프트라서 전통적인 테스트와 달라. 대신 시나리오 기반 테스트를 해.
시나리오 기반이요?
"이렇게 요청하면 이렇게 응답해야 한다"를 정해두고, 실제로 그렇게 되는지 확인하는 거야.
① 활성화 테스트 - 스킬이 제대로 인식되는가?
② 동작 테스트 - 의도한 대로 동작하는가?
③ 엣지 케이스 - 예외 상황에서도 괜찮은가?
활성화 테스트
먼저 스킬이 제대로 인식되는지 확인합니다.
테스트 방법
💡 활성화 테스트 체크리스트
- /help 입력 → 스킬 목록에 보이는가?
- /스킬명 입력 → 스킬이 실행되는가?
- 키워드 입력 → 자동으로 활성화되는가?
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| 스킬 목록에 안 보임 | 파일 위치 오류 | 경로 확인 (SKILL.md) |
| 슬래시 명령 안 됨 | name 필드 오류 | 프론트매터 name 확인 |
| 키워드 매칭 안 됨 | keywords 누락 | keywords 배열 확인 |
스킬이 인식 안 되면 Claude Code를 재시작해보세요. 새 스킬은 재시작 후 인식되는 경우가 많습니다!
동작 테스트
스킬이 의도한 대로 동작하는지 확인합니다.
테스트 시나리오 작성
## 테스트 시나리오: blog-writer 스킬
### TC-1: 기본 동작
- 입력: /blog-writer AI 트렌드
- 기대: 2000자 이상의 블로그 글 생성
- 확인: 소제목 3개 이상 포함
### TC-2: 인자 없이 실행
- 입력: /blog-writer
- 기대: 주제를 요청하는 안내 메시지
- 확인: 에러 없이 안내 표시
### TC-3: 긴 주제
- 입력: /blog-writer 인공지능이 바꾸는 미래 산업 전망과 대응 전략
- 기대: 주제에 맞는 글 생성
- 확인: 주제 키워드 포함
매번 이렇게 테스트해야 해요?
처음 만들 때랑 수정할 때만 해도 돼. 테스트 시나리오를 파일로 저장해두면 나중에 다시 쓸 수 있어.
디버깅 방법
스킬이 예상과 다르게 동작할 때 원인을 찾는 방법입니다.
1. 스킬 내용 확인 요청
Claude에게 직접 물어보세요:
"blog-writer 스킬의 규칙을 알려줘"
Claude가 스킬을 어떻게 이해하고 있는지 확인할 수 있습니다.
2. 단계별 실행 요청
단계를 나눠서 확인:
"Step 1만 먼저 실행하고 결과 보여줘"
어느 단계에서 문제가 생기는지 좁힐 수 있습니다.
3. 규칙 해석 확인
규칙 이해도 확인:
"'소제목 3개 이상'이라는 규칙을 어떻게 적용할 거야?"
💡 디버깅 체크리스트
- 프론트매터 YAML 문법 오류 없는가?
- 규칙이 모호하지 않은가?
- 상충되는 규칙이 없는가?
- 출력 형식이 명확한가?
자주 발생하는 문제
| 문제 | 원인 | 해결 |
|---|---|---|
| 결과가 매번 다름 | 규칙이 모호함 | 구체적 수치로 변경 |
| 규칙을 안 따름 | 규칙이 너무 많음 | 핵심 규칙만 남기기 |
| 다른 스킬 실행됨 | 키워드 충돌 | 키워드 구체화 |
| $ARGUMENTS 안 됨 | 변수명 오타 | 정확히 $ARGUMENTS |
문제가 해결 안 되면 스킬을 처음부터 다시 만들어보세요. 의외로 작은 오타가 원인인 경우가 많습니다!
활성화 테스트 - 스킬 인식 확인
동작 테스트 - 시나리오 기반 검증
디버깅 - Claude에게 직접 질문
자주 하는 실수 - 모호한 규칙, 키워드 충돌
👉 커스텀 에이전트 : 서브에이전트로 복잡한 작업 분산하기
테스트와 디버깅으로 완성도 높은 스킬을 만드세요!
문제를 찾아 해결하는 것도 실력입니다! 🔍
댓글
댓글 쓰기