Claude Code를 잘 활용하려면 좋은 프롬프트를 작성하는 것이 핵심입니다. 아래 4가지 요소를 갖추면 결과물의 품질이 크게 달라집니다.
좋은 프롬프트의 4가지 요소역할(Role) + 맥락(Context) + 형식(Format) + 예시(Example) — 이 4가지를 갖출수록 Claude의 응답이 정확하고 재사용 가능해집니다.
역할 (Role)
어떤 전문가로 행동할지
"당신은 Qoo10 Japan 서비스 기획자입니다"처럼 역할을 명확히 지정합니다.
맥락 (Context)
배경 정보와 제약 조건
서비스 이름, 대상 사용자, 기존 정책 등 필요한 배경 정보를 함께 제공합니다.
형식 (Format)
원하는 출력 형태
"표로 정리", "번호 목록", "슬라이드 1장 분량"처럼 출력 형식을 지정합니다.
예시 (Example)
원하는 결과의 견본
예시를 1~2개 제시하면 Claude가 패턴을 파악하여 일관된 결과를 냅니다.
나쁜 프롬프트 vs 좋은 프롬프트
개선 전
회원가입 화면 만들어줘.
개선 후
당신은 Qoo10 Japan 모바일 앱 기획자입니다.
오프라인 매장용 간편 회원가입 화면을 만들어주세요.
조건: - 대상: 일본 현지 오프라인 방문 고객 - 입력 항목: 이름, 이메일, 비밀번호만 - 기존 ~/Projects/offline_store/screens/ 폴더의 디자인 시스템 유지
출력: HTML 파일 1개, 모바일 우선 레이아웃
개선 전
이 화면 분석해줘.
개선 후
당신은 Qoo10 Japan UX 분석가입니다.
첨부한 경쟁사 화면 캡처(Amazon Japan 포인트 교환 화면)를 분석해주세요.
아래 형식으로 정리해주세요: | 항목 | 경쟁사 | Qoo10 현황 | 도입 검토 |
특히 "포인트 만료 안내 UX"에 집중해서 분석해주세요.
현장 팁: 프롬프트가 길어도 괜찮습니다. 맥락이 풍부할수록 결과물 수정 횟수가 줄어듭니다. 처음에 2~3분 더 쓰면 수정 왕복 3~5번을 줄일 수 있습니다.
1벤치마킹: 경쟁사 화면 자동 수집
경쟁사 서비스의 화면을 수동으로 캡처하는 것은 시간이 많이 걸립니다. Playwright MCP를 사용하면 Claude Code가 브라우저를 직접 조작해 화면을 자동으로 수집합니다.
사용 도구: Playwright MCP (브라우저 자동화) — Claude Code에서 바로 사용 가능
기본 사용법
프롬프트 예시 1 — 단일 화면 캡처
브라우저로 아래 URL을 열고 화면을 캡처해줘.https://www.mercari.com/jp/signup/캡처 이미지를 ~/Documents/Projects/benchmark/mercari_signup.png 로 저장해줘.
프롬프트 예시 2 — 여러 경쟁사 일괄 수집
아래 URL 목록을 순서대로 열고 각각 캡처해줘.1. https://www.rakuten.co.jp/login/ → rakuten_login.png
2. https://paypaymall.yahoo.co.jp/signup → yahoo_signup.png
3. https://www.au-paymarket.auone.jp → aupay_top.png~/Documents/Projects/benchmark/ 폴더에 저장하고
각 화면의 주요 UI 요소(헤더, 입력폼, 버튼, 색상)를 표로 정리해줘.
프롬프트 예시 3 — UI 분석까지 포함
메루카리 회원가입 화면(https://www.mercari.com/jp/signup/)을 열어서:1. 화면 전체 캡처
2. 입력 필드 목록 (이름, 이메일, 비밀번호 등)
3. 버튼 텍스트와 위치
4. 에러 메시지 표시 방식 (빈 상태로 제출해서 확인)
5. 우리 Qoo10과 비교했을 때 차이점을 분석해서 표로 정리해줘.
설치 확인
1터미널에서 claude mcp add playwright npx @playwright/mcp@latest 실행
2claude mcp list로 playwright가 목록에 있는지 확인
3Claude Code를 재시작한 후 위 프롬프트를 사용
주의: 로그인이 필요한 서비스는 직접 로그인 후 세션 쿠키를 사용하거나, 로그인 단계를 프롬프트에 포함시켜야 합니다.
아이디어가 막연하거나 기획 방향이 정해지지 않은 초기 단계에서 가장 효과적인 방법은 Claude Code에게 질문을 받는 것입니다. /grill-me 스킬은 AI가 기획자처럼 집요하게 질문해서 생각을 구체화합니다.
사용 스킬:/grill-me — 인터뷰 방식으로 기획 방향을 구체화하는 스킬
/grill-me 사용법
프롬프트 예시 1 — 새 기능 아이디어 구체화
/grill-me오프라인 매장 QR 체크인 기능을 기획하려고 해.
아직 구체적인 그림이 없는 상태야. 질문해줘.
프롬프트 예시 2 — 기존 기능 개선 방향 탐색
/grill-meQoo10 회원가입 전환율을 높이는 방법을 기획하려고 해.
현재 이탈률이 높은 구간은 이메일 인증 단계야.
어떤 방향으로 개선할 수 있을지 질문해서 아이디어를 구체화해줘.
팁: /grill-me 이후 "지금까지 나온 내용을 기획 방향 요약 + 해결해야 할 과제 목록으로 정리해줘"라고 추가 요청하면 사전 기획서 초안이 바로 만들어집니다.
/grill-me 없이 아이디어 구상하기
스킬 없이도 Claude Code 대화만으로 아이디어를 구체화할 수 있습니다.
프롬프트 예시 — 직접 대화 방식
일본 이커머스 앱에서 오프라인 매장 연동 서비스를 기획하려고 해.아래 내용을 물어봐줘:
1. 사용자 진입 경로 (앱 어디서 접근?)
2. 매장 직원과 사용자 각각 어떤 화면이 필요한지
3. 오프라인-온라인 연동 시 기술적 제약이 있을지
4. 경쟁사는 어떻게 하고 있는지 (알고 있다면)
3기존 정책 탐색 — Glean으로 사내 문서 검색
새 기획을 시작하기 전에 기존 정책이 있는지 확인하는 것이 중요합니다. Claude Code에는 Glean MCP가 연결되어 있어 Confluence, Slack, GitHub 등 사내 전체 문서를 자연어로 검색할 수 있습니다.
사용 도구: Glean MCP (사내 문서 검색) — Claude Code에 기본 연결됨. 별도 설치 불필요.
Claude Code에서 Glean 사용하기
프롬프트 예시 1 — 기존 정책 탐색
Glean에서 "오프라인 매장 회원가입" 관련 문서를 찾아줘.
Confluence 문서 위주로 검색하고, 관련 정책 링크와 요약을 표로 정리해줘.
프롬프트 예시 2 — 관련 의사결정 이력 탐색
Glean에서 "QR 코드 회원 인증" 또는 "Q커넥트 정책" 관련 Confluence 페이지를 검색해줘.
내용이 있으면 핵심 결정사항을 bullet로 정리해줘.
프롬프트 예시 3 — 유사 사례 탐색
Glean에서 과거에 작성된 "회원가입 UI 개선" 관련 기획서나 정책서를 찾아줘.
작성자, 날짜, 링크, 핵심 내용을 표로 정리해줘.
활용 팁: 정책 탐색 결과를 "이 내용을 바탕으로 이번 기획에서 달라지는 부분과 이어가야 할 부분을 정리해줘"라고 요청하면 컨텍스트 파악이 빠릅니다.
4데이터 분석 — Claude Code로 지표 파악
기획 전에 데이터를 확인하면 근거 있는 기획이 가능합니다. CSV나 Excel 파일을 Claude Code에 붙여넣거나 파일로 전달하면 분석해줍니다.
사용 방법: 스킬 없이 Claude Code 대화로 진행. 데이터 파일을 ~/Documents/Projects/data/에 저장 후 경로를 알려주면 됩니다.
데이터 분석 프롬프트
프롬프트 예시 1 — CSV 분석 요청
~/Documents/Projects/data/signup_funnel_2026.csv 파일을 분석해줘.아래 내용을 알려줘:
1. 각 단계별 이탈률
2. 이탈이 가장 많은 단계
3. 주차별 트렌드 (있다면)
4. 개선이 필요한 단계 우선순위 (이유 포함)
프롬프트 예시 2 — 기획 근거 도출
아래 데이터를 보고 이번 기획의 "왜 이걸 해야 하는가"에 대한 근거를 3줄로 정리해줘.- 회원가입 완료율: 42%
- 이메일 인증 단계 이탈: 31%
- 소셜 로그인 선택 비율: 67%기획서 서두에 쓸 수 있는 문장 형태로 만들어줘.
2플랫폼 별 작업 범위
과제를 시작할 때 플랫폼(QSM, ADMIN, APP 등)별로 어떤 화면/메뉴가 영향을 받는지 표로 정리합니다. 신규 추가 항목과 기존 수정 항목, 그리고 제외 항목(취소선)을 구분해서 작성합니다.
사용 방법: 기획서나 요건 정의서를 Claude Code에 붙여넣으면 아래 형식의 표를 자동 생성합니다.
프롬프트 예시 — 플랫폼별 작업 범위 표 생성
아래 기획 내용을 바탕으로 플랫폼별 작업 범위를 표로 정리해줘.플랫폼: QSM, ADMIN, APP
각 플랫폼별로:
- 신규 추가 메뉴/화면
- 기존 수정 메뉴/화면
- 검토 후 제외된 항목 (취소선으로 표시)
- 각 항목의 작업 내용 (INFO)
형식: 플랫폼 헤더 / MENU 경로 / 신규·기존 구분 / INFO 내용
예시 — 샘플하우스 프로젝트 작업 범위
QSM
MENU
INFO
신규
프로모션 > 샘플하우스 신청관리
신청하기 샘플하우스 신청이력
메일
샘플하우스 승인 관련 신규 템플릿 생성
기존
배송/취소/미수취 > 배송관리
샘플하우스 주문 표시 판매불가 상태 주문 예외 처리 교환/반품 불가 처리
배송/취소/미수취 > 취소/반품/미수취
취소 불가 처리
정산관리 > 판매진행내역
샘플하우스 주문 표시 샘플하우스 주문 제외 또는 주문 금액 0원 표시 체크
정산관리 > 영수증
샘플하우스 주문 표시 샘플하우스 주문 제외 또는 주문 금액 0원 표시 체크
ADMIN
MENU
INFO
신규
Display > Sample House Management
신청이력관리
기존
Delivery > Shipping Management
샘플하우스 주문 표시
CSAdmin > Order Information
샘플하우스 주문 표시
CSCenter > ClaimManagement
샘플하우스 주문 표시 취소/교환/반품 불가 처리
Sales > CategorySummary
샘플 주문 제외 또는 주문 금액 0원 표시 체크
Sales > Sales Summary
샘플하우스 주문 조회 메뉴 추가
취소선 항목: 검토 결과 범위에서 제외된 메뉴입니다. 삭제하지 않고 남겨두면 "왜 제외했는지"가 기록으로 남아 나중에 유용합니다.
3정책 초안 작성 — /wiki-policy-draft
기획 방향이 정해졌다면 정책서 초안을 작성할 차례입니다. /wiki-policy-draft는 사내 Glean 문서를 참고해 정책서 초안을 자동 생성합니다.
사용 스킬:/wiki-policy-draft — 상위 기획 단계의 정책서 초안 작성. 마켓플레이스에서 설치 필요.
사용법
프롬프트 예시
/wiki-policy-draft오프라인 매장 간편 회원가입 정책서 초안을 작성해줘.
배경:
- 스마레지 POS 시스템과 Qoo10 회원 연동
- 매장 방문 고객의 간편 가입 (이름 + 전화번호)
- 가입 후 즉시 포인트 적립 가능
Glean에서 기존 회원 정책 문서를 먼저 참고해줘.
결과물: 10개 섹션 구조의 정책서 초안이 자동 생성됩니다. 이후 /wiki-policy로 Confluence에 업로드할 수 있습니다.
프로토타입을 만들기 전에 화면별로 어떤 요소가 있어야 하는지 정의해두면 훨씬 정확한 결과물이 나옵니다.
프롬프트 예시 — 화면 구성요소 도출
오프라인 매장 간편 회원가입 플로우에서 필요한 화면 목록과
각 화면의 UI 구성요소를 표로 정리해줘.예시 포맷:
| 화면명 | 주요 UI 요소 | 입력 필드 | 버튼 | 예외 처리 |
|--------|-------------|-----------|------|-----------|
프롬프트 예시 — 특정 화면 상세 정의
"간편 회원가입 Step 1" 화면의 구성요소를 상세하게 정의해줘.아래 항목을 포함해줘:
- 화면 제목과 설명 텍스트
- 입력 필드 목록 (필수/선택 여부, 유효성 조건)
- 버튼 텍스트와 활성/비활성 조건
- 에러 메시지 패턴
- 이전/다음 화면 연결
UXUX 플로우 다이어그램 — /ux-flow
화면 구성요소가 정리된 후 프로토타입 제작 전에 UX 플로우를 시각화합니다. /ux-flow는 이순원님이 개발한 플러그인으로, FigJam 다이어그램과 Mermaid 코드를 동시에 생성합니다.
사용 스킬:/ux-flow — 이순원(soonwlee) 제작, PR #9 머지 완료. 마켓플레이스 설치 후 사용 가능.
기본 사용법
프롬프트 예시 1 — 화면 플로우 생성
/ux-flow오프라인 매장 간편 회원가입 플로우를 그려줘.- 앱 진입 → QR 스캔 → Step 1 (이름/전화번호) → Step 2 (이메일, 선택) → 가입 완료 → MY QR 발급
- 전화번호 중복 시: 오류 안내 → 로그인 화면으로 이동
- 네트워크 오류 시: 재시도 팝업
텍스트 코드로 플로우 차트를 그리는 오픈소스 언어입니다. mermaid.live에 붙여넣으면 즉시 시각화되고 PNG/SVG로 다운로드할 수 있습니다.
생성 예시 — 샘플하우스 예약 플로우
flowchart TD A[앱 실행] --> B[샘플하우스 신청 화면]
B --> C{자격 확인}
C -->|미충족| D[안내 팝업\n자격 조건 표시]
C -->|충족| E[날짜 선택]
E --> F[타임슬롯 선택]
F --> G{예약 가능?}
G -->|불가| H[예약 불가 안내]
G -->|가능| I[예약 확정]
I --> J[MY QR 발급]
J --> K[방문 당일 QR 제시]
mermaid.live에서 위 코드를 붙여넣으면 즉시 플로우 차트로 변환됩니다. Notion의 /mermaid 블록, Confluence의 Mermaid 매크로에도 바로 삽입 가능합니다.
노드 색상 규칙 (v2.0)
노드 유형
색상
사용 예
Screen
#4353FF
화면 전환 노드
Decision
#7C3AED
분기 조건 (예약 가능?)
State / Loading
#1BC47D
로딩, 처리 중 상태
Error / Warning
#FF4D4D
오류 안내, 경고 팝업
TOBE 예정 변경
#F97316
향후 개선 예정 화면
Glean 연동: v2.0부터 기존 플로우 문서를 Glean에서 먼저 검색한 뒤 이를 기반으로 다이어그램을 생성합니다. 유사 플로우가 있으면 자동으로 참고합니다.
생성 결과물 활용
1Mermaid 코드 → mermaid.live에 붙여넣기 → PNG/SVG 다운로드
2Notion /mermaid 블록에 코드 삽입 → 바로 시각화
3Confluence Mermaid 매크로에 코드 삽입 → 정책서에 포함
4FigJam 다이어그램은 FigJam AI → Generate diagram으로 600초 내 생성
화면 구성요소가 정의되면 바로 프로토타입을 만들 수 있습니다. /prototype 스킬은 Qoo10 디자인 시스템을 적용한 HTML 프로토타입을 자동 생성합니다.
사용 스킬:/prototype + /prototype-deploy — Playwright MCP가 설치되어 있어야 합니다.
기본 패턴
프롬프트 예시 1 — 단일 화면
/prototype오프라인 매장 간편 회원가입 화면을 만들어줘.
화면 구성:
- 헤더: "간편 회원가입" 제목 + 뒤로가기
- 이름 입력 필드 (한자 가능)
- 전화번호 입력 필드 (일본 형식 090-XXXX-XXXX)
- "다음" 버튼 (미입력 시 비활성)
- 하단: "이미 회원이신가요? 로그인" 링크
Qoo10 디자인 가이드에 맞게 만들어줘.
프롬프트 예시 2 — 다중 화면 + 플로우
/prototype오프라인 회원가입 3단계 플로우를 만들어줘.
Step 1: 이름 + 전화번호 입력
Step 2: 이메일 입력 (선택) + 생년월일 (선택)
Step 3: 가입 완료 + MY QR 발급 안내
각 Step은 아코디언 방식으로 펼쳐지게 하고,
완료된 Step은 체크 아이콘으로 표시해줘.
프롬프트 예시 3 — 수정 요청
방금 만든 프로토타입에서:
1. "다음" 버튼 색상을 Qoo10 보라색(#7E4DFF)으로 바꿔줘
2. 전화번호 입력 시 자동으로 하이픈이 들어가게 해줘
3. Step 2는 Step 1 완료 후에만 활성화되도록 해줘
배포 (URL 공유)
배포가 필요한 이유
로컬 파일은 본인만 볼 수 있습니다. 배포 = URL 생성 — 팀원이 브라우저에서 바로 확인하고, 수정 후 재배포하면 같은 URL에서 즉시 반영됩니다. Confluence에 링크 삽입, 모바일 직접 확인도 가능합니다.
항목
GitHub Pages (권장)
Cloudflare Pages
접근 범위
사내 VPN 전용
인터넷 전체 공개
설정 난이도
보통 (CLI · 토큰 필요)
쉬움 (브라우저 업로드)
버전 관리
가능 (git 이력 유지)
불가
사용 시기
팀 내 리뷰 · 공식 공유
임시 확인 · 중요하지 않은 페이지
URL 형식
pages.github.corp.ebay.com/[ID]/[저장소]/
[프로젝트명].pages.dev
산출물 미리보기
오프라인통합회원전환_UXScenario_v1.2.pptx — Keynote로 추출한 실제 슬라이드
슬라이드 1 — 표지
슬라이드 7 — 일반 로그인 초기 상태
슬라이드 8 — 이메일 입력 중 (UI 상태 변화)
Cloudflare 주의: 외부 공개 URL입니다. 개인정보·사내 정책이 포함된 페이지는 반드시 GitHub Pages를 사용하세요.
GitHub Pages 배포
/prototype-deploy# 실행 후 출력되는 URL 예시:
# pages.github.corp.ebay.com/jeelim/offline-signup-prototype/
GLEAN 에이전트 활용
문제 해결 전, Glean > 에이전트 > AI Assistant for eBay Japan에서 먼저 검색해보세요. eBay Japan 전용 지식베이스를 기반으로 답변합니다.
GLEAN 에이전트 활용
일본어 번역이 필요하다면 Glean > 에이전트 > 일본어 번역 및 검수를 이용하세요. Qoo10 서비스에 맞는 언어 스타일로 번역됩니다. (나카무라 유헤이님 제작)
/spm-pptx 란?프로토타입(HTML·URL·PDF)을 분석해 화면 정의서 PPTX를 자동 생성하는 스킬입니다. UI 상태 변화마다 슬라이드 1장, 예외·얼럿 케이스는 표 슬라이드로 구성됩니다. 왼쪽 73%에 화면 목업, 오른쪽 27%에 구성요소 설명이 자동 배치됩니다.
3단계 흐름
STEP 1
기본 정보 입력
프로젝트명 / 작성자 정책서 (선택)
→
STEP 2
프로토타입 제공
HTML 경로 · URL PDF 중 선택
→
STEP 3
PPTX 자동 생성
Desktop에 파일 저장 수정 요청 가능
입력 유형 선택
유형
사용 방법
분석 수준
로컬 HTML
~/Documents/프로젝트/index.html 경로 입력
가장 정확 (JS 포함 구조 분석)
배포 URL
GitHub Pages 또는 Cloudflare URL 입력
정확 (실제 렌더링 기반)
PDF
와이어프레임·기획서 PDF 경로 입력
보통 (텍스트·이미지 추출)
생성되는 슬라이드 구조
슬라이드
내용
1
표지 — 프로젝트명, 작성자, 날짜, eBay 로고
2
Version History
3 (정책 있을 때)
섹션 간지: 정책
4 (정책 있을 때)
정책 본문 (NanumGothic 10pt)
N
섹션 간지: 화면 정의서
N+1
화면 A — UI 상태 1 (좌 73% 목업 + 우 27% Description)
N+2
화면 A — UI 상태 2 (버튼 활성, 입력 완료 등)
N+3
화면 A — 예외·얼럿 케이스 표 (해당 화면 바로 뒤 삽입)
N+4~
화면 B, 화면 C… 반복
핵심 원칙 — UI 상태 변화마다 슬라이드 1장: 버튼 비활성/활성, 비밀번호 강도 단계, 체크박스 일부/전체 등 상태가 달라지면 별도 슬라이드로 분리합니다. 예외·에러 메시지는 화면 별 표 슬라이드로 바로 뒤에 삽입하여 개발자가 구현 중 바로 참조할 수 있게 합니다.
/spm-pptx프로토타입: ~/Documents/Projects/offline_store/prototype/index.html
정책서: https://wiki.corp.ebay.com/pages/2308604419
위 내용으로 화면정의서 PPTX 만들어줘.
수정 요청 예시
2번 슬라이드 우측 설명에 아래 내용을 추가해줘:
- 전화번호 형식: 090/080/070만 허용
- 중복 전화번호 입력 시: "이미 등록된 번호입니다" 에러 표시
그리고 PPTX를 다시 생성해줘.
실무 예시 — 오프라인 통합회원 전환 UX Scenario
산출물 예시파일:오프라인통합회원전환_UXScenario_v1.2.pptx 프로젝트: Qoo10 오프라인 매장 — 기존 회원 → 오프라인 통합회원 전환 UX 플로우 내용: 회원 유형별 전환 경로(일반/간편/미가입), 단계별 화면 상태, 예외 케이스 표 포함 경로:~/Desktop/오프라인통합회원전환_UXScenario_v1.2.pptx
주의:/spm-pptx는 spm_pptx_builder.py가 ~/Documents/Projects/SPM_Templates/에 있어야 실행됩니다. 처음 사용 시 팀 마켓플레이스에서 템플릿 파일을 먼저 설치하세요.
아래 정책 내용을 일본어로 번역해줘. Qoo10 서비스 용어를 반영해줘.
[번역할 한국어 텍스트 붙여넣기]
활용 예시 2 — 기존 일본어 문서 검수
아래 일본어 텍스트의 번역 품질을 검수해줘.
자연스럽지 않은 표현, 서비스 용어 오류, 경어 사용 문제를 지적해줘.
[검수할 일본어 텍스트 붙여넣기]
언제 사용하나: 기획서(Step 6) 완성 후, Wiki 업로드(Step 8) 전에 일본어 버전이 필요한 경우, 또는 QA TC 번역 시 활용합니다.
9QA TC 도출
기획서를 바탕으로 QA에서 검증해야 할 테스트 케이스를 Claude Code가 자동으로 도출합니다.
프롬프트 예시 — TC 자동 생성
아래 화면 정의를 기반으로 QA 테스트 케이스를 만들어줘.화면: 오프라인 간편 회원가입 Step 1
- 이름 입력 (1~50자, 한자 허용)
- 전화번호 입력 (090/080/070 시작, 11자리)
- "다음" 버튼: 양쪽 필드 모두 입력 시 활성화TC는 아래 형식의 표로 만들어줘:
| No | 테스트 항목 | 입력값 | 기대 결과 | 분류 |
모든 경계값, 예외값, 정상케이스를 포함해줘.
프롬프트 예시 — 우선순위 포함
위 TC 목록에서 QA 우선순위(P1/P2/P3)를 추가해줘.
P1은 반드시 검증, P3는 시간이 있을 때 검증하는 케이스로 분류해줘.
도출된 TC를 Playwright 스크립트로 변환해 개발 화면에 자동 QA를 실행합니다. 반복적인 회귀 테스트에 특히 효과적입니다.
사용 도구: Playwright MCP — 브라우저를 직접 조작해 TC를 자동 실행
프롬프트 예시 — 자동 QA 실행
아래 테스트를 Playwright로 실행해줘.대상 URL: https://dev.qoo10.jp/offline/signup
테스트 케이스:
1. 이름 필드에 "田中太郎" 입력 → 정상 표시 확인
2. 전화번호 "090-1234-5678" 입력 → 다음 버튼 활성화 확인
3. 전화번호 "000-0000-0000" 입력 → 다음 버튼 비활성 확인
4. 빈 상태에서 다음 버튼 클릭 → 에러 메시지 표시 확인각 테스트 결과를 성공/실패로 정리해줘.
주의: 자동 QA는 개발 환경(dev) URL에서만 실행하세요. 프로덕션 환경에서는 절대 실행하지 않습니다.
11배포 후 데이터 분석
배포 후 실제 사용 데이터를 분석해 기획이 목적을 달성했는지 확인합니다.
프롬프트 예시 — 배포 후 지표 분석
~/Documents/Projects/offline_store/post_launch_data.csv 파일을 분석해줘.
기획 당시 목표:
- 간편 회원가입 완료율 70% 이상
- 가입 소요 시간 3분 이하
실제 데이터와 목표를 비교하고,
목표 미달 항목이 있다면 가능한 원인을 3가지 제안해줘.
프롬프트 예시 — 보고용 요약 작성
분석 결과를 팀장 보고용 슬라이드 1장 분량으로 요약해줘.
아래 형식으로:
- 배포 결과 요약 (숫자 2~3개)
- 잘 된 것
- 개선 필요한 것
- 다음 액션
SSH 키가 필요한 이유팀 마켓플레이스는 사내 GitHub(github.corp.ebay.com)에 호스팅됩니다. Claude Code가 저장소에 접근하려면 비밀번호 대신 SSH 키를 사용합니다. 최초 1회만 설정하면 이후 모든 설치·업데이트가 자동으로 동작합니다.
SSH 키 설정 — 3단계
STEP 1
키 생성
ssh-keygen 명령어
→
STEP 2
GitHub 등록
공개키 붙여넣기
→
STEP 3
연결 확인
ssh -T 테스트
STEP 1 — 터미널에서 SSH 키 생성
# 키 생성 (Enter 3번으로 패스프레이즈 없이 생성)ssh-keygen -t ed25519 -C "jeelim@ebay.com" -f ~/.ssh/id_ed25519_ebay# SSH 에이전트에 키 추가ssh-add ~/.ssh/id_ed25519_ebay# 공개키 출력 → 전체 복사cat ~/.ssh/id_ed25519_ebay.pub
3Title: MacBook-jeelim (구분 가능한 이름) / Key: 위에서 복사한 공개키 붙여넣기
4Add SSH key 클릭
STEP 3 — 연결 확인
ssh -T git@github.corp.ebay.com# 성공 시: Hi jeelim! You've successfully authenticated...
플러그인 마켓플레이스에서 스킬 찾기 · 설치하기
달라진 설치 방식 (2026-07)기존 터미널 명령어(/plugin marketplace add) 방식에서 GUI 기반 Plugins Marketplace로 전환되었습니다. SSH 키 설정 후 아래 4단계로 스킬을 설치할 수 있습니다.
STEP 1
Plugins 열기
상단 메뉴 → Plugins
→
STEP 2
Discover 탭
검색창에 스킬명 입력
→
STEP 3
Install 클릭
스킬 카드 선택
→
STEP 4
/reload-plugins
즉시 활성화
Installed
Discover
🔍 Search plugins...
weekly-report
JP/KR 이커머스 위클리 트렌드 리포트 생성 및 Confluence 발행
Install
prototype
Qoo10 브랜드 HTML 프로토타입 자동 생성
Install
email-weekly-report
위클리 트렌드 리포트 요약 이메일 발송
Install
spm-pptx
UX Scenario 화면 정의서 PPTX 자동 생성. Qoo10 브랜드 디자인 토큰 적용.
Install
wiki-policy
Confluence 정책서 자동 작성 및 업로드
Install
eBay Japan PM Team · github.corp.ebay.com
Update marketplace 버튼이 보이면 먼저 클릭하여 최신 목록을 갱신하세요. 스킬이 목록에 없을 경우 팀 마켓플레이스가 아직 등록되지 않은 상태입니다.
설치 완료 후 — 스킬 활성화
# Install 후 반드시 실행 — 세션 재시작 없이 즉시 반영/reload-plugins# 설치 확인 — 스킬 목록 조회/skills
설치되는 스킬 목록
스킬
역할
대응 단계
/prototype
Qoo10 HTML 프로토타입 자동 생성
5단계
/prototype-deploy
GitHub Pages 자동 배포
5단계
/spm-pptx
화면 정의서 PPTX 자동 생성
6단계
/review-spec
기획서 품질 검증
7단계
/wiki-policy-draft
정책서 초안 자동 작성
3단계
/wiki-policy
Confluence 정책서 자동 업로드
8단계
/grill-me
아이디어 구체화 인터뷰
1-2단계
/weekly-report
JP/KR 이커머스 트렌드 리포트
사전 조사
CLAUDE.md — 프로젝트 컨텍스트 파일
CLAUDE.md란?프로젝트 루트에 두는 마크다운 파일입니다. Claude Code가 대화를 시작할 때 자동으로 읽어 프로젝트 맥락을 파악합니다. "이 프로젝트는 어떤 서비스인가", "내 스타일은 무엇인가"를 적어두면 매번 설명할 필요가 없습니다.
CLAUDE.md 없을 때
매번 "Qoo10 Japan 서비스입니다"라고 설명
응답 스타일이 일정하지 않음
한국어/일본어 혼용 발생
프로젝트 파일 경로를 반복 입력
CLAUDE.md 있을 때
시작부터 맥락 인식 완료
한국어 응답, 간결한 스타일 자동 적용
이모지 없이 표 중심 출력
프로젝트 경로·이메일 자동 참조
CLAUDE.md 기본 템플릿
# ~/.claude/CLAUDE.md 또는 프로젝트 루트에 생성# 나는 누구인가
- 소속: eBay Japan, Service PM 2팀
- 역할: 서비스 기획 (뷰티, 패션, 회원, 보안, 티켓)
- 이메일: jeelim@ebay.com
## 응답 스타일
- 한국어로 응답
- 결과 중심, 간결하게
- 이모지 사용 금지
- 표 기반으로 정보 표현
## 주요 서비스
- Qoo10 Japan (qoo10.jp)
- 사내 도구: Confluence, Glean, GitHub Corp
꿀팁 — 자주 쓰는 명령어
/compact
컨텍스트 압축
대화가 길어져 느려질 때 사용합니다. 지금까지의 대화를 요약하여 새 컨텍스트로 전환합니다. 작업 흐름은 유지됩니다.
#기억
Auto Memory 저장
중요한 내용을 기억하게 하려면 메시지 앞에 #을 붙입니다. Claude가 자동으로 메모리 파일에 저장하여 다음 세션에서도 참조합니다.
/reload-skills
스킬 새로고침
새 스킬을 설치하거나 수정한 후 세션 재시작 없이 즉시 반영합니다. 마켓플레이스 업데이트 후 반드시 실행하세요.
●나만의 스킬 만들기
자주 쓰는 프롬프트 패턴이 있다면 스킬로 만들어두면 팀 전체가 편리하게 사용할 수 있습니다.
스킬이란?~/.claude/skills/ 폴더 안의 마크다운 파일입니다. 파일명이 스킬 이름이 됩니다.
스킬 파일 구조
# ~/.claude/skills/my-skill.md---
description: 이 스킬이 무엇을 하는지 한 줄 설명
---
## 역할
당신은 [역할]입니다.
## 지침
사용자가 이 스킬을 호출하면:
1. [첫 번째 할 일]
2. [두 번째 할 일]
## 출력 형식
[원하는 출력 형식 지정]
스킬 만들기 실습
Claude Code에 요청하는 프롬프트
아래 조건으로 스킬 파일을 만들어줘.스킬 이름: benchmark-summary
역할: 벤치마킹 화면 분석 결과를 Qoo10 관점으로 정리
지침:
1. 사용자가 경쟁사 화면 URL이나 캡처를 주면
2. 주요 UI 요소, 플로우, 차별점을 분석
3. "Qoo10에 적용 가능한 점"과 "우리가 이미 더 나은 점"을 구분해 표로 정리
~/.claude/skills/benchmark-summary.md 로 저장해줘.
마켓플레이스에 PR 올리기
1마켓플레이스 저장소를 fork 또는 branch 생성
2스킬 파일을 skills/ 폴더에 추가
3PR 제목: [skill] my-skill-name 추가
4리뷰 후 main 브랜치에 머지되면 팀 전체가 사용 가능
규칙: main 브랜치에 직접 push는 불가합니다. 반드시 브랜치 생성 → push → PR 순서로 진행하세요.
●실전 작업 기록 — 2026-07-01
이 섹션은Claude Code와 팀 마켓플레이스를 실제로 활용한 작업 사례를 기록합니다. 새로운 스킬을 팀 전체에 배포하기까지의 전체 흐름을 확인할 수 있습니다.
작업 1 — spm-pptx 마켓플레이스 등록 (PR #19)
PR #15에서 플러그인 디렉터리(plugins/spm-pptx/)가 추가되었지만, 팀 마켓플레이스 매니페스트(.claude-plugin/marketplace.json)에 등록이 누락되어 목록에 표시되지 않는 문제가 있었습니다. 루트 원인을 분석하고 PR #19로 수정했습니다.
구분
내용
문제
Discover 탭에 spm-pptx가 표시되지 않음 (Update marketplace 후에도 동일)
# 1. 브랜치 생성$ git checkout -b feat/add-spm-pptx-to-marketplace# 2. marketplace.json에 spm-pptx 엔트리 추가 (Claude Code가 자동 작성)# .claude-plugin/marketplace.json → 13개 → 14개 플러그인# 추가된 엔트리:{
"name": "spm-pptx",
"description": "UX Scenario 화면 정의서 PPTX 자동 생성...",
"source": {
"source": "git-subdir",
"url": "https://github.corp.ebay.com/eBay-JapanPM/claude-pm-plugins",
"path": "plugins/spm-pptx",
"ref": "main"
}
}# 3. 커밋 및 브랜치 push (MCP git-server 사용)# Commit SHA: 13846a7b610f4a7a383e274a06f5f6bce59f9b6e# 4. PR 생성→ PR #19 생성 완료# 제목: feat: spm-pptx 플러그인을 마켓플레이스 매니페스트에 등록# base: main ← feat/add-spm-pptx-to-marketplace
작업 2 — /weekly-report 스킬에 STEP 8 이메일 발송 추가
위클리 트렌드 리포트 Confluence 업로드가 완료된 직후 자동으로 이메일 발송 여부를 확인하고, 승인 시 /email-weekly-report 스킬을 즉시 실행하는 STEP 8을 추가했습니다.
~/.claude/commands/weekly-report.md — STEP 8 추가 내용
## STEP 8: 이메일 발송 확인STEP 7 완료 직후 사용자에게 질문:> "이메일도 지금 발송할까요?
> 수신인: jeelim, DL-eBay-Japan-SEL-SPMT, sukkim, namjupark, kabkim"- Yes → SPMT 페이지 URL을 인자로 /email-weekly-report 스킬 즉시 실행- No → 종료
핵심 패턴: 스킬에서 또 다른 스킬을 체이닝할 수 있습니다. STEP 7에서 Confluence URL이 확정된 시점에 사용자 승인을 받고 /email-weekly-report를 즉시 호출하는 구조입니다. 크론잡 없이, 작업 흐름 안에서 자연스럽게 자동화가 이어집니다.
오늘 배운 패턴
패턴
설명
마켓플레이스 디버깅
플러그인이 목록에 없을 때 → marketplace.json 매니페스트 등록 여부 먼저 확인
main 브랜치 보호
직접 push 불가 — 브랜치 생성 → push → PR 순서 필수
스킬 체이닝
한 스킬 완료 시점에 사용자에게 물어보고 다음 스킬을 자동 실행하는 방식
MCP 우선 사용
GitHub API 직접 호출(curl) 실패 시 MCP git-server가 인증을 내부에서 처리하므로 MCP 도구를 우선 사용