Compétences code-refactoring-tech-debt
🔧

code-refactoring-tech-debt

Sûr

기술 부채 분석 및 수정

개발 속도를 저하시키는 기술 부채를 식별하고 정량화하세요. 팀 생산성을 극대화하는 개선을 우선순위화하기 위한 ROI 예측과 함께 실행 가능한 수정 계획을 제공합니다.

Prend en charge: Claude Codex Code(CC)
🥉 74 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "code-refactoring-tech-debt". 결제 서비스의 기술 부채를 분석하세요

Résultat attendu:

## 결제 서비스 기술 부채 분석

### 발견된 주요 문제:
1. 신 클래스: PaymentService.java (847 줄, 32 개 메서드)
2. 5 개 컨트롤러에서 중복된 유효성 검사 로직
3. 환불 플로우에 대한 통합 테스트 없음
4. 추상화 계층 없이 직접 데이터베이스 쿼리

### 영향 평가:
- 월간 속도 손실: 35 시간
- 버그 발생률: 월 4 건 프로덕션 버그 (평균 12 시간 each)
- 연간 비용: $58,800

### 빠른 성과 (1-2 주차):
1. 유효성 검사를 공유 모듈로 추출 - 월 20 시간 절감
2. 환불 플로우 테스트 추가 - 월 2 건 버그 예방

### 중기 (2-3 개월):
PaymentService 를 4 개의 집중 서비스로 리팩토링 - 유지보수 시간 50% 감소

Utilisation de "code-refactoring-tech-debt". 코드베이스를 위한 메트릭 대시보드를 생성하세요

Résultat attendu:

## 코드 품질 메트릭 대시보드

### 현재 상태:
- 순환 복잡도: 15.2 (목표: 10) - 임계값 초과 45 개 파일
- 코드 중복: 23% (목표: 5%) - 핫스팟: validation (850 줄), handlers (620 줄)
- 테스트 커버리지: Unit 45%, Integration 12%, E2E 5% (목표: 80/60/30)
- 종속성 건강: 12 개 주요 구식 버전, 7 개 보안 취약점

### 추세 분석:
- Q1: 750 부채 항목 → Q2: 820 → Q3: 890 (분기별 18% 성장)
- 예측: 개입 없을 시 2025 년 Q1 까지 1,200 항목

### 위험 분포:
- Critical: 3 보안 취약점
- High: 8 성능 핫스팟
- Medium: 42 복잡도 문제
- Low: 156 스타일/효율성 항목

Audit de sécurité

Sûr
v1 • 2/25/2026

Static analysis detected 30 potential issues (external commands, weak crypto, system reconnaissance) but all are false positives from markdown code examples and documentation text. No executable code, network requests, or security threats found. The skill contains only documentation about technical debt analysis with code block examples.

1
Fichiers analysés
389
Lignes analysées
1
résultats
1
Total des audits
Problèmes à risque faible (1)
SKILL.md:106-114SKILL.md:117-127SKILL.md:140-165SKILL.md:168-176SKILL.md:184-199SKILL.md:202-218SKILL.md:221-237SKILL.md:242-268SKILL.md:271-284SKILL.md:291-306SKILL.md:309-319SKILL.md:324-341
Markdown Code Examples Detected
Static scanner flagged 25 instances of backtick-enclosed code blocks as 'external_commands'. These are documentation examples (YAML, Python code snippets) within the markdown file, not executable commands. No injection risk exists as these are static text examples.
Audité par: claude

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
50
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

레거시 코드베이스 평가

개발팀이 누적된 기술 부채가 있는 레거시 프로젝트를 인수할 때, 어떤 문제가 존재하는지, 속도에 미치는 영향은 무엇인지, 그리고 개선을 위한 우선순위화된 계획을 이해하기 위한 포괄적인 분석이 필요합니다.

기술 부채 우선순위화

엔지니어링 관리자는 최대의 영향을 위해 제한된 자원을 어디에 투자할지 결정해야 합니다. 이 스킬은 부채 항목의 비용을 정량화하고 ROI 기준으로 순위와 함께 이해관계자에게 기술 작업을 정당화합니다.

리팩토링 계획

주요 리팩토링 작업을 계획하는 개발자는 대규모 변경사항을 점진적인 단계로 분해하고, 진행 상황을 측정하며, 프로세스 중에 새로운 부채가 발생하지 않도록 방지하기 위한 체계적인 접근 방식이 필요합니다.

Essayez ces prompts

