짧은 JSON 사양을 애니메이션과 탐색이 가능한 다이어그램으로 만들고 SVG, PNG, GIF 또는 MP4로 내보내는 Claude 및 코딩 에이전트용 스킬입니다.
tanishqkancharla/diffmap
코딩 에이전트가 코드 변경 사항을 각 부분의 소스와 연결된 인터랙티브 다이어그램으로 설명하게 해주는 에이전트 스킬입니다.
- 스타
- 237
- 포크
- 9
- 열린 이슈
- 1
- 마지막 커밋
- 21시간 전
어떤 프로젝트인가요?
diffmap은 개발자가 코딩 에이전트가 작성한 코드를 검토할 수 있도록 돕습니다. 에이전트는 인터랙티브 Mermaid 다이어그램, 단계별로 재생할 수 있는 애니메이션 서비스 다이어그램, 다이어그램과 호출 스택의 diff를 포함한 Markdown 명세를 작성합니다. 다이어그램의 각 요소는 관련 파일, 심볼 또는 커밋으로 연결되어 있어, 검토자는 그림의 상자나 선을 클릭해 그 뒤에 있는 코드로 이동할 수 있습니다.
명세는 npx로 실행하는 로컬 뷰어에서 렌더링됩니다. 뷰어에는 Diff 패널, 에이전트에게 전달할 Markdown 목록으로 복사할 수 있는 인라인 댓글, 검토할 파일을 순서대로 나열하는 커밋 카드 지원도 포함됩니다. 명세는 비공개 GitHub gist 링크로 공유해 diffmap.dev에서 열 수도 있습니다. 이 프로젝트는 Markdown 형식을 파싱하는 라이브러리 API를 제공하는 TypeScript 패키지입니다.
핵심 기능
- 01에이전트가 작성한 명세를 바탕으로 인터랙티브 Mermaid 다이어그램과 애니메이션 서비스 다이어그램을 생성합니다.
- 02다이어그램과 호출 스택의 diff를 표시하고, 현재 버전이나 제안된 버전에만 있는 내용을 구분합니다.
- 03다이어그램 노드, 호출 스택 행, 본문 내 참조를 소스 파일, 심볼 또는 커밋에 연결합니다.
- 04Diff 패널과 에이전트에게 전달할 수 있도록 복사 가능한 인라인 댓글을 제공하는 로컬 뷰어를 제공합니다.
- 05명세를 비공개 GitHub gist 링크로 공유하고 diffmap.dev에서 볼 수 있습니다.
활용 사례
- 코딩 에이전트가 만든 대규모 변경 사항을 병합하기 전에 검토하기.
- 팀원에게 기능 브랜치의 요청 흐름이나 상태 변경 과정을 설명하기.
- 에이전트의 diff에 줄 단위 댓글을 남기고 번호가 매겨진 목록으로 전달하기.
- 링크를 통해 팀과 pull request를 검토할 수 있는 설명을 공유하기.
빠른 시작
- 1
변경 사항이 있는 저장소에서 diffmap 프롬프트를 에이전트에 붙여넣어 사용해 보세요
- 2
generate-diffmap 스킬을 설치합니다
npx skills add tanishqkancharla/diffmap --skill generate-diffmap - 3
spec 파일에서 로컬 뷰어를 실행합니다
npx @tanishqkancharla/diffmap serve path/to/file.md
사용 전 알아둘 점
- spec을 링크로 공유하는 기능은 실험 단계이며, gh CLI에 로그인해야 합니다.
- Gist에 호스팅된 뷰어는 브라우저에서 api.github.com을 통해 Gist를 가져옵니다.
포함된 컬렉션
토픽
자주 묻는 질문
- diffmap은(는) 무엇인가요?
- 코딩 에이전트가 코드 변경 사항을 각 부분의 소스와 연결된 인터랙티브 다이어그램으로 설명하게 해주는 에이전트 스킬입니다. diffmap은 개발자가 코딩 에이전트가 작성한 코드를 검토할 수 있도록 돕습니다. 에이전트는 인터랙티브 Mermaid 다이어그램, 단계별로 재생할 수 있는 애니메이션 서비스 다이어그램, 다이어그램과 호출 스택의 diff를 포함한 Markdown 명세를 작성합니다. 다이어그램의 각 요소는 관련 파일, 심볼 또는 커밋으로 연결되어 있어, 검토자는 그림의 상자나 선을 클릭해 그 뒤에 있는 코드로 이동할 수 있습니다.
- diffmap은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- diffmap은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- diffmap은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. diffmap의 마지막 커밋은 2026년 11월 5일입니다.
- diffmap은(는) 어디에 사용할 수 있나요?
- 코딩 에이전트가 만든 대규모 변경 사항을 병합하기 전에 검토하기. 팀원에게 기능 브랜치의 요청 흐름이나 상태 변경 과정을 설명하기. 에이전트의 diff에 줄 단위 댓글을 남기고 번호가 매겨진 목록으로 전달하기. 링크를 통해 팀과 pull request를 검토할 수 있는 설명을 공유하기.
- diffmap는 어떻게 설치하나요?
- 변경 사항이 있는 저장소에서 diffmap 프롬프트를 에이전트에 붙여넣어 사용해 보세요 generate-diffmap 스킬을 설치합니다: npx skills add tanishqkancharla/diffmap --skill generate-diffmap spec 파일에서 로컬 뷰어를 실행합니다: npx @tanishqkancharla/diffmap serve path/to/file.md
- diffmap은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tanishqkancharla/diffmap
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
런타임 의존성 없이 Mermaid 다이어그램 텍스트를 SVG로 변환하는 경량 동기식 렌더러입니다.
코딩 에이전트가 다이어그램, diff 리뷰, 계획, 표를 ASCII 아트 대신 스타일이 적용된 HTML 페이지로 렌더링하게 하는 에이전트 스킬입니다.
AI 코딩 에이전트가 다이어그램과 미리보기를 렌더링하고, 화면에서 주석을 달아 승인할 수 있는 Electron 메뉴 막대 앱입니다.
Git 변경 사항을 파일별 diff 목록 대신 업무 목적별로 묶어 한 화면짜리 HTML 리뷰 페이지로 만들어 주는 에이전트 Skill입니다.