---
name: data-analysis-pipeline
description: 데이터 분석을 처음부터 끝까지 한 바퀴 돌려야 할 때 사용한다. "분석해줘", "이 데이터로 확인해줘", "OO가 뜬 것 같은데 맞나", "OO가 왜 떨어지나", "리포트까지 만들어줘", "처음부터 다시", "다음 단계", "어디까지 했지" 같은 요청. 개별 단계만 필요하면 1-hypothesis / 2-collect / 3-suspect / 4-report를 직접 쓴다.
---

# Data Analysis Pipeline — 4단계 오케스트레이터

**이 스킬은 순서만 관리한다.** 각 단계의 방법은 단계 스킬이 갖고 있다. 여기에 함정 목록·인터뷰 질문·디자인 스펙을 다시 쓰지 않는다.

> 한 줄: **판단은 사람, 반복은 코드, 함정은 체크리스트.**

---

## 4단계 = 스킬 4개

```
① 가설  →  ② 수집  →  ③ 의심  →  ④ 정리
```

| 단계 | 호출할 스킬 | 산출물 (완료 증명) |
|---|---|---|
| **① 가설** | `datapopcorn-analysis:1-hypothesis` | `hypothesis.md` |
| **② 수집** | `datapopcorn-analysis:2-collect` | `data/clean/` + `collection_report.md` + `preprocessing_report.html` |
| **③ 의심** | `datapopcorn-analysis:3-suspect` | `eda_report.html` + `traps_check.md` |
| **④ 정리** | `datapopcorn-analysis:4-report` | `findings.md` + `report_YYYYMMDD.html` |

각 단계는 **Skill 툴로 해당 스킬을 호출**해서 실행한다. 단계 내용을 직접 처리하지 않는다.

### 스크립트 네이밍 (단계 스킬이 만든다)

`1_collect.py` · `2_preprocess.py` · `3_eda.py` · `4_analyze.py` — ①가설은 대화 단계라 스크립트가 없다.

---

## 시작점 — 두 경로

- **A. 가설 있음 / 데이터 없음** → ①부터 4단계 전부.
- **B. 파일 이미 있음** (엑셀·CSV 추출본, 매출, 캠페인 성과, CRM 등) → `input/`에 넣고 시작.
  - **가설이 있으면** ②부터. `hypothesis.md`를 먼저 쓴다.
  - **가설이 없으면** ①을 건너뛰지 않는다. `1-hypothesis`로 목표 인터뷰를 먼저 돌린다. "이 데이터로 뭐 보지"는 가설이 아니다.

어느 경로든 ③ 의심과 ④ 정리는 똑같이 통과한다.

---

## 체크포인트 규칙

1. 각 단계 실행 **전** 산출물 존재를 확인한다. 이미 있고 입력보다 새것이면 `✅ STEP N — 완료 (skip)` 출력 후 건너뛴다.
2. 각 단계 실행 **후** 산출물 존재를 확인한다. 없으면 그 단계 실패로 보고하고 **멈춘다**. 다음 단계로 가지 않는다.
3. `hypothesis.md`와 `traps_check.md`도 산출물이다. **코드가 없는 단계라는 이유로 건너뛰지 않는다.**
4. "처음부터 다시" → 산출물을 비우고 ①부터 재실행.
5. "다음 단계" / "어디까지 했지" → 산출물 존재를 스캔해 현재 위치를 보고하고 그 다음 단계를 실행.
6. 완료 시 산출물 경로를 목록으로 보고. 건너뛴 단계는 `(cached)` 표시.

### 진행 보고 형식

```
✅ STEP 1 가설  — hypothesis.md (cached)
✅ STEP 2 수집  — data/clean/orders.csv · preprocessing_report.html
▶  STEP 3 의심  — 실행 중...
   STEP 4 정리  — 대기
```

---

## 자동 vs 사람

- **✅ 코드**: 수집 · 정리 · 집계 · 차트 · 리포트 생성. 다음 주제는 **키워드·기간·컬럼만 바꿔** 재실행.
- **❌ 사람**: 가설 세우기 · 함정 판정 · "이 신호가 진짜냐 편향이냐" · 헤드라인 결정. AI가 그럴듯하게 답해도 **이걸 의심하는 게 분석가**다.

---

## 강제 규칙

1. **순서 고정** — ①→②→③→④. 단계를 새로 만들거나 순서를 바꾸지 않는다.
2. **단계는 스킬 호출로 실행** — 함정 목록·인터뷰 질문·디자인을 이 스킬에서 직접 처리하지 않는다.
3. **산출물 없으면 미완료** — 다음 단계로 넘어가지 않는다.
4. **가설 없이 ②로 가지 않는다** — `1-hypothesis`를 먼저 돌린다.
5. **`.env`로 키 관리** — 하드코딩 금지, `.gitignore`에 등록.
6. **재실행 가능하게 마무리** — 다음 주제에 그대로 굴러가는 코드로 남긴다.

---

## 흔한 실패

| 증상 | 원인 | 고치는 법 |
|---|---|---|
| 가설 없이 코드부터 짬 | 파일이 있어서 ①을 건너뜀 | `1-hypothesis` 먼저 |
| 단계 스킬을 안 부르고 직접 처리 | 이 스킬에 내용이 있다고 착각 | 여기엔 순서만 있다. Skill 툴로 호출 |
| 함정 통과 기록이 없음 | ③을 체크리스트 훑기로 대체 | `3-suspect`가 `traps_check.md`를 만든다 |
| 리포트 톤이 안 맞음 | ④를 직접 HTML 작성 | `4-report` 호출 |
| 중간에 끊긴 뒤 어디서 이을지 모름 | 산출물 스캔 안 함 | 체크포인트 규칙 5 |

---

## 메타

- **버전**: v4 (2026-08-11) — 4단계를 스킬 4개(`1-hypothesis`/`2-collect`/`3-suspect`/`4-report`)와 1:1 정렬. 이 스킬은 순서·산출물·체크포인트만 관리하는 오케스트레이터로 축소
- **단계 스킬**: `1-hypothesis` · `2-collect` · `3-suspect` · `4-report`
- **유지보수**: 단계의 *방법*이 바뀌면 단계 스킬을, *순서·산출물 규약*이 바뀌면 이 스킬을 고친다
