Repolode
oil-oil

oil-oil/oil-diff

Git 변경 사항을 파일별 diff 목록 대신 업무 목적별로 묶어 한 화면짜리 HTML 리뷰 페이지로 만들어 주는 에이전트 Skill입니다.

스타
88
포크
7
열린 이슈
0
마지막 커밋
6일 전

어떤 프로젝트인가요?

oil-diff는 AI 코딩 에이전트를 위한 Skill로, 커밋되지 않은 변경 사항이나 커밋 범위, 브랜치 비교를 읽고 Git diff를 구체적인 변경 사항 3~7개로 묶습니다. .oil-diff/index.html에 단일 HTML 보고서를 생성하므로, 리뷰어는 알파벳순 파일 목록을 스크롤하지 않고도 어떤 업무 영역이 바뀌었는지, 왜 바뀌었는지, 어떤 파일을 우선 살펴봐야 하는지 확인할 수 있습니다.

보고서의 각 섹션은 변경 사항 설명과 시각 자료를 함께 보여 줍니다. UI가 바뀐 경우 변경 전후 스크린샷을 제공하고, 로직이나 규칙이 바뀐 경우 라우팅, 흐름 또는 필드 변경 다이어그램을 생성합니다. 각 변경 사항 아래에는 주요 파일과 추가·삭제된 줄 수가 표시되며, 참조 자료, 설정, 문서 같은 보조 변경 사항은 카드 하단에 접어 둡니다. 접을 수 있는 파일 트리와 오른쪽 서랍에서 각 파일의 변경 전후 코드를 확인할 수 있습니다.

생성된 결과물은 <repo>/.oil-diff/에 저장되고 git-ignored 처리되므로 프로젝트 파일과 git status는 그대로 유지됩니다. 최종 HTML은 오프라인에서 사용할 수 있는 독립형 파일입니다. 시스템에 설치된 git과 Python 3.10+ 표준 라이브러리만 있으면 되며 API 키는 필요하지 않습니다. macOS, Windows, Linux에서 실행할 수 있습니다.

핵심 기능

  • 01diff를 파일 목록이 아닌 업무 수준의 변경 사항 3~7개로 묶습니다.
  • 02브라우저에서 바로 열 수 있는 오프라인 HTML 보고서 하나를 생성합니다.
  • 03각 변경 사항의 변경 전후 스크린샷이나 자동 생성 다이어그램을 보여 줍니다.
  • 04주요 리뷰 대상 파일과 보조 변경 사항을 구분하고 줄 수 통계를 제공합니다.
  • 05접을 수 있는 파일 트리와 변경 전후 코드를 보여 주는 사이드 서랍을 제공합니다.
  • 06저장소를 수정하지 않고 git-ignored 폴더에 결과물을 작성합니다.

활용 사례

  • 병합 전후에 팀에 변경 사항을 공유할 때.
  • 변경된 영역을 먼저 파악해 대규모 브랜치를 리뷰할 때.
  • AI 코딩 에이전트가 작업 트리에서 방금 수정한 내용을 이해할 때.
  • 저장소에 접근할 수 없는 동료와 독립형 HTML 변경 요약을 공유할 때.

빠른 시작

  1. 1

    npx로 Skill 설치하기

    npx skills add oil-oil/oil-diff
  2. 2

    현재 변경 사항에 대한 보고서를 생성해 달라고 Agent에 요청하기

사용 전 알아둘 점

  • 시스템에 git이 설치되어 있어야 하며 Python 3.10 이상이 필요합니다.
  • Agent Skill이므로 사용하려면 Skills를 불러올 수 있는 AI agent가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

oil-diff은(는) 무엇인가요?
Git 변경 사항을 파일별 diff 목록 대신 업무 목적별로 묶어 한 화면짜리 HTML 리뷰 페이지로 만들어 주는 에이전트 Skill입니다. oil-diff는 AI 코딩 에이전트를 위한 Skill로, 커밋되지 않은 변경 사항이나 커밋 범위, 브랜치 비교를 읽고 Git diff를 구체적인 변경 사항 3~7개로 묶습니다. .oil-diff/index.html에 단일 HTML 보고서를 생성하므로, 리뷰어는 알파벳순 파일 목록을 스크롤하지 않고도 어떤 업무 영역이 바뀌었는지, 왜 바뀌었는지, 어떤 파일을 우선 살펴봐야 하는지 확인할 수 있습니다.
oil-diff은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
oil-diff은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
oil-diff은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. oil-diff의 마지막 커밋은 2026년 10월 31일입니다.
oil-diff은(는) 어디에 사용할 수 있나요?
병합 전후에 팀에 변경 사항을 공유할 때. 변경된 영역을 먼저 파악해 대규모 브랜치를 리뷰할 때. AI 코딩 에이전트가 작업 트리에서 방금 수정한 내용을 이해할 때. 저장소에 접근할 수 없는 동료와 독립형 HTML 변경 요약을 공유할 때.
oil-diff는 어떻게 설치하나요?
npx로 Skill 설치하기: npx skills add oil-oil/oil-diff 현재 변경 사항에 대한 보고서를 생성해 달라고 Agent에 요청하기
oil-diff은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/oil-oil/oil-diff

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트