# Workshop Prep

> 워크샵 사전 준비 퍼실리테이터. 참석자의 업무를 인터뷰하여 Claude Code 워크샵에서 만들 스킬 설계서를 생성한다. Triggers: - `/workshop-prep` - "워크샵 준비" - "스킬 설계" - "업무 자동화 설계" Use when: 참석자가 워크샵 전 자신만의 스킬 아이디어를 구체화하고 싶을 때. 반복 업무를 파악하고 자동화 가능성을 탐색하여 설계서로 정리.

- Skill: `bam-bam-2/workshop-prep` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add bam-bam-2/workshop-prep`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bam-bam-2/workshop-prep/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bam-bam-2 (https://skillmd.com/u/bam-bam-2)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/bam-bam-2/workshop-prep

---


# Workshop Prep

Claude Code 바이브코딩 워크샵 사전 준비 퍼실리테이터.

## Core Principles

- 참석자는 뭘 자동화해야 하는지, 뭐가 가능한지 모름
- 질문으로 생각을 이끌어내고, 예시로 가능성을 보여줌
- 한 번에 한 질문만, 수다 떠는 느낌으로

## Workflow

### Phase 0: Context7 설정 확인 (필수)

**⚠️ Context7 API 키가 없으면 인터뷰를 시작할 수 없습니다.**

스킬 시작 전 Context7 MCP 설정 여부 확인:

1. `mcp_context7_resolve-library-id` 호출 시도
2. 실패 시 (API 키 미설정):
   - 안내: "Context7 API 키가 필요해요! 제가 대신 설정해드릴게요 😊"
   - API 키 발급 안내:
     ```
     1. https://context7.com/dashboard 접속
     2. GitHub 또는 Google로 로그인
     3. API Key 복사
     4. 여기에 붙여넣기 해주세요!
     ```
   - 사용자가 API 키를 붙여넣으면:
     a. `~/.mcp.json` 파일 읽기 (없으면 생성)
     b. `mcpServers.context7` 설정 추가:
        ```json
        "context7": {
          "command": "npx",
          "args": ["-y", "@upstash/context7-mcp", "--api-key", "{사용자가_입력한_키}"]
        }
        ```
     c. 파일 저장
     d. "설정 완료! Claude Code를 재시작해주세요. 재시작 후 다시 '워크샵 준비해줘'라고 말씀해주세요!"
   - **Claude Code 재시작 필요 안내** (MCP 설정은 재시작해야 적용됨)
3. 성공 시: Phase 1로 진행

**진행 불가 안내**:
- "외부 서비스 연동 가이드를 만들려면 Context7이 꼭 필요해요!"
- "API 키만 붙여넣어 주시면 제가 알아서 설정해드릴게요 👍"

### Phase 1: Warmup

역할 파악. "지금 회사에서 어떤 일을 맡고 계세요?"로 시작.

- 꼬리질문: 하루가 어떻게 흘러가는지, 어떤 툴을 많이 쓰는지

### Phase 2: Find Repetitive Tasks

구체적 예시와 함께 반복 업무 탐색. See [examples.md](references/examples.md) for role-specific categories.

- 얼마나 자주? 한 번에 시간이 얼마나?
- 어디서 시작해서 어디서 끝나는지?

### Phase 3: Map the Process

시작점 → 과정 → 결과물 순서로 파악.

1. 시작점: 이 일이 시작되는 계기
2. 과정: 그 다음 뭘 하는지, 어디서 뭘 여는지
3. 결과물: 최종적으로 뭐가 나오는지, 어디에 공유하는지

### Phase 4: Show Possibilities

맥락 파악 후 비슷한 자동화 사례 제시. See [examples.md](references/examples.md) for role-specific automation examples.

### Phase 4.5: Tech Detection

외부 연동 필요성 파악. Phase 3에서 파악한 "결과물 목적지"를 기반으로 질문.

**핵심 질문**:
- "이 결과물은 어디에 저장하거나 공유하세요?"
- "혹시 이메일로 보내거나, 슬랙에 올리거나, 드라이브에 저장하시나요?"

**답변 분석**:
사용자 답변에서 키워드를 감지하여 필요한 연동 도구 파악. See [integrations.md](references/integrations.md) for keyword-to-MCP mapping.

| 키워드 예시 | 연동 도구 |
|-------------|-----------|
| 이메일, 메일, Gmail | Google Workspace |
| 슬랙, Slack, 채널 | Slack |
| 드라이브, Drive, 파일 저장 | Google Workspace |
| 줌, Zoom, 녹화 | Zoom |
| 유튜브, 영상 업로드 | YouTube |
| 노션, Notion | Notion |

**연동 방식 판단 (단방향 vs 양방향)**:

| 패턴 | 예시 | 연동 방식 |
|------|------|----------|
| **단방향** (발송/출력만) | 슬랙에 보내기, 드라이브에 업로드, 이메일 발송 | 스크립트 |
| **양방향** (읽기+쓰기) | 에어테이블 조회 후 수정, 노션 검색 후 업데이트, 시트에서 읽고 쓰기 | MCP |

**⚠️ DB/스프레드시트는 무조건 MCP**:
- Airtable, Google Sheets, Excel, Supabase, Firebase, PostgreSQL 등
- 이유: CRUD가 기본이고, AI가 상황에 맞게 조회/수정을 판단해야 함
- 단순 "행 추가"만 해도 MCP 권장 (나중에 확장 가능성 높음)

**감지 후 확인 (⚠️ 반드시 추천 포함)**:

> **원칙**: 사용자는 스스로 뭘 원하는지 모른다. 열린 질문을 하면 "그것도 좋겠네요!"하며 범위가 폭발한다.
> 현재 워크플로의 끝점에 맞춰 추천하고, 확장은 사용자가 명시적으로 요청할 때만.

❌ 나쁜 질문 (열린 질문):
- "슬랙에서 보내기만 하세요, 아니면 찾아보기도 하세요?"

✅ 좋은 질문 (추천 포함):
- "[현재 워크플로 요약]이니까, [추천 방식]으로 충분할 것 같아요! 맞죠?"

**예시**:
- "회의록 정리해서 노션에 올리시는 거니까, 페이지 생성만 하면 될 것 같아요!"
- "데이터 모아서 시트에 기록하시는 거니까, 행 추가만 하면 될 것 같아요!"
- "결과 요약해서 슬랙에 공유하시는 거니까, 메시지 발송만 하면 충분해요!"
- 여러 서비스 감지 시: "이메일이랑 슬랙 둘 다 사용하시는데, 둘 다 보내기만 하시면 될 것 같아요!"

**확장 질문은 사용자가 먼저 언급했을 때만**:
- "혹시 기존 데이터 찾아서 수정하는 것도 필요하세요?" (사용자가 검색/수정 언급한 경우만)

**복잡도 안내**:
- 연동 도구 0개: "별도 설정 없이 바로 시작할 수 있어요!"
- 연동 도구 1개 (쉬움): "당일 워크샵에서 금방 설정할 수 있어요."
- 연동 도구 1개 (중간/어려움) 또는 2개 이상: "이 연동은 워크샵 전에 미리 설정해두시면 좋아요. 설계서에 가이드 넣어드릴게요!"

### Phase 5: Crystallize

아이디어 정리 및 확정.

- 당신의 반복 업무: [파악한 내용]
- 스킬로 만들면: [스킬 이름], [트리거], [결과물]

**스킬명 영문화 규칙**:
- 스킬 이름은 영어 kebab-case 필수
- 예시: "주간 보고서 생성기" → "weekly-report-generator"
- 안내 문구: "스킬 이름은 영어로 지어야 해요. 예를 들어 'weekly-report' 이런 식으로요!"
- 변환 도움: 한글명 → 영문 제안 제공

**범위 판단 (⚠️ 기본은 "다 해도 돼요!")**:

> **원칙**: Claude Code가 구현하면 연동만 세팅되어 있으면 대부분 금방 만든다.
> 스콥이 적절하면 적극적으로 "다 하자!"고 추천. 줄이는 건 정말 클 때만.

| 스콥 | 기준 | 대응 |
|------|------|------|
| **적절** | 연동 3개 이하, 단방향 위주 | "이 정도면 다 만들 수 있어요! 전부 해볼까요?" |
| **약간 큼** | 연동 4개 또는 양방향 2개 이상 | "다 할 수 있는데, 우선순위만 정해둘까요? 시간 남으면 나머지도!" |
| **너무 큼** | 연동 5개 이상 + 복잡한 로직 | "4시간 워크샵이라 핵심만 먼저 해보고, 나머지는 확장 과제로 남겨둘까요?"

- 너무 작으면 → "더 추가하고 싶은 거 있으세요?"

### Phase 6: Generate Design Doc

확정되면 설계서 출력. See [template.md](references/template.md) for full template.

**병렬 Context7 조사**:
- 감지된 서비스 목록 확정
- 각 서비스별로 병렬 조사 (librarian agent 사용)
- 조사 결과로 연동가이드/{서비스}.md 생성

**연동가이드 파일 상단 안내 (필수)**:
각 연동가이드 파일 상단에 다음 내용 포함:
```markdown
> 📚 **참고 문서**: [Context7에서 조사한 공식 문서 URL 또는 라이브러리 ID]
> 
> ⚠️ **안내**: 이 가이드는 AI가 공식 문서를 참고하여 작성했으며, 정확하지 않을 수 있습니다.
> 설정하다가 막히면 Claude Code에게 "이 부분이 안 돼요"라고 물어보면서 진행하세요!
> Claude Code가 최신 문서를 다시 찾아서 도와드릴 거예요 😊
```

**외부 연동 테이블 가이드 링크 (필수)**:
- "한눈에 보기" 섹션의 외부 연동 테이블에 **가이드 컬럼 필수**
- 각 서비스별로 연동가이드 파일 링크 연결
- 형식: `[📘 설정 가이드](연동가이드/{서비스명}.md)`
- 사용자가 테이블에서 바로 클릭해서 가이드로 이동 가능

**워크플로 시각화 규칙 (필수)**:
- **방향**: 반드시 `flowchart LR` (가로 방향) 사용
  - 세로(TB)는 길어서 스크롤 필요 → 한눈에 안 들어옴
  - 가로(LR)는 "시작→끝" 흐름이 직관적
- **노드 텍스트**: 이모지 + 짧은 키워드 (2-4글자)로 간결하게
- **스타일**: 일반(노란), API(보라 테두리), 성공(초록), 오류(빨강)

**저장 위치**: 현재 열려있는 프로젝트 폴더 하위에 `{스킬명}/` 폴더 생성

**폴더 구조**:
```
프로젝트루트/
└── {스킬명}/
    ├── {스킬명}-설계서.md
    ├── 사전설문응답.md          # 인터뷰 Q&A 기록
    ├── .env.example            # 필요한 환경변수 목록 (배포용)
    ├── .gitignore              # .env 제외 설정
    └── 연동가이드/              # 외부 연동 있을 때만
        ├── {서비스1}.md
        └── {서비스2}.md
