understand-diff (변경 영향 분석)
Git diff나 PR을 프로젝트 지식 그래프와 대조해 변경된 부분과 영향받는 컴포넌트, 리스크를 정리해 줍니다.
개발·코딩중급★ 78,314⑂ 6,578AI 점수 7/10마지막 업데이트: 2026. 7. 30.
무엇을 해주나
이 스킬은 현재 작업 중인 코드 변경(git diff) 또는 특정 PR을 프로젝트의 지식 그래프(.ua/knowledge-graph.json)와 비교합니다.
- 변경된 파일에 해당하는 노드(파일·함수·클래스·설정·문서 등)를 찾아냅니다.
- 1홉 엣지를 따라가며 이 변경을 호출하거나 의존하는 상위 컴포넌트와, 변경 코드가 사용하는 하위 의존성을 뽑아냅니다.
- 어떤 아키텍처 레이어가 건드려졌는지, 레이어 간 영향이 있는지 알려줍니다.
- 노드 복잡도와 영향 반경(blast radius)을 근거로 리스크 평가와 중점 리뷰 포인트를 제시합니다.
- 결과를
diff-overlay.json으로 저장해 대시보드에서 시각적으로 확인할 수 있게 합니다. - 그래프가 기록된 커밋과 현재 HEAD를 비교해 그래프가 오래됐는지도 경고합니다.
이런 분께 추천
- 대규모 코드베이스에서 PR 리뷰를 맡는 리뷰어
- "이 파일 고치면 뭐가 깨지지?"가 항상 걱정인 개발자
- 모노레포/레이어드 아키텍처에서 레이어 간 영향까지 확인하고 싶은 팀
- 새 팀원으로 합류해 변경의 파급 효과를 빠르게 파악해야 하는 경우
활용 예시
- PR 리뷰 전 사전 점검 — 기능 브랜치에서 스킬을 실행하면
git diff main...HEAD기준으로 변경 컴포넌트와 영향 컴포넌트 목록, 리스크 등급이 정리됩니다. - 리팩터링 안전성 확인 — 공용 유틸 함수를 수정한 뒤 이 함수를 호출하는 상위 모듈 전체를 뽑아 테스트 범위를 정합니다.
- 대시보드 시각화 — 분석 후
/understand-anything:understand-dashboard를 실행하면 변경/영향 노드가 하이라이트된 그래프를 볼 수 있습니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 Egonex-AI/Understand-Anything 의 understand-anything-plugin/skills/understand-diff 폴더를 내 ~/.claude/skills/understand-diff/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/Egonex-AI/Understand-Anything.git /tmp/understand-anything && mkdir -p ~/.claude/skills && cp -r /tmp/understand-anything/understand-anything-plugin/skills/* ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 클론합니다:
git clone https://github.com/Egonex-AI/Understand-Anything.git - 스킬 폴더가 없다면 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r Understand-Anything/understand-anything-plugin/skills/* ~/.claude/skills/(understand-diff는 동일 플러그인의/understand스킬이 만든 지식 그래프에 의존하므로 전체 복사를 권장합니다) - 분석하려는 프로젝트 폴더에서 Claude Code를 실행합니다.
- 먼저
/understand를 실행해.ua/knowledge-graph.json지식 그래프를 생성합니다. - 이제 "이번 변경사항의 영향 범위를 분석해줘" 또는
/understand-diff로 호출합니다. - 결과 확인 후
/understand-anything:understand-dashboard로 시각화된 diff 오버레이를 열어봅니다.
GitHub에서 원본 보기 ↗라이선스: MIT