understand-explain — 코드 심층 해설

무엇을 해주나

Understand-Anything 플러그인이 만든 지식 그래프(.ua/knowledge-graph.json 또는 레거시 .understand-anything/)를 이용해, 지정한 파일·함수·모듈 하나를 깊이 있게 해설합니다.

• 대상 노드를 Grep으로 찾아 type, summary, tags, complexity 확인
• 들어오는/나가는 엣지(imports, calls, depends_on 등)를 추적해 "누가 이걸 호출하고, 이건 무엇에 의존하는지" 정리
• 소속 아키텍처 레이어와 그 역할 파악
• 실제 소스 파일을 읽어 내부 구조와 데이터 흐름(입력 → 처리 → 출력) 설명
• 그래프가 만들어진 커밋과 현재 HEAD·워킹트리를 비교해 그래프가 낡았으면 먼저 경고

전체 JSON을 통째로 읽지 않고 필요한 부분만 검색하도록 지시되어 있어, 큰 저장소에서도 컨텍스트 낭비가 적습니다.

이런 분께 추천

• 처음 합류한 대형 코드베이스에서 특정 모듈부터 파악해야 하는 개발자
• 레거시 코드의 호출 관계·의존성을 문서 없이 추적해야 하는 분
• 익숙하지 않은 언어로 된 코드를 리뷰해야 하는 분(언어를 몰라도 읽히도록 설명)
• 팀 온보딩 자료나 코드 설명 문서를 만들어야 하는 테크리드

활용 예시

1. /understand-explain src/auth/login.ts → 이 파일이 인증 레이어에서 하는 역할, 포함된 함수, 이 파일을 import하는 상위 모듈까지 한 번에 정리.
2. /understand-explain src/auth/login.ts:verifyToken → 특정 함수의 입력·검증 로직·반환값과 호출 경로를 단계별로 설명.
3. /understand-explain src/payments/ 모듈 지정 → 결제 모듈의 내부 구성과 외부 서비스·엔드포인트 의존 관계를 요약하고, 그래프가 낡았으면 /understand 재실행을 권고.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 Egonex-AI/Understand-Anything 의 understand-anything-plugin/skills/understand-explain 폴더를 내 ~/.claude/skills/understand-explain/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.