SERVICE PRODUCT MANAGEMENT · AI PLANNING GUIDE

기획의 전 단계를
AI로 가속하는 법

사전 조사부터 배포 후 분석까지, 기획 11단계에서 Claude Code와 스킬을 어떻게 활용하는지 실제 프롬프트와 예시로 정리한 위키입니다.

11
기획 단계
8+
사용 스킬
30+
실전 프롬프트
정책서 작성
5분
기존 1~2일
프로토타입 제작
5~10분
기존 2~3일
주간 트렌드 리포트
2분
기존 30분

전체 흐름 한눈에 보기

SPM실에서 쓸 수 있는 AI 도구

CORE TOOL · 실행 자동화
Claude Code
로컬 파일 직접 읽기·쓰기, MCP로 Confluence·GitHub·Figma 직접 조작
Skill — 반복 작업 명령어 한 줄 배포형 자동화
CLAUDE.md — 역할·스타일 영구 기억
MCP — Confluence 직접 업로드, 버전·minorEdit 포함
GPT가 초안을 건네면, Claude Code가 파일로 만들고 위키에 올립니다.
MAIN TOOL · 회사 지식 연동
ChatGPT Enterprise
Glean·Slack·Outlook 연동 검색·요약. Google Docs·Sheets 읽기/생성. 초안 발산에 적합.
사내 통합 검색
Glean
Claude Code MCP 연동 시 AI가 직접 검색
웹 검색 · 일본어
Gemini
시장·경쟁사 조사, 최신 웹 정보
문서 기반 Q&A
NotebookLM
PDF·기획서 업로드 후 출처 추적 Q&A
회의 자동화
Zoom AI
자동 요약·전사·액션아이템 추출

업무 흐름이 이렇게 바뀝니다

정책서 작성 — 기존 1~2일 → 약 5분
STEP 1
기획서 PDF
폴더에 저장
STEP 2
/wiki-policy
실행
STEP 3
Claude가
자동 분석
STEP 4
정책서
초안 작성
완료
Confluence
자동 업로드
프로토타입 제작 — 기존 2~3일 → 약 5~10분
STEP 1
화면 구성
텍스트 설명
STEP 2
/prototype
실행
STEP 3
Qoo10 디자인
HTML 자동 생성
STEP 4
/prototype-deploy
실행
완료
URL로
바로 공유
주간 리포트 자동화 — 기존 30분 → 약 2분
STEP 1
/weekly-report
실행
STEP 2
Glean으로
사내 동향 수집
STEP 3
트렌드·이슈
자동 분석
완료
Confluence
자동 업로드

스킬 매핑 표

단계 사용 도구 / 스킬 산출물 난이도
1-1 벤치마킹 Playwright MCP 경쟁사 화면 캡처 자동 수집 ★★★
1-2 아이디어 구상 /grill-me Claude Code 대화 아이디어 맵, 기획 방향 초안 ★☆☆
1-3 기존 정책 탐색 Glean MCP Wiki 검색 관련 정책 링크 정리 ★☆☆
1-4 데이터 분석 Claude Code + CSV 지표 요약, 차트 코드 ★★☆
2 플랫폼별 작업 범위 Claude Code 대화 기획 필요 화면/정책 목록 ★☆☆
3 정책 초안 /wiki-policy-draft 정책서 초안 (Confluence 업로드) ★★☆
4 화면 구성요소 Claude Code 대화 화면별 컴포넌트 목록 ★☆☆
4.5 UX 플로우 다이어그램 /ux-flow FigJam 플로우 차트 + Mermaid 코드 ★☆☆
5 프로토타입 /prototype /prototype-deploy HTML 프로토타입 + URL ★★☆
6 기획서 초안 /spm-pptx 화면 정의서 PPTX ★☆☆
7 리스크 검토 /review-spec 누락·모순·리스크 리포트 ★☆☆
8 Wiki 업데이트 /wiki-policy Confluence 정책서 자동 업로드 ★★☆
9 QA TC 도출 Claude Code 대화 TC 테이블 (화면·조건·기대결과) ★☆☆
10 자동 QA Playwright MCP 자동화 테스트 스크립트 ★★★
11 데이터 분석 Claude Code + 데이터 파일 지표 분석 리포트 ★★☆

교육 운영 가이드

2회차~n회차 교육 설계 시 참고하는 Q&A입니다.

Q1스킬 만드는 법 먼저 vs 사용법 먼저 — 어떤 순서가 좋을까?
사용법 먼저가 효과적입니다. 만들어진 스킬로 빠른 성공 경험을 쌓고 나서, 필요를 느낄 때 직접 스킬을 만들도록 순서를 구성하세요.

