Pre-Commit 훅 설정
사전 요구 사항
시작하기 전에 다음을 확인하세요:
- Git 저장소 존재 —
.git/디렉토리를 확인합니다. 없으면 사용자에게 알리고 중단합니다. - 패키지 관리자 사용 가능 — 아래 감지 단계 후 관련 도구가 설치되어 있는지 확인합니다:
- Python:
uv --version명령어로uv사용 가능 여부 확인 - JS/TS:
npx --version명령어로npx사용 가능 여부 확인
- Python:
사전 요구 사항이 충족되지 않으면 사용자에게 무엇이 누락되었고 어떻게 설치해야 하는지 알립니다.
1단계: 프로젝트 유형 감지
프로젝트 루트에서 다음을 확인합니다:
| 신호 | 결과 |
|---|---|
pyproject.toml 존재, package.json 없음 | Python → python-setup.md 파일 참조 |
package.json 존재, pyproject.toml 없음 | JS/TS → js-setup.md 파일 참조 |
| 둘 다 존재 | 사용자에게 질문 (아래 참조) |
| 둘 다 없음 | 지원되는 프로젝트가 없다고 알리고 중단 |
둘 다 감지된 경우
AskUserQuestion을 사용하여 세 가지 옵션을 제공합니다:
- A) Python만 —
python-setup.md참조 - B) JS/TS만 —
js-setup.md참조 - C) 둘 다 — "두 언어 모드" 섹션을 포함하여
python-setup.md참조
2단계: 사용자에게 활성화할 체크 선택 요청
언어별 설정 파일에 위임합니다. 각 파일은 AskUserQuestion을 통해 사용 가능한 체크를 제공합니다.
사용자가 체크를 선택하지 않은 경우: 훅이 설치되지 않음을 알리고 정상 종료합니다.
3단계: 프레임워크 설치
언어별 설정 파일을 따릅니다.
4단계: 설정 파일 생성
언어별 설정 파일을 따라 사용자 선택에 기반한 설정 파일을 생성합니다.
5단계: 훅 설치
언어별 설정 파일을 따라 Git에서 훅을 활성화합니다.
6단계: 검증
전체 코드베이스에 대해 훅을 실행하여 정상 작동을 확인합니다.
7단계: 검증 실패 처리
- 린트/포맷 위반이 발견되면 가능한 경우 자동 수정(
ruff --fix,ruff format,prettier --write)하고 다시 실행합니다. - 타입 또는 테스트 실패가 발생하면 사용자에게 알리고 훅 설정 파일만 커밋합니다.
8단계: 커밋
생성되거나 수정된 모든 설정 파일을 스테이징하고 커밋합니다.