클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

기술 부채 감사 (Tech Debt Audit)

코드베이스를 9개 차원으로 훑어 파일·라인 근거가 붙은 기술 부채 보고서(TECH_DEBT_AUDIT.md)를 만들어 주는 스킬입니다.

개발·코딩중급★ 67,531⑂ 5,507AI 점수 8/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

저장소 전체를 훑어 기술 부채를 9개 차원으로 점검하고, 저장소 루트에 TECH_DEBT_AUDIT.md 보고서를 작성합니다.

  • 점검 차원: 아키텍처 붕괴, 일관성 저하, 타입/계약 부채, 테스트 부채, 의존성·설정, 성능·리소스, 에러 처리·관측성, 보안 위생, 문서 불일치
  • 사용 도구: grep, glob, ast-grep(sg), git log 기반 변경 빈도 분석, LSP 진단, 그리고 선택적으로 CodeGraph MCP(호출 그래프·영향 범위 분석)
  • 보고서 구성: 요약 → 아키텍처 개요 → 발견 사항 표(ID/분류/파일:라인/심각도/예상 공수/권고) → 상위 5개 우선순위 → 30분 내 처리 가능한 퀵윈 → "나빠 보이지만 괜찮은 패턴" → 열린 질문
  • 모든 발견 사항에 파일:라인:열 인용을 강제해 근거 없는 지적을 줄입니다.

이런 분께 추천

  • 인수받은 레거시 프로젝트의 상태를 빠르게 파악해야 하는 개발자
  • 리팩터링 스프린트나 분기 계획에 쓸 우선순위 목록이 필요한 팀 리드
  • 코드 리뷰·아키텍처 리뷰를 정례화하려는 소규모 팀
  • 오픈소스 저장소에 기여하기 전 구조를 파악하려는 컨트리뷰터

활용 예시

  1. 인수인계 직후: "이 레포 기술 부채 감사 좀 해줘"라고 요청하면 변경이 잦은 대형 파일부터 짚어 위험 구역을 지도로 그려 줍니다.
  2. 리팩터링 계획 수립: 생성된 표에서 impact/effort 상위 5개만 뽑아 다음 스프린트 백로그로 옮깁니다.
  3. 금요일 퀵윈 정리: 빈 catch 블록, as any, 남아 있는 TODO/HACK 같은 30분 이하 항목만 골라 한 번에 정리합니다.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 code-yeongyu/oh-my-openagent 의 .agents/skills/tech-debt-audit 폴더를 내 ~/.claude/skills/tech-debt-audit/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/code-yeongyu/oh-my-openagent /tmp/omo && mkdir -p ~/.claude/skills && cp -r /tmp/omo/.agents/skills/tech-debt-audit ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 스킬 저장소를 임시 폴더로 복제합니다: git clone https://github.com/code-yeongyu/oh-my-openagent /tmp/omo
  3. 스킬 폴더가 없으면 만듭니다: mkdir -p ~/.claude/skills
  4. 이 스킬만 복사합니다: cp -r /tmp/omo/.agents/skills/tech-debt-audit ~/.claude/skills/
  5. (권장) ast-grep을 설치합니다: brew install ast-grep 또는 npm i -g @ast-grep/cli
  6. Claude Code를 재시작하고 분석하려는 프로젝트 폴더에서 실행합니다.
  7. "기술 부채 감사(tech debt audit) 해줘"라고 요청하면 스킬이 동작하고, 완료 후 저장소 루트의 TECH_DEBT_AUDIT.md를 확인합니다.
  8. (선택) 호출 그래프 분석까지 원하면 CodeGraph MCP 서버를 .mcp.json에 등록하세요. 없어도 기본 기능은 모두 동작합니다.
GitHub에서 원본 보기 ↗라이선스: NOASSERTION