Repolode
tanishqkancharla

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. 1

    변경 사항이 있는 저장소에서 diffmap 프롬프트를 에이전트에 붙여넣어 사용해 보세요

  2. 2

    generate-diffmap 스킬을 설치합니다

    npx skills add tanishqkancharla/diffmap --skill generate-diffmap
  3. 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 통계는 매일 갱신됩니다.

관련 프로젝트

PlantUML, Mermaid, D2, GraphViz 등의 텍스트 기반 다이어그램 소스를 SVG, PNG 및 기타 이미지로 변환하는 통합 HTTP API입니다.

4.4천+11 이번 주327JavaScriptMIT업데이트 22시간 전