권장 순서: 2~4회차 → 기존 스킬 실습 (결과물 중심) → 5회차 이후 → 스킬 구조 이해 + 직접 만들기
Q2스킬 설치는 GitHub 접근이 전제 — 어떻게 진행할까?
사전 과제로 SSH 키 등록을 먼저 요청하고, 교육 당일 설치 실습을 진행하는 것이 가장 매끄럽습니다.
GitHub 접근이 안 되는 분은 강사 공유 폴더의 스킬 파일을 수동 복사해도 동일하게 사용할 수 있습니다.

사전 과제: github.corp.ebay.com SSH 접속 확인
교육 당일: /plugin marketplace add [마켓플레이스 URL] 실행
Q3같이 실습 vs 시연 — 어느 방식이 더 효과적일까?
핵심 2~3개는 같이 실습, 나머지는 시연 + 따라하기 구성을 권장합니다.

같이 실습 (반드시): /prototype (화면 제작 경험), /review-spec (즉각 피드백 경험)
시연으로 충분: 벤치마킹 자동 수집, Wiki 업로드, QA 자동화

이유: 시간 대비 효과가 높은 것은 "내가 직접 해봤다"는 경험입니다. 모두 같이 하면 시간이 부족하고 집중도가 떨어집니다.
Q4내가 가진 스킬을 기획 단계에 맞게 정의하려면?
아래 표의 "회차별 교육 계획"을 기준으로 각 단계에 매핑된 스킬을 교육에 배치하세요.
기존에 없는 스킬(아이디어 구상, 데이터 분석 등)은 Claude Code 대화로 대체하거나, 교육 후 스킬 생성 실습으로 연결할 수 있습니다.

회차별 교육 계획 (권장)

회차주제핵심 실습시간
1회차 (완료) Claude Code 입문, 기본 대화, 첫 프로토타입 Claude Code 설치 · 첫 대화 · /prototype 체험 2h
2회차 스킬 설치 + 기획 사전 작업 자동화 SSH 설정 → 마켓플레이스 설치 → 벤치마킹 자동 수집 → /grill-me 아이디어 구상 2h
3회차 프로토타입 → PPTX → 배포 완주 /prototype 다중 화면 → /prototype-deploy → /spm-pptx 2h
4회차 정책서 자동 작성 + 리스크 검토 /wiki-policy-draft → /review-spec → /wiki-policy 업로드 2h
5회차 QA TC 도출 + 자동화 QA 시연 TC 생성 프롬프트 → Playwright 자동 QA 시연 2h
n회차 나만의 스킬 만들기 스킬 파일 구조 이해 → 커스텀 스킬 작성 → 마켓플레이스 PR 2h

효과적인 프롬프트 작성법

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과 비교했을 때 차이점 을 분석해서 표로 정리해줘.

설치 확인

주의: 로그인이 필요한 서비스는 직접 로그인 후 세션 쿠키를 사용하거나, 로그인 단계를 프롬프트에 포함시켜야 합니다.
실무 사례: Discovery — 리서치 & 경쟁사 분석 — 팀 내 실제 경쟁사 벤치마킹 사례를 확인하세요.

2아이디어 구상 — /grill-me로 생각 정리하기

아이디어가 막연하거나 기획 방향이 정해지지 않은 초기 단계에서 가장 효과적인 방법은 Claude Code에게 질문을 받는 것입니다. /grill-me 스킬은 AI가 기획자처럼 집요하게 질문해서 생각을 구체화합니다.

사용 스킬: /grill-me — 인터뷰 방식으로 기획 방향을 구체화하는 스킬

/grill-me 사용법

프롬프트 예시 1 — 새 기능 아이디어 구체화
/grill-me 오프라인 매장 QR 체크인 기능을 기획하려고 해. 아직 구체적인 그림이 없는 상태야. 질문해줘.
프롬프트 예시 2 — 기존 기능 개선 방향 탐색
/grill-me Qoo10 회원가입 전환율을 높이는 방법을 기획하려고 해. 현재 이탈률이 높은 구간은 이메일 인증 단계야. 어떤 방향으로 개선할 수 있을지 질문해서 아이디어를 구체화해줘.
팁: /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
MENUINFO
신규 신청하기
샘플하우스 신청이력
샘플하우스 승인 관련 신규 템플릿 생성
기존 샘플하우스 주문 표시
판매불가 상태 주문 예외 처리
교환/반품 불가 처리
취소 불가 처리
샘플하우스 주문 표시
샘플하우스 주문 제외 또는 주문 금액 0원 표시 체크
샘플하우스 주문 표시
샘플하우스 주문 제외 또는 주문 금액 0원 표시 체크
ADMIN
MENUINFO
신규 신청이력관리
기존 샘플하우스 주문 표시
샘플하우스 주문 표시
샘플하우스 주문 표시
취소/교환/반품 불가 처리
샘플 주문 제외 또는 주문 금액 0원 표시 체크
샘플하우스 주문 조회 메뉴 추가
취소선 항목: 검토 결과 범위에서 제외된 메뉴입니다. 삭제하지 않고 남겨두면 "왜 제외했는지"가 기록으로 남아 나중에 유용합니다.

