Claude Code 스킬 초보자 가이드 3편: 스킬 조합과 실전 개발 워크플로
Claude Code 스킬 초보자 시리즈 3편
자료 조사, 기능 구현, UI 개선, 보안 검토와 최종 점검을 단계별로 나누어 Claude Code 스킬을 조합하는 실전 워크플로를 소개합니다.
작업 단계를 분리하면 스킬 간 지침 충돌을 줄이고, 문제가 발생했을 때 어느 단계에서 잘못되었는지 확인하기 쉬워집니다.
- insane-search로 공개 자료 조사
- andrej-karpathy-skills 원칙으로 최소 기능 구현
- ui-ux-pro-max로 화면 개선
- VibeSec-Skill로 보안 위험 검토
- caveman으로 최종 결과만 간결하게 정리
- 여러 스킬은 어떤 순서로 사용해야 하나요?
- 초보자 실전 프로젝트는 어떻게 진행하나요?
- 스킬 지침이 충돌하면 어떻게 해결하나요?
- 작업 결과는 어떻게 검증해야 하나요?
- 자주 묻는 질문
여러 스킬은 어떤 순서로 사용해야 하나요?
스킬은 프로젝트 진행 순서에 맞춰 하나씩 사용하는 것이 가장 이해하기 쉽습니다. 모든 스킬을 동시에 호출하면 검색, 구현, 디자인, 보안과 답변 형식에 관한 지침이 섞일 수 있습니다.
| 단계 | 사용 스킬 | 목적 | 완료 기준 |
|---|---|---|---|
| 1. 조사 | insane-search | 공개 자료와 사용자 요구 조사 | 핵심 요구사항 목록 완성 |
| 2. 구현 | andrej-karpathy-skills | 최소한의 기능 구현 | 기본 기능과 테스트 통과 |
| 3. 디자인 | ui-ux-pro-max | 레이아웃과 사용성 개선 | 모바일과 접근성 확인 |
| 4. 보안 | VibeSec-Skill | 주요 취약점 검토 | 위험 목록과 수정 결과 확인 |
| 5. 정리 | caveman | 결과 보고 압축 | 변경·테스트·주의사항 요약 |
한 단계가 끝날 때마다 변경 내용을 확인하고 저장한 뒤 다음 스킬을 적용합니다. 이 방식은 문제가 생겼을 때 이전 상태로 돌아가기 쉽습니다.
초보자 실전 프로젝트는 어떻게 진행하나요?
간단한 할 일 관리 웹페이지를 만든다고 가정하고 조사부터 최종 검토까지 다섯 단계로 진행할 수 있습니다. 각 단계에서는 하나의 목표만 처리합니다.
1단계: 비슷한 서비스의 공개 정보를 조사합니다
“insane-search를 사용해 공개된 할 일 관리 서비스 소개 페이지와 사용자 의견을 조사해 줘. 초보 사용자가 중요하게 생각하는 기능을 5개 이내로 정리하고, 확인되지 않은 내용은 제외해.”
조사 결과에서 모든 기능을 구현하려 하지 말고 첫 버전에 필요한 기능만 선택합니다. 예를 들어 할 일 추가, 완료 처리, 삭제 정도로 범위를 제한할 수 있습니다.
2단계: 최소 기능을 구현합니다
“andrej-karpathy-skills의 원칙을 적용해 HTML, CSS, JavaScript로 간단한 할 일 목록을 만들어 줘. 할 일 추가, 완료 처리, 삭제 기능만 구현해. 로그인, 서버와 데이터베이스는 추가하지 마. 각 기능을 브라우저에서 확인할 수 있어야 해.”
Claude가 추가 기능을 제안하더라도 첫 버전에서는 구현하지 않는 것이 좋습니다. 기능이 많아지면 오류 원인을 찾기 어려워집니다.
3단계: 화면을 개선합니다
“ui-ux-pro-max를 적용해 현재 할 일 목록의 화면만 개선해 줘. 기능과 JavaScript 동작은 변경하지 마. 모바일에서 입력창과 버튼이 잘 보이고, 완료된 항목을 쉽게 구분할 수 있게 해.”
UI 변경 후에는 추가, 완료, 삭제 기능이 이전처럼 작동하는지 다시 확인해야 합니다.
4단계: 보안과 입력값을 검토합니다
“VibeSec-Skill을 적용해 사용자 입력 처리 방식을 검토해 줘. 입력값이 HTML로 실행될 위험, 지나치게 긴 입력, 빈 문자열과 예외 처리를 확인해. 먼저 문제만 설명하고 코드는 수정하지 마.”
검토 내용을 이해한 다음 필요한 항목만 수정합니다. 모든 코드를 한꺼번에 다시 작성하도록 요청하지 않습니다.
5단계: 결과를 간결하게 정리합니다
“caveman을 적용해 최종 결과를 정리해 줘. 변경한 파일, 구현된 기능, 테스트 결과, 남아 있는 위험과 다음 작업만 짧게 작성해.”
스킬 지침이 충돌하면 어떻게 해결하나요?
스킬이 서로 다른 행동을 요구하면 현재 작업에서 가장 중요한 기준을 직접 지정해야 합니다. 보안, 정확성, 기능 보존, 설명 길이 순서처럼 우선순위를 명확히 작성합니다.
대표적인 충돌 사례
- caveman은 설명을 줄이지만 보안 스킬은 상세한 위험 설명을 요구할 수 있습니다.
- UI 스킬은 구조 변경을 제안하지만 최소 수정 원칙은 기존 구조 유지를 요구할 수 있습니다.
- 검색 스킬이 다양한 사례를 제안해도 현재 프로젝트 범위에는 필요하지 않을 수 있습니다.
- 보안 개선 과정에서 기존 기능이나 호환성이 달라질 수 있습니다.
“우선순위는 1번 보안, 2번 기존 기능 유지, 3번 최소 수정, 4번 짧은 설명이야. 보안 문제와 테스트 결과는 caveman을 적용하더라도 생략하지 마.”
역할을 분리해서 요청합니다
하나의 요청에서 모든 작업을 수행하게 하지 말고 분석, 수정, 검증을 분리합니다.
- 분석: 문제와 위험을 찾습니다.
- 계획: 수정할 파일과 범위를 정합니다.
- 수정: 승인된 범위만 변경합니다.
- 검증: 기능과 테스트 결과를 확인합니다.
“지금은 분석만 하고 파일을 수정하지 마”라는 문장을 활용하면 Claude가 바로 큰 변경을 시작하는 것을 줄일 수 있습니다.
작업 결과는 어떻게 검증해야 하나요?
Claude가 작업 완료를 보고해도 사용자가 직접 변경 파일, 실행 화면, 테스트와 오류 메시지를 확인해야 합니다. AI가 만든 코드도 일반 코드와 동일한 검토 과정이 필요합니다.
1. 변경 파일을 확인합니다
- 요청하지 않은 파일이 수정되었는지 확인합니다.
- 환경변수와 비밀정보가 코드에 포함되지 않았는지 확인합니다.
- 기존 코드를 불필요하게 삭제하지 않았는지 확인합니다.
- 새로운 패키지가 추가되었다면 필요성을 확인합니다.
2. 정상 사용과 잘못된 사용을 모두 테스트합니다
버튼이 정상 작동하는지만 보지 말고 빈 입력, 긴 입력, 특수문자, 중복 클릭과 새로고침 같은 상황도 확인합니다.
3. 오류 메시지를 그대로 전달합니다
“브라우저 콘솔에서 다음 오류가 발생했어. 먼저 오류가 발생한 이유를 설명하고, 관련된 최소 범위만 수정해. 추측하지 말고 현재 파일을 확인한 뒤 답해.”
4. 작업 단위마다 저장합니다
Git을 사용한다면 조사, 기능 구현, UI 변경과 보안 수정 단계를 별도의 커밋으로 저장하는 것이 좋습니다. 문제가 생겼을 때 특정 단계만 되돌릴 수 있기 때문입니다.
결제, 개인정보, 로그인, 파일 업로드와 관리자 권한이 포함된 서비스는 AI 검토만으로 배포하지 않습니다. 별도의 보안 테스트와 경험 있는 개발자의 검토가 필요할 수 있습니다.
- 스킬을 작업 단계별로 나누어 적용합니다.
- 각 단계에 명확한 완료 조건을 설정합니다.
- 지침이 충돌하면 우선순위를 직접 지정합니다.
- 분석, 수정과 검증을 하나의 요청에 섞지 않습니다.
- Claude의 완료 보고와 별개로 결과를 직접 검증합니다.
자주 묻는 질문
다섯 가지 스킬을 모두 설치해야 하나요?
아닙니다. 현재 작업에 필요한 스킬만 설치하면 됩니다. UI 작업이 없다면 ui-ux-pro-max가 필요하지 않을 수 있고, 외부 자료 조사가 없다면 insane-search를 사용할 필요가 없습니다.
여러 스킬을 한 요청에서 동시에 지정해도 되나요?
가능하지만 초보자는 단계별로 나누어 사용하는 것이 좋습니다. 동시에 지정해야 한다면 보안, 기능 유지, 최소 수정과 답변 길이처럼 지침의 우선순위를 함께 작성해야 합니다.
Claude가 요청하지 않은 파일까지 수정하면 어떻게 해야 하나요?
작업을 중단하고 변경 파일 목록과 수정 이유를 먼저 확인합니다. 필요하지 않은 변경은 되돌린 뒤 수정 가능한 파일과 금지 영역을 명확히 지정해 다시 요청합니다.
Claude Code로 만든 서비스는 바로 배포해도 되나요?
바로 배포하기보다 기능 테스트, 모바일 확인, 오류 처리, 의존성, 개인정보와 보안 위험을 검토해야 합니다. 결제나 인증처럼 중요한 기능이 있다면 경험 있는 개발자나 보안 전문가의 추가 검토가 필요할 수 있습니다.
댓글