code-analysis

name	code-analysis
description	지정된 디렉토리/파일의 문제점을 분석하고 각 문제를 개별 GitHub 이슈로 등록합니다.

코드 분석 및 GitHub 이슈 등록

지정된 디렉토리 또는 파일을 분석하여 문제점, 모호한 점, 개선이 필요한 사항을 식별하고 각각을 GitHub 이슈로 등록합니다.

실행 절차

1단계: 분석 대상 확인

• 인자가 없으면 사용자에게 분석 대상 경로를 질문
• 지정된 경로의 파일 목록 수집 (Glob 사용)
• 각 파일의 전체 내용 읽기 (Read 사용)

2단계: 코드 분석

아래 관점에서 문제점을 식별합니다:

2-1. 버그 및 로직 오류

• 경계 조건 누락 (빈 리스트, None, 0 나누기 등)
• 타입 불일치 또는 잘못된 타입 가정
• 예외 처리 누락 또는 잘못된 예외 처리
• 잘못된 조건문, off-by-one 에러

2-2. 설계 및 아키텍처

• Clean Architecture 위반 (core → infra 의존)
• 인터페이스 미구현 또는 불완전한 구현
• 과도한 결합 (tight coupling)
• 단일 책임 원칙(SRP) 위반

2-3. 모호한 코드

• 의도가 불분명한 매직 넘버 또는 하드코딩 값
• 이름만으로 역할을 파악하기 어려운 변수/함수
• 주석과 실제 동작이 불일치하는 코드
• 복잡한 조건문이나 중첩 로직

2-4. 누락된 기능 및 미완성 코드

• TODO, FIXME, HACK, XXX 주석
• 빈 구현체 (pass, NotImplementedError)
• 테스트가 없는 핵심 로직

2-5. 유지보수성

• 중복 코드
• 과도하게 긴 함수 (50줄 이상)
• 깊은 중첩 (3단계 이상의 if/for)
• 사용되지 않는 import, 변수, 함수

3단계: 분석 결과 정리

발견된 각 문제를 다음 형식으로 정리합니다:

- 제목: 간결한 한줄 요약
- 파일: 해당 파일 경로
- 위치: 라인 번호 또는 함수명
- 심각도: Critical / Warning / Suggestion
- 카테고리: Bug / Design / Ambiguous / Missing / Maintenance
- 설명: 문제의 상세 내용과 왜 문제인지 설명
- 제안: 개선 방향 또는 수정 방안

4단계: 사용자 확인

• 발견된 전체 문제 목록을 요약 테이블로 출력
• 사용자에게 이슈로 등록할 항목을 확인 요청
• 사용자가 선택한 항목만 이슈로 등록 (전체 등록도 가능)

5단계: GitHub 이슈 등록

각 문제를 개별 GitHub 이슈로 생성합니다:

gh issue create \
  --title "[카테고리] 제목" \
  --body "본문" \
  --label "라벨"

이슈 본문 형식

## 문제 설명
{설명}

## 위치
- **파일**: `{파일 경로}`
- **위치**: {라인 번호 또는 함수명}

## 심각도
{Critical / Warning / Suggestion}

## 제안
{개선 방향 또는 수정 방안}

---
_이 이슈는 코드 분석 스킬에 의해 자동 생성되었습니다._

라벨 매핑

카테고리	라벨
Bug	bug
Design	design
Ambiguous	clarification
Missing	enhancement
Maintenance	maintenance

• 라벨이 존재하지 않으면 라벨 없이 생성합니다 (--label 옵션 생략)
• 심각도가 Critical이면 추가로 priority: high 라벨을 시도합니다

6단계: 결과 보고

출력 형식

## 코드 분석 결과

### 분석 대상
- 경로: {분석 대상 경로}
- 파일 수: {N}개

### 발견된 문제

| # | 심각도 | 카테고리 | 파일 | 제목 |
|---|--------|---------|------|------|
| 1 | Critical | Bug | src/core/analyzer.py | ... |
| 2 | Warning | Design | src/infra/broker.py | ... |

### 등록된 이슈

| # | 이슈 번호 | 제목 | URL |
|---|----------|------|-----|
| 1 | #12 | [Bug] ... | https://github.com/.../issues/12 |
| 2 | #13 | [Design] ... | https://github.com/.../issues/13 |

### 요약
- 총 {N}개 문제 발견 (Critical: {n}, Warning: {n}, Suggestion: {n})
- {M}개 이슈 등록 완료

주의사항

• 분석은 읽기 전용으로 수행하며, 코드를 수정하지 않습니다
• .env 파일은 분석 대상에서 제외합니다
• 이슈 등록 전 반드시 사용자 확인을 받습니다
• 동일한 문제가 이미 이슈로 등록되어 있는지 gh issue list로 확인 후 중복 방지
• 한 번에 너무 많은 이슈를 등록하지 않도록 10개 초과 시 사용자에게 분할 등록 제안