Repolode
Enviar
oil-oil

oil-oil/oil-diff

Un Skill para agentes que convierte los cambios de Git en una página HTML de revisión de una sola pantalla, agrupados por propósito de negocio en lugar de por archivo.

Ver en GitHub
Estrellas
88
Forks
7
Issues abiertos
0
Último commit
hace 7 días

¿Qué es?

oil-diff es un Skill para agentes de programación con IA que lee cambios sin confirmar, un rango de commits o una comparación entre ramas, y agrupa el diff de Git en entre tres y siete cambios concretos. Genera un único informe HTML en .oil-diff/index.html para que quien revisa pueda ver qué áreas de negocio cambiaron, por qué y qué archivos son más relevantes, sin desplazarse por una lista alfabética de archivos.

Cada sección del informe combina una explicación con un elemento visual: capturas de pantalla del antes y el después si cambió la interfaz, o diagramas generados de rutas, flujos o cambios en campos para las modificaciones de lógica y reglas. Cada cambio incluye los archivos principales, con el recuento de líneas agregadas y eliminadas; las ediciones de apoyo, como referencias, configuración y documentación, aparecen agrupadas al final de cada tarjeta. Un árbol de archivos plegable y un panel lateral muestran el código anterior y posterior de cualquier archivo.

El resultado se guarda en <repo>/.oil-diff/, una carpeta excluida de Git, por lo que los archivos del proyecto y el estado de Git no se modifican. El HTML final es un archivo autónomo que funciona sin conexión. Solo necesita Git del sistema y la biblioteca estándar de Python 3.10 o posterior; no requiere claves de API y funciona en macOS, Windows y Linux.

Funciones clave

  • 01Agrupa un diff en entre tres y siete cambios de negocio, en lugar de mostrar una lista de archivos.
  • 02Genera un único informe HTML sin conexión que se abre directamente en el navegador.
  • 03Muestra capturas de pantalla del antes y el después, o diagramas generados automáticamente, para cada cambio.
  • 04Separa los archivos principales que hay que revisar de las ediciones de apoyo e incluye estadísticas de líneas.
  • 05Incluye un árbol de archivos plegable y un panel lateral con el código anterior y posterior.
  • 06Guarda el resultado en una carpeta excluida de Git sin modificar el repositorio.

Casos de uso

  • Presentar una ronda de cambios al equipo antes o después de fusionarla.
  • Revisar una rama grande empezando por un resumen de las áreas que cambiaron.
  • Entender qué acaba de modificar un agente de programación con IA en el árbol de trabajo.
  • Compartir con colegas que no tienen acceso al repositorio un resumen de cambios en HTML autónomo.

Inicio rápido

  1. 1

    Instala el Skill con npx

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

    Pídele a tu Agent que genere el informe de tus cambios actuales

Antes de usarlo

  • Requiere tener git instalado en el sistema y Python 3.10 o superior.
  • Es un Agent Skill, así que necesitas un AI agent que pueda cargar Skills para usarlo.

En colecciones

Herramientas de revisión de código con IAAsistentes y agentes de programación con IABibliotecas de skills para agentes de IADiagramas, gráficos y visualizaciones animadas

Temas

#git#diff#code-review#agent-skill#html-report#visualization#developer-tools

Preguntas frecuentes

¿Qué es oil-diff?
Un Skill para agentes que convierte los cambios de Git en una página HTML de revisión de una sola pantalla, agrupados por propósito de negocio en lugar de por archivo. oil-diff es un Skill para agentes de programación con IA que lee cambios sin confirmar, un rango de commits o una comparación entre ramas, y agrupa el diff de Git en entre tres y siete cambios concretos. Genera un único informe HTML en .oil-diff/index.html para que quien revisa pueda ver qué áreas de negocio cambiaron, por qué y qué archivos son más relevantes, sin desplazarse por una lista alfabética de archivos.
¿oil-diff es gratuito? ¿Qué licencia tiene?
oil-diff es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿oil-diff sigue mantenido?
Mantenimiento activo. El último commit de oil-diff fue el 31 oct 2026.
¿Para qué puedo usar oil-diff?
Presentar una ronda de cambios al equipo antes o después de fusionarla. Revisar una rama grande empezando por un resumen de las áreas que cambiaron. Entender qué acaba de modificar un agente de programación con IA en el árbol de trabajo. Compartir con colegas que no tienen acceso al repositorio un resumen de cambios en HTML autónomo.
¿Cómo se instala oil-diff?
Instala el Skill con npx: npx skills add oil-oil/oil-diff Pídele a tu Agent que genere el informe de tus cambios actuales
¿Dónde consigo oil-diff?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/oil-oil/oil-diff

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados