---

name: prompt-generator description: AI 에이전트를 위한 고품질 프롬프트를 생성하는 스킬. 스킬/에이전트/MCP 서버/일반 코딩 작업을 위한 프롬프트를 한국어로 생성. 사용자가 "프롬프트 만들어줘", "프롬프트 생성", "프롬프팅 해줘", "~를 위한 프롬프트", "~하는 명령 만들어줘" 등을 요청할 때 트리거됨.

프롬프트 생성기

사용자의 요구사항을 분석하여 Claude Code에서 사용할 수 있는 고품질 프롬프트를 생성한다.

핵심 원칙

좋은 프롬프트의 3요소:

1. 명확성 - 모호함 없이 구체적으로 기술
2. 맥락 - 충분한 배경 정보 제공
3. 실행 가능성 - 바로 실행할 수 있는 단계로 구성

워크플로우

1. 프롬프트 유형 파악

사용자 요청에서 프롬프트 유형을 파악한다:

유형이 불명확하면 사용자에게 질문한다.

2. 요구사항 수집

필수 정보:

• 목적: 무엇을 달성하려는가?
• 맥락: 어떤 환경/프로젝트에서 사용하는가?
• 제약사항: 기술 스택, 규칙, 제한 등

선택 정보:

• 입력/출력 형식
• 예외 처리 방식
• 참고할 기존 코드/문서

정보가 부족하면 핵심 질문만 간결하게 물어본다.

3. 프롬프트 생성

유형별 가이드를 참조하여 프롬프트를 생성한다.

4. 출력

생성된 프롬프트를 다음 형식으로 출력:

Copy## 생성된 프롬프트

[프롬프트 내용]

반드시 아래 스크립트를 실행하여 클립보드에 복사:

Copycat << 'EOF' | scripts/copy_to_clipboard.sh
[프롬프트 내용]
EOF

---

좋은 프롬프트 vs 나쁜 프롬프트

예시 1: 기능 구현

나쁜 프롬프트:

Copy로그인 기능 만들어줘

• 기술 스택 불명
• 요구사항 불명확
• 제약사항 없음

좋은 프롬프트:

Copy# 기능 구현: JWT 인증 API

## 목표
JWT 기반 로그인/로그아웃 API 구현

## 맥락
- 프로젝트: Spring Boot 4.0 REST API
- 기술 스택: Java 21, Spring Security
- 관련 파일: src/main/java/.../auth/

## 요구사항
1. POST /api/auth/login - 이메일/비밀번호로 로그인, JWT 반환
2. POST /api/auth/logout - 토큰 무효화
3. Access Token 만료: 1시간, Refresh Token: 7일

## 제약사항
- 기존 UserRepository 활용
- DDD 아키텍처 준수

예시 2: 에이전트 생성

나쁜 프롬프트:

Copy코드 리뷰 에이전트 만들어줘

• 도구 지정 없음
• 출력 형식 불명
• 제약사항 없음

좋은 프롬프트:

Copy# 코드 리뷰어 에이전트 생성 요청

## 역할
PR 또는 코드 변경사항을 분석하여 리뷰 의견 제공

## 사용 시나리오
- "이 PR 리뷰해줘"
- "코드 변경사항 검토해줘"

## 필요 도구
- Bash: git diff, git log 실행
- Read: 변경된 파일 읽기
- Grep: 패턴 검색

## 작업 흐름
1. 변경된 파일 목록 확인 (git diff --name-only)
2. 각 파일의 변경 내용 분석
3. 코드 품질, 버그 가능성, 개선점 도출
4. 구조화된 리뷰 의견 작성

## 출력 형식
- 요약: 전체 변경사항 개요
- 이슈: 발견된 문제점 (심각도 표시)
- 제안: 개선 사항

## 제약사항
- 파일 수정 금지 (읽기만)

예시 3: 스킬 생성

나쁜 프롬프트:

CopyPDF 스킬 만들어줘

• 기능 범위 불명
• 트리거 조건 없음

좋은 프롬프트:

Copy# PDF 처리 스킬 생성 요청

## 목적
PDF 파일의 텍스트 추출, 페이지 회전, 병합 기능 제공

## 트리거 조건
- 키워드: PDF, 페이지 회전, PDF 병합, 텍스트 추출
- 맥락: 사용자가 PDF 파일 경로를 언급하거나 PDF 작업 요청 시

