Community코딩 & 개발github.com

teefayb/claude-code-setup-demo

Zod 검증, 일관된 오류 처리 및 Vitest 테스트를 포함한 새 Next.js 라우트 핸들러를 src/app/api 아래에 추가합니다. API 엔드포인트를 추가하거나 확장하라는 요청을 받을 때 사용하세요.

claude-code-setup-demo란 무엇인가요?

이 스킬은 Next.js 애플리케이션에서 새로운 API 라우트 핸들러를 생성하는 과정을 자동화합니다. 사용자가 특정 API 엔드포인트를 추가하거나 확장하라고 요청하면, 이 스킬은 기존 코드베이스의 패턴을 분석하고 일관된 구조를 따르는 핸들러 코드를 생성합니다. 주요 특징은 Zod 스키마를 사용한 입력 검증, 일관된 오류 응답 형식, 데이터 접근 로직의 분리, 그리고 Vitest를 사용한 자동 테스트 생성입니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 활용할 수 있으며, 복잡한 웹 개발 작업을 안정적이고 일관된 방식으로 수행합니다. 이 스킬의 핵심 가치는 개발자가 직접 패턴을 파악하고 반복적인 코드를 작성하는 시간을 절약해주면서도, 팀의 코딩 규칙과 아키텍처를 자동으로 준수하도록 돕는다는 점입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/teefayb/claude-code-setup-demo/tree/HEAD/.claude/skills/add-api-route

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

여기에 설명된 API 라우트를 추가하세요: $ARGUMENTS

메서드, 경로 또는 동작이 명확하지 않으면 코드를 작성하기 전에 짧은 질문 하나를 먼저 하세요.

단계

  1. src/app/api/links/route.ts, src/lib/http.ts 및 src/lib/links/schema.ts를 읽어 기존 패턴과 일치시키세요. 새로운 오류 형식을 만들지 마세요.
  2. 입력 검증은 라우트 내부에 인라인으로 작성하지 말고, 해당 src/lib/<domain>/schema.ts에 Zod 스키마로 배치하세요.
  3. 데이터 접근은 src/lib/<domain>/store.ts에 배치하세요. 라우트 핸들러는 파싱, 스토어 호출, 결과를 응답으로 매핑만 수행합니다.
  4. src/app/api/<path>/route.ts를 생성하세요:
    • export const dynamic = "force-dynamic";
    • 잘못된 JSON → errorResponse(400, "invalid_json")
    • ZodError → validationError(err)
    • 찾을 수 없음 → errorResponse(404, "not_found")
    • 동적 세그먼트: { params }: { params: Promise<{ id: string }> } 및 await params.
  5. 라우트 옆에 route.test.ts를 작성하세요. @/test/temp-data-file에서 useTempDataFile()을 사용하고, new Request(...)로 내보낸 핸들러를 호출하세요. 다음을 포함해야 합니다: 성공, 각 검증 실패 클래스, 찾을 수 없음, 본문을 받는 경우 잘못된 JSON.
  6. npx vitest run <새 테스트 파일>을 실행한 후 npm run check, 그 다음 npm run build를 실행하세요.
  7. 보고: 엔드포인트 계약(메서드, 경로, 요청 본문, 상태 코드가 있는 응답) 및 실행한 명령어와 그 결과.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