quick

Quick — 경량 작업 실행

Purpose

Phase 분해나 PLAN 문서 없이 소규모 작업을 빠르게 처리한다:

/quick 로그인 실패 시 에러 메시지가 안 나오는 버그 수정
/quick src/ 전체에서 userName을 username으로 rename
/quick 다크 모드 토글 버튼 추가

/dev의 전체 파이프라인이 과한 작업에 사용한다.

적용 범위

적합	부적합 (/dev 사용)
버그 수정 (원인이 명확)	원인 불명의 복잡한 버그
단일 파일 기능 추가	3개 이상 파일에 걸친 새 기능
변수/함수명 일괄 변경	아키텍처 변경을 수반하는 리팩토링
설정값 변경	새 의존성 추가가 필요한 작업
문서/주석 수정	DB 스키마 변경이 필요한 작업

Workflow

Step 1: 입력 분석 및 규모 판별

입력을 분석하여 이 스킬로 처리 가능한지 판별한다:

규모 판별 기준:

영향 파일 1-3개 + 명확한 변경 범위    → Trivial: 바로 수정
영향 파일 4-5개 + 단일 관심사          → Small: 수정 가능, 주의 필요
영향 파일 6개+ 또는 복수 관심사        → /dev로 위임

자동 위임:

분석 결과 규모가 /dev 영역이면 사용자에게 안내한다:

이 작업은 여러 파일과 관심사에 걸쳐 있어 `/dev`로 진행하는 것이 안전합니다.

> `/dev [작업 설명]`으로 전체 파이프라인을 실행하세요.

Step 2: 프로젝트 컨텍스트 로드 (경량)

codebase-scanner를 사용하지 않고, 최소한의 컨텍스트만 직접 수집한다:

# 테스트 명령어 감지
cat package.json 2>/dev/null | grep -A5 '"scripts"'
# 또는 pyproject.toml, Cargo.toml 등에서 추출

# 린트 명령어 감지
ls .eslintrc* biome.json ruff.toml .golangci.yml 2>/dev/null

감지된 명령어를 기억한다 (Step 4에서 사용).

Step 3: 수정 실행

작업 유형에 따라 수정을 수행한다:

버그 수정:

1. 관련 파일을 읽고 원인을 파악한다
2. 테스트가 있으면 실패를 재현하는 테스트를 먼저 확인/작성한다
3. 수정을 적용한다
4. 테스트가 통과하는지 확인한다

작은 기능 추가:

1. 관련 파일을 읽고 기존 패턴을 파악한다
2. 기존 테스트가 있으면 새 테스트를 먼저 작성한다
3. 기능을 구현한다
4. 테스트가 통과하는지 확인한다

일괄 변경 (rename 등):

1. 영향 범위를 Grep으로 파악한다
2. 모든 참조를 일괄 수정한다
3. 빌드/테스트가 통과하는지 확인한다

문서/설정 수정:

1. 대상 파일을 읽고 수정한다
2. 관련 검증이 있으면 실행한다

Step 4: 검증

수정 후 두 가지 검증을 수행한다:

4a. 기본 검증 (항상 실행):

Step 2에서 감지한 명령어로 기본 검증을 수행한다:

# 빌드 (감지된 경우)
[detected build command]

# 테스트 (감지된 경우)
[detected test command]

# 린트 (감지된 경우)
[detected lint command]

감지되지 않은 명령어는 건너뛴다.

4b. 기존 verify 스킬 실행 (있으면):

.claude/skill-registry.json을 읽어 수정된 파일을 커버하는 verify 스킬이 있는지 확인한다:

# 수정된 파일 목록
git diff --name-only HEAD

# 레지스트리에서 coverPatterns 매칭

매칭되는 스킬이 있으면 verify-implementation을 해당 스킬만 대상으로 실행한다. 없으면 4a 결과만으로 진행한다.

검증 실패 시:

검증 실패 → 수정 시도 (최대 2회) → 재실패 시 사용자에게 보고

Step 5: 커밋

검증 통과 후 커밋한다:

커밋 메시지 자동 생성:

작업 유형에 따라 prefix를 결정한다:

작업 유형	커밋 prefix	예시
버그 수정	fix:	fix: 로그인 실패 시 에러 메시지 미표시
기능 추가	feat:	feat: 다크 모드 토글 버튼
일괄 변경	refactor:	refactor: userName을 username으로 통일
문서/설정	docs: / chore:	docs: API 응답 형식 문서 업데이트

git add <modified-files>
git commit -m "<prefix> <description>"

Step 6: 완료 보고

## ✅ Quick 완료

**작업**: [작업 설명]
**수정 파일**: [N]개
**검증**: [PASS / 일부 SKIP]
**커밋**: `<commit-hash>` — <commit-message>

변경된 파일:
- `path/to/file1` — [변경 내용]
- `path/to/file2` — [변경 내용]

에러 핸들링

규모 판별 실수:

수정 도중 예상보다 규모가 크다고 판단되면 (영향 파일이 늘어나거나 복잡도가 높아지면), 즉시 중단하고 안내한다:

### ⚠️ 규모 초과

수정 범위가 예상보다 큽니다 ([N]개 파일 영향).
안전한 진행을 위해 `/dev`를 사용하세요.

현재까지의 변경사항:
- `path/to/file1` — [변경 내용]

> 변경을 유지하려면 `/dev`로 이어서 진행하세요.
> 변경을 되돌리려면 `git checkout -- <files>`를 실행하세요.

검증 명령어 미감지:

빌드/테스트/린트 명령어를 모두 감지하지 못한 경우, 수정만 적용하고 검증은 사용자에게 위임한다:

검증 명령어를 감지하지 못했습니다. 수정을 적용했으나 수동으로 확인해 주세요.

Exceptions

1. DB 마이그레이션 — /quick으로 처리하지 않는다. /dev를 사용한다
2. 새 의존성 설치 — 패키지 추가가 필요하면 /dev로 위임한다
3. 환경 변수 추가 — .env 변경이 필요하면 사용자에게 안내만 한다

Related Files

File	Purpose
skills/dev/SKILL.md	대규모 작업 시 위임 대상
skills/verify-implementation/SKILL.md	Step 4b: 기존 verify 스킬 실행
.claude/skill-registry.json	Step 4b: 수정 파일과 스킬 매칭