C# 리팩토링 스킬 Skill

C# 리팩토링 스킬

유지보수성, 가독성, 베스트 프랙티스 준수를 위해 C# 코드를 체계적으로 리팩토링합니다.

중요: 모든 결과는 반드시 한국어로 작성합니다. 코드 식별자, 기술 용어, 패턴 이름 등은 원문 그대로 유지하되, 설명·문제점·개선안 등 서술 부분은 한국어를 사용합니다.

인자

$ARGUMENTS[0]: 대상 파일 경로 (선택, 미지정 시 .cs 파일 탐색)
$ARGUMENTS[1]: 리팩토링 유형 (선택): solid, pattern, modern, extract, all
- 미지정 시: 모든 카테고리를 스캔하고, 발견된 항목만 적용

실행 단계

1단계: 대상 식별

파일이 지정되지 않은 경우 ($ARGUMENTS[0]이 비어있음):

최근 수정된 .cs 파일 탐색
사용자에게 대상 파일 선택 요청

2단계: 코드 분석

대상 코드를 읽고 리팩토링 기회를 분석합니다.

TargetFramework 확인: .csproj에서 <TargetFramework>를 읽어 C# 버전을 파악하고, 해당 버전에서 사용 가능한 기능만 제안합니다.

3단계: 리팩토링 적용

$ARGUMENTS[1] 기준 또는 전체 카테고리를 분석합니다:

리팩토링 카테고리

SOLID 리팩토링 (`solid`)

| 위반 | 리팩토링 | |------|----------| | SRP | Extract class, 책임 분리 | | OCP | Strategy/Template Method 패턴 도입 | | LSP | 상속 계층 수정, Composition 사용 | | ISP | 인터페이스를 작은 단위로 분리 | | DIP | 인터페이스 추출, 의존성 주입 |

Pattern 도입 (`pattern`)

| Code Smell | 권장 패턴 | |------------|-----------| | 복잡한 객체 생성 | Builder, Factory Method | | 타입별 다중 조건문 | Strategy, State | | 전역 상태 접근 | Singleton (신중하게), DI | | 복잡한 하위 시스템 | Facade | | 트리/복합 구조 | Composite | | 동적 기능 추가 | Decorator | | 요청 처리 체인 | Chain of Responsibility |

Modern C# 문법 (`modern`)

| 기존 문법 | Modern 대안 | 최소 버전 | |-----------|-------------|-----------| | 생성자 + 필드 할당 | Primary constructor | C# 12 | | new List<T> { ... } | Collection expressions [...] | C# 12 | | 다중 null 체크 | Pattern matching, ?., ?? | C# 8 | | 장황한 switch 문 | Switch expressions | C# 8 | | 수동 INPC 구현 | [ObservableProperty] (CommunityToolkit.Mvvm) | - | | 변경 가능한 프로퍼티 (non-MVVM) | required, init | C# 11 | | 단순 데이터용 class | Record types | C# 9 | | 전통적 foreach | LINQ (적절한 경우) | - |

Extract 리팩토링 (`extract`)

Extract Method: 긴 메서드 → 작고 집중된 메서드
Extract Class: 큰 클래스 → 여러 응집된 클래스
Extract Interface: 구체 의존성 → 인터페이스 추상화
Extract Base Class: 중복 코드 → 공유 기반 클래스
Extract Parameter Object: 다수 매개변수 → 단일 객체

출력 형식

모든 내용은 한국어로 작성합니다. 코드 식별자와 기술 용어는 원문을 유지합니다.

# 리팩토링 결과

## 대상
- 파일: {파일 경로}
- 리팩토링 유형: {유형}
- TargetFramework: {버전}

## 적용된 변경

### {리팩토링 이름}
- 위치: `file.cs:line`
- 변경 전:
```csharp
// 기존 코드

변경 후:

// 리팩토링된 코드

이점: {설명}

요약

총 리팩토링: {N}건
변경된 줄 수: {N}
새로 생성된 파일: {목록}

추가 권장 사항

추가로 적용 가능한 개선 사항
고려할 관련 패턴


## 에러 처리

| 상황 | 처리 |
|------|------|
| `.cs` 파일 없음 | "리팩토링 대상 .cs 파일이 없습니다" 메시지 출력 후 종료 |
| 대상 파일 미발견 | 사용자에게 파일 경로 재확인 요청 |
| TargetFramework < net8.0 | C# 12 전용 기능 제안 제외, 경고 노트 출력 |

## 가이드라인

- 기존 기능을 유지합니다 (동작 변경 없음)
- 대규모 재작성이 아닌 점진적 변경을 합니다
- 영리함보다 가독성을 우선합니다
- 팀의 패턴 친숙도를 고려합니다
- 로직이 명확하지 않은 경우에만 주석을 추가합니다
- 테스트 프로젝트가 존재하면 `dotnet test` 실행 후 회귀 없음을 확인합니다

Agent Skills: C# 리팩토링 스킬

Install this agent skill to your local

Skill Files