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

코드 이해 — 온디맨드 아키텍처 포커스 맵

낯선 코드베이스에서 '핵심을 떠받치는' 파일과 심볼을 인용(file:line)과 함께 순위로 뽑아주는 오리엔테이션 스킬.

개발·코딩중급★ 3,520⑂ 350AI 점수 8/10마지막 업데이트: 2026. 10. 3.

무엇을 해주나

  • 프로젝트를 스캔해 아키텍처가 실제로 의존하는 파일·심볼의 순위 목록(포커스 맵) 을 만들어 줍니다.
  • 각 항목에 file:line 인용과 증거 유형(정의/임포트/변경 파일/텍스트 매칭)이 붙어, 어디를 먼저 읽어야 하는지 알려줍니다.
  • CodeGraph가 설치돼 있으면 실제 호출 그래프 기반의 구조적 근거를, 없으면 정규식 기반 심볼 추출 + rg 교차 참조로 의존성 없이 동작합니다.
  • 변경 파일이나 --since <sha>를 주면 해당 변경의 영향 범위(blast radius) 를 중심으로 지도를 만듭니다.
  • 원시 JSON이나 .codegraph/ 산출물은 커밋·문서화하지 말라는 가드레일까지 포함합니다.

이런 분께 추천

  • 처음 보는 대형 저장소에 투입되어 구조 파악부터 해야 하는 개발자
  • 대규모 리팩터링 전에 '손대면 깨지는 곳'을 먼저 알고 싶은 분
  • PR 설명이나 커밋 메시지에 근거 있는 구조 설명을 넣고 싶은 분
  • obsidian-wiki CLI를 이미 쓰고 있거나 설치할 수 있는 환경

활용 예시

  1. "이 프로젝트 구조를 설명해줘" → obsidian-wiki code-understand --project . --pretty 로 상위 50개 핵심 심볼을 받아 인용과 함께 설명.
  2. 리팩터링 직전 → obsidian-wiki code-understand --since HEAD~5 로 최근 변경 기준 영향 범위를 확인.
  3. 특정 함수의 호출자 추적 → --changed src/auth/session.ts 로 해당 파일을 시드로 두고 연관 심볼만 좁혀서 읽기.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

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

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/Ar9av/obsidian-wiki/HEAD/.skills/code-understand/SKILL.md

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

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

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

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

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

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

직접 명령으로 설치하기

git clone https://github.com/Ar9av/obsidian-wiki.git /tmp/obsidian-wiki && mkdir -p ~/.claude/skills && cp -r /tmp/obsidian-wiki/.skills/code-understand ~/.claude/skills/

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

  1. 터미널을 열고 저장소를 클론합니다: git clone https://github.com/Ar9av/obsidian-wiki.git
  2. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r obsidian-wiki/.skills/code-understand ~/.claude/skills/
  4. 핵심 명령을 쓰려면 저장소의 설치 안내에 따라 obsidian-wiki CLI를 설치합니다(이게 없으면 Claude는 일반 grep 탐색으로 대체합니다).
  5. (선택) 호출 그래프 정확도를 높이려면 npm install -g @colbymchenry/codegraph — 설치 전 반드시 본인 동의 하에 진행하세요.
  6. obsidian-wiki doctor --project . 로 code-understanding.* 항목이 정상인지 확인합니다.
  7. Claude Code를 재시작하고 "이 코드베이스 구조를 파악해줘"라고 요청해 보세요.
GitHub에서 원본 보기 ↗라이선스: MIT