Repolode
oil-oil

oil-oil/oil-diff

Skill для AI-агентов превращает изменения Git в одностраничный HTML-отчёт, сгруппированный по бизнес-задачам, а не по файлам.

Звёзды
88
Форки
7
Открытые issues
0
Последний коммит
7 дней назад

Что это?

oil-diff — это Skill для AI-агентов, которые пишут код. Он анализирует незакоммиченные изменения, диапазон коммитов или сравнение веток и группирует Git diff в три-семь конкретных изменений. Результат — единый HTML-отчёт в .oil-diff/index.html: рецензент сразу видит, какие бизнес-области затронуты, почему они изменились и какие файлы важнее всего, не прокручивая алфавитный список.

В каждом разделе отчёта объяснение сопровождается визуализацией: скриншотами до и после при изменениях интерфейса или автоматически созданными диаграммами маршрутизации, потоков и изменений полей при изменениях логики и правил. Для каждого изменения перечислены основные файлы с количеством добавленных и удалённых строк, а сопутствующие правки — например, ссылки, конфигурация и документация — собраны внизу карточки. Сворачиваемое дерево файлов и боковая панель позволяют посмотреть код любого файла до и после изменений.

Сгенерированные файлы находятся в <repo>/.oil-diff/ и исключены из Git, поэтому файлы проекта и состояние git status не меняются. Итоговый HTML — автономный файл, который можно открыть без подключения к интернету. Нужны только системный git и стандартная библиотека Python 3.10+, API-ключи не требуются. Инструмент работает на macOS, Windows и Linux.

Ключевые возможности

  • 01Группирует diff в три-семь изменений на уровне бизнес-задач, а не в список файлов.
  • 02Создаёт единый автономный HTML-отчёт, который можно сразу открыть в браузере.
  • 03Для каждого изменения показывает скриншоты до и после или автоматически созданные диаграммы.
  • 04Отделяет основные файлы для ревью от сопутствующих правок и указывает статистику по строкам.
  • 05Предоставляет сворачиваемое дерево файлов и боковую панель с кодом до и после изменений.
  • 06Сохраняет результат в исключённую из Git папку, не изменяя репозиторий.

Сценарии использования

  • Показать команде набор изменений до или после слияния.
  • Разобраться в большой ветке, сначала получив обзор затронутых областей.
  • Понять, что именно AI-агент для написания кода только что изменил в рабочем дереве.
  • Поделиться автономным HTML-отчётом об изменениях с коллегами, у которых нет доступа к репозиторию.

Быстрый старт

  1. 1

    Установите Skill с помощью npx

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

    Попросите Agent создать отчёт о текущих изменениях

Что важно знать

  • Требуется системная установка git и Python версии 3.10 или выше.
  • Это Agent Skill, поэтому для его использования нужен AI agent, который умеет загружать Skills.

В подборках

Темы

Частые вопросы

Что такое oil-diff?
Skill для AI-агентов превращает изменения Git в одностраничный HTML-отчёт, сгруппированный по бизнес-задачам, а не по файлам. oil-diff — это Skill для AI-агентов, которые пишут код. Он анализирует незакоммиченные изменения, диапазон коммитов или сравнение веток и группирует Git diff в три-семь конкретных изменений. Результат — единый HTML-отчёт в .oil-diff/index.html: рецензент сразу видит, какие бизнес-области затронуты, почему они изменились и какие файлы важнее всего, не прокручивая алфавитный список.
oil-diff можно использовать бесплатно? Какая у него лицензия?
oil-diff распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
oil-diff всё ещё поддерживается?
Активно поддерживается. Последний коммит в oil-diff — 31 окт. 2026 г..
Для чего можно использовать oil-diff?
Показать команде набор изменений до или после слияния. Разобраться в большой ветке, сначала получив обзор затронутых областей. Понять, что именно AI-агент для написания кода только что изменил в рабочем дереве. Поделиться автономным HTML-отчётом об изменениях с коллегами, у которых нет доступа к репозиторию.
Как установить oil-diff?
Установите Skill с помощью npx: npx skills add oil-oil/oil-diff Попросите Agent создать отчёт о текущих изменениях
Где скачать oil-diff?
Исходный код и инструкции по установке — на GitHub: https://github.com/oil-oil/oil-diff

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

CLI-инструмент, который запускает локальный веб-интерфейс в стиле GitHub для просмотра и обсуждения git diff с комментариями, которые можно копировать как промпты для ИИ.

3,3 тыс.+16 за неделю216TypeScriptMITАктивно поддерживаетсяОбновлён 2 месяца назад