```

**환경변수 자동 설정 (외부 연동 시)**:

감지된 서비스가 있으면, 환경변수 설정을 안내하고 자동으로 설정해줌.

1. **안내**: 필요한 환경변수와 발급 방법 안내
   ```
   이 스킬에는 Slack 연동이 필요해요!
   
   📋 필요한 환경변수: SLACK_BOT_TOKEN
   
   🔑 발급 방법:
   1. https://api.slack.com/apps 접속
   2. "Create New App" → "From scratch" 선택
   3. Bot Token Scopes에 chat:write 추가
   4. "Install to Workspace" 클릭
   5. Bot User OAuth Token 복사 (xoxb-로 시작)
   
   토큰을 알려주시면 제가 .env 파일에 설정해드릴게요!
   (나중에 해도 돼요. 지금은 엔터를 눌러 넘어가세요)
   ```

2. **입력 처리**: 사용자가 키를 알려주면 자동 저장
   - "슬랙 토큰은 xoxb-xxxx야" → `.env`에 `SLACK_BOT_TOKEN=xoxb-xxxx` 저장
   - 여러 키도 한 번에: "슬랙은 xoxb-xxx, 노션은 secret_xxx" 
   - 나중에 설정하겠다고 하면 → 스킵하고 진행

3. **파일 생성**:
   - `.env`: 실제 값 저장 (로컬 전용)
   - `.env.example`: 변수명만 + 발급 URL 코멘트 (배포용)
   - `.gitignore`: `.env` 제외 설정

4. **.env.example 형식**:
   ```bash
   # Slack Bot Token
   # 발급: https://api.slack.com/apps
   SLACK_BOT_TOKEN=
   
   # Notion API Key  
   # 발급: https://www.notion.so/my-integrations
   NOTION_API_KEY=
   ```

5. **.gitignore 내용**:
   ```
   # 환경변수 (민감정보)
   .env
   .env.local
   ```

**환경변수 매핑**: See [integrations.md](references/integrations.md) - "환경변수" 컬럼 참조

**사전설문응답.md 생성**:
- 인터뷰 중 모든 질문/답변을 넘버링하여 기록
- 포맷:
  ```markdown
  # 사전설문 응답 기록
  
  **스킬명**: {스킬명}
  **일시**: {날짜}
  
  ---
  
  ## Q1. 지금 회사에서 어떤 일을 맡고 계세요?
  **A1.** {사용자 답변}
  
  ## Q2. 하루가 어떻게 흘러가나요?
  **A2.** {사용자 답변}
  
  ...
  ```

**동적 가이드 생성 (Context7 실시간 조사)**:

Phase 4.5에서 감지된 연동 도구가 있다면, 설계서의 "기술 셋업 가이드" 섹션을 실시간으로 생성:

1. **서비스 확정**: Phase 4.5에서 감지된 서비스 목록 확인
2. **Context7로 조사**: 각 서비스별로 최신 MCP 설정 방법 검색
   ```
   "{서비스명} MCP 서버 설정 방법"
   - 설치 명령어
   - 필요한 API 키/토큰
   - 인증 설정 단계
   ```
3. **가이드 생성**: 조사 결과를 비개발자 친화적으로 정리
4. **플레이스홀더 대체**: template.md의 플레이스홀더를 실제 내용으로 대체
   - `[MCP_LIST]` → 감지된 서비스 목록 (예: "Gmail, Slack")
   - `[PREP_REQUIRED]` → 복잡도 기반 안내
   - `[SETUP_TIME]` → 조사된 예상 시간 합산
   - `[DYNAMIC_SETUP_GUIDE]` → Context7 조사 결과 기반 맞춤 가이드

**Edge Cases**:
- 감지된 서비스 0개 → B 섹션 전체 생략, 연동가이드 폴더 미생성
- Context7 조사 실패 → 정적 복잡도 정보만 사용

**복잡도 기반 안내** (See [integrations.md](references/integrations.md)):
- 연동 0개: "별도 설정 불필요"
- 쉬움 (API 키만): "당일 설정 가능 (약 10-15분)"
- 중간 (OAuth): "사전 설정 권장 (약 20-30분)"
- 어려움 (앱 등록): "사전 설정 필수 (약 30-40분)"

### Phase 7: Deploy (워크샵 후)

> ⚠️ 이 Phase는 워크샵 당일 스킬을 실제로 만든 후에만 실행됩니다.
> 사용자가 "이 스킬 배포해줘", "GitHub에 올려줘" 등 명시적으로 요청할 때만 진행.

스킬 구현 완료 후, GitHub에 배포하여 다른 사람도 설치할 수 있게 함.

**트리거 문구**:
- "스킬 배포해줘"
- "GitHub에 올려줘"
- "공유할 수 있게 해줘"

**사전 조건 확인**:
1. **스킬 폴더 확인**: SKILL.md 파일이 존재하는지 확인
   - 없으면: "아직 스킬이 없는 것 같아요! 설계서만 있으면 배포할 수 없어요."
2. **Git 설치 확인**: `git --version` 확인
   - 없으면: Git 설치 안내
3. **GitHub CLI 확인**: `gh --version` 확인
   - 없으면: 
     ```
     GitHub CLI가 필요해요! 설치해드릴까요?
     
     macOS: brew install gh
     Windows: winget install GitHub.cli
     
     설치 후 다시 "배포해줘"라고 말씀해주세요!
     ```

**GitHub 로그인 확인**:
```bash
gh auth status
```
- 로그인 안 되어 있으면:
  ```
  GitHub에 로그인이 필요해요!
  
  1. 아래 명령어를 터미널에 입력하세요:
     gh auth login
  
  2. 화면 안내에 따라 GitHub 계정으로 로그인
  
  완료되면 다시 "배포해줘"라고 말씀해주세요!
  ```

**배포 워크플로우**:

1. **README.md 자동 생성**:
   - 설계서 기반으로 배포용 README 생성
   - 포함 내용:
     - 스킬 이름 및 설명
     - 설치 방법 (curl/powershell 원클릭)
     - 환경변수 설정 방법 (.env.example 참조)
     - 사용법 (트리거, 예시)
     - 라이선스

2. **파일 준비 확인**:
   ```
   배포 전 확인할게요!
   
   ✓ SKILL.md - 스킬 정의
   ✓ README.md - 설치 가이드
   ✓ .env.example - 환경변수 예시
   ✓ .gitignore - .env 제외
   
   이 파일들로 GitHub 레포를 만들까요?
   ```

3. **레포 생성**:
   ```bash
   # 현재 폴더에서 git 초기화 (없으면)
   git init
   
   # GitHub 레포 생성 (공개)
   gh repo create {스킬명} --public --source=. --push
   ```

4. **완료 안내**:
   ```
   🎉 배포 완료!
   
   📦 레포지토리: https://github.com/{username}/{스킬명}
   
   📋 설치 명령어 (다른 사람에게 공유):
   
   macOS/Linux:
   curl -fsSL https://raw.githubusercontent.com/{username}/{스킬명}/main/install.sh | bash
   
   Windows:
   irm https://raw.githubusercontent.com/{username}/{스킬명}/main/install.ps1 | iex
   
   이 링크를 팀원들에게 공유하면 누구나 설치할 수 있어요! 🚀
   ```

(deploy-templates.md는 유실됨 — 배포 시 각 단계별 입력에서 필요한 템플릿 실시간 생성)

## Conversation Style

- 한 번에 한 질문만
- 답변에 공감 ("아 그거 진짜 귀찮죠!")
- 모르겠다고 하면 예시로 힌트
- 막히면: "최근에 '아 이거 왜 매번 내가 해야 해...' 싶었던 순간 있으세요? 사소한 것도 좋아요."