## 핵심 기능
1. 텍스트 추출 (pdfplumber 사용)
2. 페이지 회전 (90/180/270도)
3. 여러 PDF 병합

## 입력/출력
- 입력: PDF 파일 경로, 작업 유형
- 출력: 처리된 PDF 또는 추출된 텍스트

## 제약사항
- Python 환경 필요
- 암호화된 PDF는 비밀번호 필요

예시 4: MCP 서버 생성

나쁜 프롬프트:

CopyGitHub MCP 서버 만들어줘

• 도구 목록 없음
• 인증 방식 불명

좋은 프롬프트:

Copy# GitHub MCP 서버 생성 요청

## 목적
GitHub API와 연동하여 이슈, PR 관리 기능 제공

## 제공할 도구 (Tools)
| 도구명 | 설명 | 파라미터 |
|--------|------|---------|
| list_issues | 이슈 목록 조회 | repo, state, labels |
| create_issue | 이슈 생성 | repo, title, body |
| get_pr | PR 상세 조회 | repo, pr_number |

## 기술 스택
- 언어: Python (FastMCP)
- 의존성: httpx, fastmcp

## 인증/보안
- GitHub Personal Access Token (환경변수: GITHUB_TOKEN)
- 토큰 없으면 명확한 에러 메시지 반환

## 에러 처리
- Rate limit 초과: 재시도 안내 메시지
- 401/403: 토큰 확인 안내

---

프롬프트 품질 체크리스트

생성 전 각 항목을 검증한다:

필수 항목

유형별 추가 항목

스킬 생성:

• 트리거 키워드/맥락이 구체적인가?
• 핵심 기능이 3-5개로 명확한가?
• 입력/출력 형식이 정의되었는가?

에이전트 생성:

• 필요한 도구가 나열되었는가?
• 작업 흐름이 순서대로 기술되었는가?
• 제약사항(하면 안 되는 것)이 명시되었는가?

MCP 서버 생성:

• 제공할 도구(Tools) 목록이 표로 정리되었는가?
• 각 도구의 파라미터가 명시되었는가?
• 인증 방식이 정의되었는가?
• 에러 처리 방식이 기술되었는가?

일반 코딩:

• (버그) 재현 조건이 명시되었는가?
• (리팩토링) 현재 문제와 개선 방향이 있는가?
• (기능) 요구사항이 번호로 나열되었는가?

---

빠른 템플릿

기능 구현

Copy# 기능 구현: [제목]

## 목표
[한 문장 목표]

## 맥락
- 프로젝트: [프로젝트명]
- 기술 스택: [언어, 프레임워크]
- 관련 파일: [파일 경로]

## 요구사항
1. [요구사항 1]
2. [요구사항 2]

## 제약사항
- [제약 1]

버그 수정

Copy# 버그 수정: [현상]

## 재현 조건
1. [단계 1]
2. [단계 2]
→ 결과: [현재 결과] (예상: [기대 결과])

## 관련 파일
- [파일:함수명]

## 예상 원인
[추정 원인]

에이전트 생성

Copy# [에이전트명] 에이전트 생성

## 역할
[한 문장 역할]

## 사용 시나리오
- "[예시 요청 1]"
- "[예시 요청 2]"

## 필요 도구
- [도구]: [용도]

## 작업 흐름
1. [단계 1]
2. [단계 2]

## 제약사항
- [금지 사항]

스킬 생성

Copy# [스킬명] 스킬 생성

## 목적
[해결하려는 문제]

## 트리거 조건
- 키워드: [키워드 목록]
- 맥락: [활성화 상황]

## 핵심 기능
1. [기능 1]
2. [기능 2]

## 입력/출력
- 입력: [입력 형식]
- 출력: [출력 형식]

MCP 서버 생성

Copy# [서버명] MCP 서버 생성

## 목적
[연동할 서비스와 제공 기능]

## 제공할 도구
| 도구명 | 설명 | 파라미터 |
|--------|------|---------|
| [도구1] | [설명] | [파라미터] |

## 기술 스택
- 언어: [Python/TypeScript]
- 의존성: [라이브러리]

## 인증/보안
- [인증 방식]

## 에러 처리
- [에러 상황]: [처리 방식]