Community라이팅 & 에디팅github.com

AnjanJ/shipkit

Claude Code로 더 나은 코드를 배포하세요. Claude Code를 위한 스킬, 에이전트, 규칙 및 지식 베이스입니다. codeberg.org/AnjanJ/shipkit의 미러입니다.

shipkit란 무엇인가요?

이 스킬은 Claude Code 환경에서 최근 변경 사항이나 특정 파일에 대해 체계적이고 자동화된 품질 보증(QA) 워크플로우를 제공합니다. 개발자는 `/qa` 명령어를 사용하여 감지된 테스트 프레임워크(RSpec, Minitest, ExUnit, Jest/Vitest, Playwright 등)를 기반으로 정찰(Reconnaissance), 인터뷰(Interrogation), 테스트 계획(Test Plan), 스펙 작성(Spec Writing), 실행 및 검증(Execution & Verification)의 5단계를 거칠 수 있습니다. 특히 위험도 기반 파일 분류, 사용자 질문을 통한 모호한 요구사항 해소, 구조화된 테스트 카테고리(행복 경로, 에지 케이스, 오류, 악의적 입력, 성능, 통합) 제시를 통해 실수를 줄이고 테스트 품질을 높입니다. Phase 2의 질문과 Phase 3의 계획 승인을 위해 `AskUserQuestion`을 사용하므로 포크된 스킬이 아닌 인라인 실행이 필요하며, 큰 변경 사항은 `codebase-explorer` 에이전트에 위임할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add AnjanJ/shipkit

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

/qa — 품질 보증 워크플로우

이 스킬을 실행하여 최근 변경 사항이나 특정 파일에 대해 철저한 QA를 수행합니다.

최근 변경된 파일

!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "감지된 최근 변경 사항 없음"

Phase 1: 정찰

  1. 테스트 프레임워크 감지 — 다음을 확인합니다:
    • Gemfile에 rspec/minitest 포함 → RSpec 또는 Minitest
    • mix.exs → ExUnit
    • package.json에 jest/vitest 포함 → Jest 또는 Vitest
    • playwright.config → Playwright
  2. 변경된 파일 식별 — $ARGUMENTS가 파일 경로이면 해당 파일을 사용하고, 그렇지 않으면 git diff --name-only HEAD~1 실행
  3. 각 파일을 위험 수준별로 분류:
    • CRITICAL: 인증, 결제, 데이터 모델, 공유 유틸리티, API 엔드포인트
    • HIGH: 비즈니스 로직, 서비스, 컨트롤러
    • MEDIUM: 뷰, 직렬화기, 헬퍼, 설정
    • LOW: 문서, 주석, 포맷팅
  4. 각 변경 파일과 기존 테스트(있는 경우)를 읽습니다. 변경된 파일이 약 5개를 초과하면 이 읽기 작업을 codebase-explorer 에이전트에 위임하고 요약본을 사용합니다. — 질문과 테스트를 위한 메인 컨텍스트를 유지합니다.
  5. 컨텍스트 테이블 구축:
파일유형위험기존 테스트?
............

Phase 2: 인터뷰

테스트를 작성하기 전에 AskUserQuestion을 사용하여 3~8개의 탐색 질문을 합니다. 질문은 한 번에 하나씩 묻지 말고 그룹으로 묶습니다.

좋은 질문 (위험 중심):

  • "이것이 결제 흐름에 영향을 미칩니다 — 환불 에지 케이스를 테스트해야 할까요?"
  • "새로운 유효성 검사가 빈 입력을 거부합니다. 유니코드 전용 문자열은 어떻게 처리하나요?"
  • "이 서비스가 외부 API를 호출합니다. 모의 객체를 사용할까요 아니면 통합 테스트를 할까요?"

나쁜 질문 (묻지 마세요):

  • "이 코드는 무엇을 하나요?" (직접 읽으세요)
  • "테스트를 작성해야 하나요?" (네, 항상 그렇습니다)
  • "어떤 테스트 프레임워크를 사용해야 하나요?" (감지합니다)

Phase 3: 테스트 계획

스펙을 작성하기 전에 먼저 구조화된 테스트 계획을 제시합니다. 카테고리별로 정리합니다:

테스트 카테고리

  1. 행복 경로 — 예상 입력이 예상 출력을 생성
  2. 에지 케이스 — 경계 값, 빈 입력, 최대 값, nil/null
  3. 오류 케이스 — 잘못된 입력, 네트워크 실패, 타임아웃, 권한 거부
  4. 불규칙/적대적 — SQL 인젝션 문자열, 스크립트 태그, 이모지, 10MB 문자열, 동시 접근
  5. 성능 — N+1 쿼리, 무제한 컬렉션, 느린 쿼리 (CRITICAL/HIGH 위험만 해당)
  6. 통합 — 컴포넌트 간 상호 작용 (여러 파일이 변경된 경우만)

표로 제시합니다:

#카테고리테스트 설명위험 수준
1행복 경로유효한 매개변수로 레코드 생성HIGH
............

진행하기 전에 사용자 승인을 기다립니다.

Phase 4: 스펙 작성

다음 패턴에 따라 스펙을 작성합니다:

  • 테스트당 하나의 단언 (실용적일 때)
  • 설명적인 이름 — it "레코드를 찾을 수 없을 때 404 반환" (it "작동함" 대신)
  • 정렬-실행-단언(Arrange-Act-Assert) 구조
  • 숨은 요소 없음 — 모든 테스트 데이터가 테스트 내에서 보여야 함
  • 구현이 아닌 동작 테스트 — private 메서드를 직접 테스트하지 않음
  • 프레임워크에 적합한 팩토리/픽스처 사용
  • describe/context 블록으로 동작별 그룹화

테스트 코드 품질

테스트도 코드입니다 — 동일한 원칙 적용:

  • KISS: 과도하게 설계된 테스트 헬퍼를 만들지 마세요. 설정이 10줄을 넘으면 테스트나 테스트 대상 코드를 단순화하세요.
  • YAGNI: 발생할 수 없는 시나리오를 테스트하지 마세요. 불가능한 상태에 대해 "만일을 대비해" 테스트를 추가하지 마세요.
  • DRY (절제하며): 영리한 공유 예제보다 명확한 중복을 선호하세요. 테스트는 3개의 헬퍼 파일을 건너뛰지 않고 위에서 아래로 읽을 수 있어야 합니다.
  • 클린 코드: 문서처럼 읽히는 설명적인 테스트 이름. 모든 데이터가 테스트 내에 보여야 하며 숨은 요소가 없어야 합니다.

프레임워크별 테스트 참고 사항(RSpec, Minitest, ExUnit, Jest/Vitest)은 @reference.md를 참조하세요.

Phase 5: 실행 및 검증

  1. 새로운 스펙 실행 — 대상 실행 (새 파일만)
  2. 실패 수정 — 오류 읽기, 소스 읽기, 근본 원인 수정
  3. 전체 테스트 스위트 실행 — 다른 것이 손상되지 않았는지 확인
  4. QA 보고서 생성 — 보고서 템플릿, 핵심 가치 감사 및 합리화 확인은 @reference.md를 참조하세요.

평결: SHIP IT / FIX AND RE-TEST / NEEDS REWORK

관련 스킬