신속 부채 스캔 
이 코드베이스에서 기술 부채 문제를 스캔하세요. 코드 중복, 높은 복잡도 함수 및 누락된 테스트에 집중하세요. 위치와 함께 상위 10 개 문제 요약을 제공하세요.
포괄적 분석 
코드 부채, 아키텍처 부채, 테스트 격차 및 문서화 문제를 다루는 완전한 기술 부채 인벤토리를 수행하세요. 각 카테고리의 연간 비용을 계산하고 빠른 성과를 포함한 우선순위화된 수정 계획을 작성하세요.
특정 컴포넌트 심층 분석 
[컴포넌트/서비스]의 기술 부채를 분석하세요. 복잡도 핫스팟, 결합 문제 및 테스트 커버리지 격차를 식별하세요. 점진적 구현 단계와 함께 리팩토링 전략을 제안하세요.
수정 로드맵 
발견된 기술 부채를 기반으로 분기별 수정 로드맵을 작성하세요. 빠른 성과 (1-2 주), 중기 개선 (1-3 개월), 장기 이니셔티브 (3-6 개월) 를 포함하고 각각에 대한 ROI 예측을 포함하세요.

Bonnes pratiques

  • 리팩토링 시 항상 테스트 커버리지를 포함하세요 - 회귀 방지를 위해 먼저 테스트를 작성하세요 (TDD)
  • 신속한 롤백을 가능하게 하기 위해 리팩토링된 코드의 점진적 롤아웃을 위해 기능 플래그를 사용하세요
  • 미래 유지보수 담당자가 변경 사유를 이해할 수 있도록 아키텍처 결정 (ADR) 을 문서화하세요

Éviter

  • 빅뱅 리팩토링 - 한 번에 전체 시스템을 다시 작성하지 마세요. 지속적 전달과 함께 점진적 변경을 사용하세요
  • 측정 없이 리팩토링 - 개선을 정량화하기 위해 시작 전에 기준 메트릭을 수립하세요
  • 비즈니스 가치 무시 - 모든 기술 부채를 수정해야 하는 것은 아닙니다. 속도와 위험에 미치는 영향을 기준으로 우선순위화하세요

Foire aux questions

이 스킬은 어떤 유형의 기술 부채를 감지할 수 있나요?
이 스킬은 코드 부채 (중복, 복잡도, 불량한 구조), 아키텍처 부채 (설계 결함, 구식 종속성), 테스트 부채 (커버리지 격차, 깨지기 쉬운 테스트), 문서화 부채, 인프라 부채 (배포 문제, 누락된 모니터링) 를 식별합니다.
ROI 예측은 얼마나 정확한가요?
ROI 예측은 일반적인 개발 비용 (예: 시간당 $150) 및 버그 수정 시간의 업계 평균을 기반으로 한 추정치입니다. 절대적 예측보다는 부채 항목 간의 상대적 비교로 사용하세요. 실제 팀 요금에 맞게 비용 가정을 조정하세요.
이 스킬이 찾은 기술 부채를 자동으로 수정할 수 있나요?
아니요, 이 스킬은 분석하고 계획하지만 변경 사항을 실행하지는 않습니다. 귀하나 팀이 적용할 수 있는 상세한 리팩토링 전략, 코드 예시 및 구현 지침을 제공합니다. 자동화된 수정을 위해서는 전용 리팩토링 도구를 찾아보세요.
어떤 기술 부채부터 먼저 해결해야 우선순위화하나요?
즉각적인 속도 개선을 제공하는 빠른 성과 (높은 가치, 낮은 노력) 에 집중하세요. 그런 다음 계산된 연간 비용이 가장 높은 항목을 처리하세요. 위험 수준도 고려하세요 - 중요한 보안 문제는 ROI 가 낮더라도 우선순위화해야 합니다. 이 스킬은 이러한 요소를 기반으로 순위가 매겨진 로드맵을 제공합니다.
SonarQube 와 같은 정적 분석 도구와 이 스킬의 차이점은 무엇인가요?
정적 분석 도구는 규칙 기반 감지와 자동화된 스캔을 제공합니다. 이 스킬은 의미 분석, 컨텍스트 이해 및 전략적 계획을 제공합니다. 결과를 해석하고, 비즈니스 영향을 계산하며, 사람이 읽을 수 있는 수정 계획을 작성할 수 있습니다. 둘을 함께 사용하세요: 스캔을 위한 도구, 분석 및 계획을 위한 이 스킬.
기술 부채 분석은 얼마나 자주 수행해야 하나요?
진행 상황을 추적하고 새로운 부채를 식별하기 위해 분기별로 전체 분석을 실행하세요. 주요 리팩토링 작업 전이나 속도가 눈에 띄게 감소할 때 대상 스캔을 수행하세요. 예방 전략에 설명된 대로 부채를 조기에 감지하기 위해 자동화된 품질 게이트 (pre-commit hooks, CI checks) 를 사용하여 지속적인 모니터링을 수립하세요.

Détails du développeur

Auteur

sickn33

Licence

MIT

Dépôt

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/code-refactoring-tech-debt

Réf

main

Structure de fichiers

📄 SKILL.md