3정책 초안 작성 — /wiki-policy-draft

기획 방향이 정해졌다면 정책서 초안을 작성할 차례입니다. /wiki-policy-draft는 사내 Glean 문서를 참고해 정책서 초안을 자동 생성합니다.

사용 스킬: /wiki-policy-draft — 상위 기획 단계의 정책서 초안 작성. 마켓플레이스에서 설치 필요.

사용법

프롬프트 예시
/wiki-policy-draft 오프라인 매장 간편 회원가입 정책서 초안을 작성해줘. 배경: - 스마레지 POS 시스템과 Qoo10 회원 연동 - 매장 방문 고객의 간편 가입 (이름 + 전화번호) - 가입 후 즉시 포인트 적립 가능 Glean에서 기존 회원 정책 문서를 먼저 참고해줘.
결과물: 10개 섹션 구조의 정책서 초안이 자동 생성됩니다. 이후 /wiki-policy로 Confluence에 업로드할 수 있습니다.
실무 사례: 정책서 초안 작성하기 · Definition — 기획서 & 정책서 작성 — 팀 정책서 작성 실사례를 확인하세요.

4프로토타입을 위한 화면별 구성요소 정의

프로토타입을 만들기 전에 화면별로 어떤 요소가 있어야 하는지 정의해두면 훨씬 정확한 결과물이 나옵니다.

프롬프트 예시 — 화면 구성요소 도출
오프라인 매장 간편 회원가입 플로우에서 필요한 화면 목록과 각 화면의 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 발급 - 전화번호 중복 시: 오류 안내 → 로그인 화면으로 이동 - 네트워크 오류 시: 재시도 팝업
프롬프트 예시 2 — Mermaid만 생성
/ux-flow 샘플하우스 예약 플로우를 Mermaid 코드로 만들어줘. 자격 확인 분기(충족/미충족), 예약 가능/불가 분기 포함.

Mermaid 코드 예시

WHAT IS MERMAID
텍스트 코드로 플로우 차트를 그리는 오픈소스 언어입니다. 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에서 먼저 검색한 뒤 이를 기반으로 다이어그램을 생성합니다. 유사 플로우가 있으면 자동으로 참고합니다.

생성 결과물 활용

실무 사례: AI를 사용하여 UX 플로우 자동 생성하기 — 실제 화면 플로우 생성 예시를 확인하세요.

5프로토타입 제작 — /prototype

화면 구성요소가 정의되면 바로 프로토타입을 만들 수 있습니다. /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 전용 지식베이스를 기반으로 답변합니다.

AI Assistant for eBay Japan
GLEAN 에이전트 활용

일본어 번역이 필요하다면 Glean > 에이전트 > 일본어 번역 및 검수를 이용하세요. Qoo10 서비스에 맞는 언어 스타일로 번역됩니다. (나카무라 유헤이님 제작)

일본어 번역 및 검수

문제가 생겼을 때

증상해결 방법
gh 명령어 없음brew install gh
인증 오류gh auth login --hostname github.corp.ebay.com
저장소 생성 실패VPN 연결 상태 확인
URL 접속 안 됨배포 후 2~3분 대기 후 재시도

실제 예시

오프라인 간편 회원가입 프로토타입 (5화면)
offline-login.pages.dev
실무 사례: Delivery — 프로토타입 & 배포 — 실제 프로토타입 제작 및 GitHub Pages 배포 사례를 확인하세요.

6기획서 초안 — /spm-pptx

/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 포함 구조 분석)
배포 URLGitHub Pages 또는 Cloudflare URL 입력정확 (실제 렌더링 기반)
PDF와이어프레임·기획서 PDF 경로 입력보통 (텍스트·이미지 추출)

생성되는 슬라이드 구조

슬라이드내용
1표지 — 프로젝트명, 작성자, 날짜, eBay 로고
2Version 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장: 버튼 비활성/활성, 비밀번호 강도 단계, 체크박스 일부/전체 등 상태가 달라지면 별도 슬라이드로 분리합니다. 예외·에러 메시지는 화면 별 표 슬라이드로 바로 뒤에 삽입하여 개발자가 구현 중 바로 참조할 수 있게 합니다.

기본 사용법

