aiskillstore/line-limit

Line Limit Enforcement

코드 구현 파일에 대한 라인 수 제한을 강제하는 스킬입니다.

Scope

이 스킬은 코드 구현 파일에만 적용됩니다.

✅ 적용 대상

| 파일 유형 | 확장자 | |----------|--------| | JavaScript/TypeScript | .js, .ts, .jsx, .tsx | | Python | .py | | Go | .go | | Rust | .rs | | Java/Kotlin | .java, .kt | | C/C++ | .c, .cpp, .h | | 기타 실행 코드 | 언어별 소스 파일 |

🚫 예외 (적용 제외)

| 파일 유형 | 확장자/위치 | 사유 | |----------|------------|------| | Jupyter Notebook | .ipynb | 셀 기반 구조, 출력 포함 | | 스킬 파일 | SKILL.md | 문서/가이드 (500줄까지 허용) | | 문서 파일 | .md, .mdx | 문서는 길어도 무방 | | 설정 파일 | .json, .yaml, .toml | 구조적 데이터 | | 테스트 픽스처 | fixtures/, __mocks__/ | 테스트 데이터 | | 자동 생성 파일 | *.generated.*, *.g.* | 수동 관리 X | | 타입 정의 | .d.ts | 선언 파일 | | CSS/스타일 | .css, .scss | 스타일시트 |

Rules

| 상태 | 라인 수 | 조치 | |------|---------|------| | ✅ OK | 0-200 | 정상 | | ⚠️ WARNING | 201-300 | 권장 리팩토링 | | 🔴 VIOLATION | 301+ | 필수 분리 |

When This Skill Activates

• 새 파일 작성 시 라인 수 체크
• 코드 리뷰 요청 시
• "파일이 너무 길어", "모듈화 해줘" 등 요청 시
• 300줄 초과 파일 발견 시

Enforcement Workflow

1. 라인 수 체크

wc -l <file>

2. 상태 판정

if lines <= 200: ✅ OK
elif lines <= 300: ⚠️ WARNING - 리팩토링 권장
else: 🔴 VIOLATION - 분리 필수

3. 위반 시 조치

🔴 300줄 초과 파일 발견 시 반드시:

1. 파일 구조 분석 (함수/클래스/섹션 파악)
2. 분리 가능한 단위 식별:
   • 유틸리티 함수 → utils/ 또는 helpers/
   • 타입 정의 → types/ 또는 *.types.ts
   • 상수/설정 → constants/ 또는 config/
   • 하위 컴포넌트 → components/
   • 훅 → hooks/
3. 분리 계획 제시
4. 사용자 승인 후 리팩토링 실행

Modularization Patterns

React/TypeScript

# Before (500 lines)
src/components/Dashboard.tsx

# After
src/components/Dashboard/
├── index.tsx          # Main component (< 200 lines)
├── DashboardHeader.tsx
├── DashboardStats.tsx
├── DashboardChart.tsx
├── hooks/
│   └── useDashboardData.ts
├── types.ts
└── constants.ts

General Functions

# Before (400 lines)
src/utils/helpers.ts

# After
src/utils/
├── index.ts           # Re-exports
├── string.utils.ts
├── date.utils.ts
├── array.utils.ts
└── validation.utils.ts

Examples

Example 1: 코드 리뷰 시

User: 이 파일 리뷰해줘 - src/services/api.ts

Claude: [파일 읽기 후]
📊 라인 수 체크: 342 lines
🔴 VIOLATION: 300줄 초과 - 모듈화 필요

분석 결과:
- API 엔드포인트 함수: 15개 (240 lines)
- 타입 정의: 12개 (45 lines)
- 헬퍼 함수: 5개 (57 lines)

권장 분리:
1. api/endpoints/ - 엔드포인트별 분리
2. api/types.ts - 타입 정의 추출
3. api/helpers.ts - 헬퍼 함수 추출

분리를 진행할까요?

Example 2: 새 파일 작성 시

User: 대시보드 컴포넌트 만들어줘

Claude: [작성 중 200줄 도달 시]
⚠️ WARNING: 200줄 도달 - 분리 권장

현재 구조:
- DashboardHeader (40 lines)
- DashboardStats (60 lines)
- DashboardChart (80 lines)
- hooks (20 lines)

각 섹션을 별도 파일로 분리하면서 계속 진행할까요?

Example 3: 모듈화 요청

User: 이 파일 너무 길어, 정리해줘

Claude: [line-limit 스킬 활성화]
📊 현재: 456 lines
🔴 VIOLATION: 156줄 초과

[분석 및 분리 계획 제시...]

References

상세 모듈화 가이드: references/modularization-guide.md