---
name: blank
description: 완성된 풀이 코드를 빈칸+TODO 연습용 버전으로 변환. 핵심 로직을 ____로 가리고 TODO 주석을 달아 복습·재풀이용 파일을 만들 때 사용.
---

# blank - 빈칸 연습용 코드 생성

완성된 알고리즘 풀이 코드를 **빈칸+TODO 연습 버전**으로 변환합니다.

## 사용법

```
/blank [파일경로 또는 코드]
```

**예시:**
- `/blank BOJ/1000~9999/5014/5014.java` - 파일 경로 지정
- `/blank` + 코드 붙여넣기 - 코드 직접 입력
- `/blank 5014` - 문제번호만 입력 → 해당 폴더에서 완성 파일 탐색

## 동작 방식

1. **대상 파일 확인**: 경로 또는 코드 수신. 경로만 있으면 Read로 읽기.
2. **핵심 로직 식별**: 아래 "빈칸 대상" 기준으로 가릴 부분 선정.
3. **빈칸 + TODO 삽입**: `____` 치환 및 `// TODO` 주석 작성.
4. **저장**: 원본 파일명에 `_blank` 접미사를 붙인 파일로 저장.
   - 예: `5014.java` → `5014_blank.java`
   - 이미 `_blank` 파일이 있으면 덮어쓸지 확인.

## 빈칸 대상 기준 (중요도 순)

### 반드시 가릴 것 (핵심 알고리즘 로직)
- 자료구조 초기화: `new LinkedList<>()`, `new PriorityQueue<>()` 등 → 타입만 `____`
- 핵심 조건문: `if (floor == G)` → `if (floor == ____)`
- 점화식·계산식: `floor + U`, `floor - D` → `____, ____`
- 방문 처리: `visited[next] = true` → `visited[____] = ____`
- BFS/DFS 큐·스택 조작: `queue.offer(...)` 인자 → `new int[]{____, ____}`
- DP 점화식: `dp[i] = dp[i-1] + dp[i-2]` → `dp[i] = ____ + ____`
- 반환값: 핵심 계산 결과 반환 부분

### 선택적으로 가릴 것 (흐름 파악용)
- 범위 체크 조건: `1 <= next && next <= F` → `1 <= next && next <= ____`
- 초기화 값: `dist + 1` → `dist + ____`

### 가리지 말 것 (뼈대/구조)
- import 문
- 클래스/메서드 시그니처
- 변수명 (파라미터로 받은 값)
- 단순 출력문
- 주석 자체
- **`main` 블록 전체** (테스트 케이스 배열·기댓값·PASS/FAIL 루프 포함)
  → `solution` 함수 바디만 빈칸 처리. `main`은 완성된 상태로 유지해야 실행해서 맞았는지 바로 확인 가능.

## TODO 주석 작성 규칙

빈칸이 있는 구간 **위**에 `// TODO N: 설명` 형태로 작성.

```
// TODO 1: 큐 생성 및 시작 상태 초기화
//   - int[] = {현재 층, 버튼 누른 횟수} 형태로 관리
//   - 시작 층(S) visited 처리
Queue<int[]> queue = new ____<>();
visited[S] = ____;
queue.offer(new int[]{____, ____});
```

**TODO 작성 원칙:**
- 번호는 코드 흐름 순서대로 (TODO 1, 2, 3 ...)
- 설명은 **무엇을** 해야 하는지 (정답은 주지 않음)
- 필요하면 힌트를 들여쓰기 `//   - ` 형태로 추가
- 힌트는 자료구조나 접근 방향 정도만 (구체적 코드 X)

## 출력 예시 (Java — BOJ 5014)

**원본:**
```java
Queue<int[]> queue = new LinkedList<>();
visited[S] = true;
queue.offer(new int[]{S, 0});

while (!queue.isEmpty()) {
    int[] cur = queue.poll();
    int floor = cur[0];
    int dist  = cur[1];

    if (floor == G) {
        return dist;
    }

    int[] nexts = {floor + U, floor - D};

    for (int next : nexts) {
        if (1 <= next && next <= F && !visited[next]) {
            visited[next] = true;
            queue.offer(new int[]{next, dist + 1});
        }
    }
}
```

**빈칸 버전:**
```java
// TODO 1: 큐 생성 및 시작 상태 초기화
//   - int[] = {현재 층, 버튼 누른 횟수} 형태로 관리
//   - 시작 층(S) visited 처리
Queue<int[]> queue = new ____<>();
visited[S] = ____;
queue.offer(new int[]{____, ____});

while (!queue.isEmpty()) {
    int[] cur = queue.poll();
    int floor = cur[0];
    int dist  = cur[1];

    // TODO 2: 목표 층 도달 시 버튼 횟수 반환
    if (floor == ____) {
        return ____;
    }

    // TODO 3: 다음 이동할 층 계산 (위로 +U, 아래로 -D)
    int[] nexts = {____, ____};

    for (int next : nexts) {
        // TODO 4: 유효 범위(1 ~ F) & 미방문 체크 후 큐에 추가
        if (1 <= next && next <= ____ && !visited[____]) {
            visited[____] = ____;
            queue.offer(new int[]{____, ____});
        }
    }
}
```

## Python 빈칸 표기

Python은 `____` 대신 동일하게 `____` 사용 (문자열로 치환).
주석은 `# TODO N: 설명` 형태.

```python
# TODO 1: 큐 초기화 및 시작 노드 삽입
queue = deque()
visited[start] = ____
queue.append((start, ____))
```

## 난이도 조절

사용자가 명시하면 조절 가능:
- `쉽게` / `힌트 많이`: TODO 설명을 더 구체적으로, 빈칸 수 줄임
- `어렵게` / `힌트 없이`: TODO 설명 최소화, 빈칸 수 늘림 (메서드명도 가림)
- 기본값: 중간 수준 (핵심 로직만 가림, 힌트는 방향만)

## 주의사항

- ✅ 원본 파일은 절대 덮어쓰지 않음 (`_blank` 접미사 필수)
- ✅ `____` 는 4개 밑줄로 통일 (가시성)
- ✅ TODO 번호는 코드 흐름 순서 준수
- ✅ 빈칸 개수가 너무 많으면 사용자에게 확인 (20개 이상)
- ❌ 정답을 TODO 주석에 직접 쓰지 않기
- ❌ import / 클래스 시그니처 / 단순 변수 선언은 가리지 않기

## 관련 스킬

- `/template` - 새 문제 풀이 템플릿 생성
- `/algo:hint` - 빈칸 채우기 막힐 때 힌트
- `/algo:review` - 풀이 후 복습 문서 생성