Claude Code에서 실행
/spm-pptx # Claude가 단계별로 정보를 질문합니다 (프로젝트명 → 프로토타입 경로 → 정책서)
프로토타입 경로와 함께 바로 실행
/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-pptxspm_pptx_builder.py~/Documents/Projects/SPM_Templates/에 있어야 실행됩니다. 처음 사용 시 팀 마켓플레이스에서 템플릿 파일을 먼저 설치하세요.
실무 사례: Definition — 기획서 & 정책서 작성 — 화면 정의서 및 기획서 작성 실사례를 확인하세요.

7리스크 검토 — /review-spec

기획서를 작성한 후 리뷰 전에 /review-spec을 사용하면 누락된 케이스, 모순된 조건, 기술 리스크를 자동으로 찾아줍니다.

사용 스킬: /review-spec — 기획서 파일 또는 정책 내용을 텍스트로 붙여넣어 실행
프롬프트 예시 — 파일 기반 검토
/review-spec # ~/Documents/Projects/offline_store/spec_v1.md 파일 기반으로 검토
프롬프트 예시 — 텍스트 기반 검토
/review-spec 아래 정책을 검토해줘: - 오프라인 매장 방문 시 MY QR로 체크인 - 체크인 성공 시 방문 포인트 100P 즉시 적립 - 하루 1회만 적립 가능 - 포인트는 다음날 0시에 사용 가능
출력 예시: "포인트 적립 시점과 사용 가능 시점 사이 취소 처리 정책이 누락됨", "하루 1회 기준이 JST 기준인지 UTC 기준인지 명시 필요" 등의 피드백이 나옵니다.

8정책서 Wiki 업데이트 — /wiki-policy

확정된 기획서를 Confluence에 정책서로 올립니다. /wiki-policy는 로컬 기획서 파일을 읽어 Confluence Storage Format으로 변환 후 자동 업로드합니다.

사용 스킬: /wiki-policy — wiki-server MCP가 연결되어 있어야 합니다.
프롬프트 예시
/wiki-policy # 또는 파일 경로를 명시 ~/Documents/Projects/offline_store/policy_v2.md 파일을 기반으로 Confluence SPMT 스페이스에 정책서를 업로드해줘. 상위 페이지 ID: 12345678
주의: 업로드 전에 반드시 현재 Confluence 페이지 버전을 확인하고, minorEdit 옵션을 사용해 팀원에게 알림이 가지 않도록 합니다.

일본어 번역 — Glean 번역·검수 에이전트

기획서, 정책서, Wiki 등 문서를 일본어로 번역하거나 검수할 때는 eBay 사내 Glean에서 제공하는 전문 번역·검수 에이전트를 사용합니다. 이 에이전트는 Qoo10 서비스 용어와 사내 맥락을 반영한 번역을 제공합니다.

사용 도구: Glean 일본어 번역 및 검수 에이전트 — 사내 Glean 계정으로 접속 후 사용.

접속 방법

활용 예시

활용 예시 1 — 정책서 일본어 번역
아래 정책 내용을 일본어로 번역해줘. 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는 시간이 있을 때 검증하는 케이스로 분류해줘.
실무 사례: AI를 사용하여 TC 자동으로 생성하기 — TC 자동 생성 실무 적용 사례를 확인하세요.

10TC 기반 자동 QA — Playwright

도출된 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개) - 잘 된 것 - 개선 필요한 것 - 다음 액션
실무 사례: Growth — 지표 & 리포트 자동화 · 위클리 트렌드 리포트 자동생성 — 배포 후 지표 분석 및 리포트 자동화 사례를 확인하세요.

스킬 설치 방법

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
STEP 2 — GitHub에 공개키 등록
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

설치되는 스킬 목록

스킬역할대응 단계
/prototypeQoo10 HTML 프로토타입 자동 생성5단계
/prototype-deployGitHub Pages 자동 배포5단계
/spm-pptx화면 정의서 PPTX 자동 생성6단계
/review-spec기획서 품질 검증7단계
/wiki-policy-draft정책서 초안 자동 작성3단계
/wiki-policyConfluence 정책서 자동 업로드8단계
/grill-me아이디어 구체화 인터뷰1-2단계
/weekly-reportJP/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 올리기

규칙: 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 후에도 동일)
원인PR #15가 플러그인 파일만 추가, marketplace.json 업데이트 누락
해결marketplace.json에 spm-pptx 엔트리 추가 → PR #19 생성
브랜치feat/add-spm-pptx-to-marketplace
PR URLgithub.corp.ebay.com/eBay-JapanPM/claude-pm-plugins/pull/19
상태팀 멤버 리뷰 대기 중 — 머지 후 Update marketplace 클릭으로 반영됨
터미널 작업 로그 — marketplace.json 업데이트 및 PR 생성
# 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 도구를 우선 사용