Lint Audit

프로젝트 lint/타입/위생 상태를 측정하고 개선 방향을 제안하는 스킬입니다.

lint-audit vs code-metrics

핵심 철학:

• 측정하지 않으면 개선할 수 없다
• 스크립트로 만들 수 있는 ê±´ 스크립트로
• 점진적 개선 (한 번에 모든 것 X)

핵심 원칙

Tidy하지 않은 커밋 기준: 파일 10개 초과, 변경 유형 혼합 (feat+fix), 모호한 메시지

Instructions

Phase 1: 프로젝트 분석

# 1. 기술 스택 감지
Glob package.json pyproject.toml Cargo.toml go.mod

# 2. CI/CD 설정 확인
Glob .github/workflows/** Justfile Makefile

# 3. 품질 도구 설정 확인
Grep "eslint\|prettier\|ruff\|mypy\|clippy" package.json pyproject.toml

확인 항목: 기술 스택, CI 파이프라인, 품질 도구

Phase 1 결과 예시:

Stack: TypeScript (package.json)
CI: GitHub Actions (.github/workflows/ci.yml)
Tools: ESLint ✓, tsc ✓, knip ✗ (설치 필요)

Phase 2: 현황 진단

2.1 도구 확인

도구가 없으면 설치 가이드와 함께 사용자에게 알림:

# 필수 도구 확인
check_tool() {
  if ! command -v "$1" &>/dev/null; then
    echo "Missing: $1 - Install: $2"
    return 1
  fi
}

# TypeScript 프로젝트
check_tool tsc "npm install -D typescript"
check_tool eslint "npm install -D eslint"
check_tool knip "npm install -D knip"

도구 누락 시: Phase 3 리포트에 설치 가이드 포함 후 계속 진행 (가능한 도구만 실행).

2.2 언어별 검사

2.3 Tidy 커밋 분석

# 최근 20개 커밋 중 파일 10개 초과 커밋 식별
git log --oneline -20 --format="%h %s" | while read hash msg; do
  files=$(git show --name-only --format="" "$hash" | wc -l | tr -d ' ')
  if [ "$files" -gt 10 ]; then
    echo "Untidy: $hash ($files files) - $msg"
  fi
done

2.4 오류 밀도 계산

# SLOC 계산 (괄호로 조건 그룹화)
sloc=$(find . \( -name "*.ts" -o -name "*.py" \) -exec cat {} + 2>/dev/null | wc -l)

# 또는 cloc 사용 (권장: 주석/빈줄 자동 제외)
if command -v cloc &>/dev/null; then
  sloc=$(cloc . --json 2>/dev/null | jq '.SUM.code // 0')
fi

# 밀도 = 오류 수 / SLOC

밀도 해석 기준:

• < 0.01: 양호
• 0.01-0.05: 개선 필요

• 0.05: 심각

Phase 3: 리포트 생성

측정 결과를 요약하여 제시:

## Quality Audit Report

### 현황
- Lint 오류: XX개 (밀도: X.XX)
- 타입 오류: XX개
- 죽은 코드: XX개 파일

### Tidy 커밋 분석 (최근 20개)
- Tidy하지 않은 커밋: X개
  - #15: "fix: multiple fixes" (12개 파일)

### 권장 조치
1. [우선] Lint 오류 해결
2. [중간] 죽은 코드 제거
3. [낮음] 커밋 분리 개선

Phase 4: 자동화 제안

개선이 필요한 영역에 대해 자동화 도구 제안:

→ 사용자 승인 후 생성 (rule-creator 연동)

Examples

예시 1: TypeScript 프로젝트 감사

User: “프로젝트 품질 체크해줘”

Flow:

1. package.json 확인 → TypeScript + ESLint 감지
2. npx tsc --noEmit 실행 → 오류 12개
3. npx eslint . 실행 → 경고 45개
4. 리포트 생성 + 권장 조치 제시
5. AskUserQuestion: “자동화 스크립트 생성할까요?”

예시 2: 커밋 히스토리 진단

User: “커밋 품질 체크해줘”

Flow:

1. 최근 20개 커밋 분석
2. tidy하지 않은 커밋 식별
3. /tidy-check 커맨드 생성 제안

Anti-Patterns

Technical Details

연동 스킬:

• code-metrics: 코드 구조 메트릭 (복잡도, 결합도) 분석
• rule-creator: 자동화 스크립트 생성 시 연동
• devops-local-ci: CI 품질 체크 설정 시 참조