클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
목록으로

기술 부채 감사 (Tech Debt Audit)

코드베이스를 9개 축으로 훑어 파일:라인 근거와 심각도·공수 추정이 담긴 TECH_DEBT_AUDIT.md 보고서를 만들어 줍니다.

개발·코딩중급68,5925,630AI 점수 9/10마지막 업데이트: 2026. 9. 1.

무엇을 해주나

  • 아키텍처 붕괴, 일관성 붕괴, 타입 부채, 테스트 부채, 의존성/설정, 성능, 에러 처리, 보안 위생, 문서 드리프트 — 총 9개 차원으로 코드베이스를 감사합니다.
  • grep, glob, ast-grep(sg), LSP 진단, npm audit, 테스트 러너 등을 조합해 실제 근거를 수집하고, 모든 발견 사항에 file:line:col 인용을 강제합니다.
  • 결과를 저장소 루트의 TECH_DEBT_AUDIT.md로 정리합니다: 요약, 아키텍처 멘탈 모델, 발견 사항 표(심각도/공수 시간), 우선순위 Top 5, 30분 이내 퀵윈 체크리스트, "나빠 보이지만 괜찮은 패턴", 남은 질문.
  • 대형 코드베이스(5만 LOC 이상)에서는 무거운 차원을 병렬 서브에이전트로 분배하고, CodeGraph MCP가 설치돼 있으면 호출 그래프·영향 범위 분석으로 보강합니다.

이런 분께 추천

  • 리팩터링 계획이나 스프린트 백로그를 근거 기반으로 짜야 하는 팀 리드·테크 리드
  • 레거시 프로젝트를 인수받아 어디부터 손댈지 판단해야 하는 개발자
  • 코드 리뷰·아키텍처 리뷰 결과를 문서로 남겨야 하는 상황
  • 주로 TypeScript/JavaScript 스택 예시가 준비되어 있어 해당 스택 사용자가 가장 즉시 활용하기 좋습니다.

활용 예시

  1. "이 저장소 기술 부채 감사해줘" → 9개 차원 스캔 후 심각도별 발견 사항 표와 Top 5 우선순위가 담긴 보고서 생성.
  2. "리팩터링 전에 코드 헬스 체크" → git 변경 이력이 잦은 파일 × 대형 파일을 교차해 부채 핫존을 먼저 지목.
  3. "빈 catch 블록과 as any 남용만 빠르게 훑어줘" → 3번·7번 차원만 실행해 타입 탈출구와 삼켜진 에러 목록을 파일:라인으로 제시.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/HEAD/.agents/skills/tech-debt-audit/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

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.git /tmp/omo && mkdir -p ~/.claude/skills && cp -r /tmp/omo/.agents/skills/tech-debt-audit ~/.claude/skills/

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

  1. 터미널을 열고 저장소를 임시 폴더에 복제합니다: git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/omo
  2. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r /tmp/omo/.agents/skills/tech-debt-audit ~/.claude/skills/
  4. (권장) 구조 검색용 ast-grep을 설치합니다: brew install ast-grep 또는 cargo install ast-grep (명령어 이름은 sg).
  5. Claude Code를 다시 시작한 뒤 분석하려는 프로젝트 폴더에서 "기술 부채 감사해줘"라고 요청합니다.
  6. 완료되면 저장소 루트에 생성된 TECH_DEBT_AUDIT.md를 확인합니다. (선택) CodeGraph MCP를 .mcp.json에 등록하면 호출 그래프 분석이 추가됩니다.
GitHub에서 원본 보기라이선스: NOASSERTION