Repolode
Enviar
tanishqkancharla

tanishqkancharla/diffmap

Una skill para que los agentes de programación expliquen sus cambios de código con diagramas interactivos, cuyos elementos enlazan al código fuente correspondiente.

Ver en GitHubSitio web
Estrellas
238
Forks
9
Issues abiertos
1
Último commit
anteayer

¿Qué es?

diffmap ayuda a los desarrolladores a revisar código escrito por agentes de programación. El agente redacta una especificación en Markdown que incluye diagramas interactivos de Mermaid, diagramas animados de servicios que se pueden recorrer paso a paso y diferencias entre diagramas y pilas de llamadas. Cada elemento de un diagrama enlaza al archivo, símbolo o commit correspondiente, para que quien revisa pueda pasar de un cuadro o una línea de la imagen al código que representa.

Las especificaciones se muestran en un visor local que se inicia con npx. También incluye un panel Diff, comentarios en línea que se pueden copiar como una lista en Markdown para un agente y compatibilidad con tarjetas de commits que enumeran los archivos que hay que revisar, en orden. Las especificaciones también se pueden compartir como GitHub gists sin listar y abrir en diffmap.dev. El proyecto es un paquete de TypeScript con una API de biblioteca para analizar su formato Markdown.

Funciones clave

  • 01Genera diagramas interactivos de Mermaid y diagramas animados de servicios a partir de especificaciones escritas por agentes.
  • 02Muestra diferencias entre diagramas y pilas de llamadas, e indica qué elementos solo aparecen en la versión actual o en la propuesta.
  • 03Enlaza los nodos de los diagramas, las filas de las pilas de llamadas y las referencias en el texto con archivos de código fuente, símbolos o commits.
  • 04Ofrece un visor local con un panel Diff y comentarios en línea que se pueden copiar para un agente.
  • 05Comparte especificaciones como GitHub gists sin listar, que se pueden ver en diffmap.dev.

Casos de uso

  • Revisar un cambio grande generado por un agente de programación antes de integrarlo.
  • Explicar a un compañero el flujo de una solicitud o los cambios de estado en una rama de funcionalidad.
  • Dejar comentarios línea por línea en el diff de un agente y enviárselos en forma de lista numerada.
  • Compartir con un equipo, mediante un enlace, una explicación de una solicitud de incorporación de cambios que se pueda revisar.

Inicio rápido

  1. 1

    Pega el prompt de diffmap en tu agente para probarlo en un repositorio con cambios

  2. 2

    Instala la skill generate-diffmap

    npx skills add tanishqkancharla/diffmap --skill generate-diffmap
  3. 3

    Ejecuta el visor local con un archivo spec

    npx @tanishqkancharla/diffmap serve path/to/file.md

Antes de usarlo

  • Compartir un spec mediante un enlace es experimental y requiere iniciar sesión en gh CLI.
  • Los visores alojados en Gist obtienen el Gist desde el navegador a través de api.github.com.

En colecciones

Frameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IADiagramas, gráficos y visualizaciones animadasGeneradores de sitios estáticos y herramientas de documentación

Temas

#ai-agent#code-review#diagrams#mermaid#developer-tools#typescript#markdown#visualization

Preguntas frecuentes

¿Qué es diffmap?
Una skill para que los agentes de programación expliquen sus cambios de código con diagramas interactivos, cuyos elementos enlazan al código fuente correspondiente. diffmap ayuda a los desarrolladores a revisar código escrito por agentes de programación. El agente redacta una especificación en Markdown que incluye diagramas interactivos de Mermaid, diagramas animados de servicios que se pueden recorrer paso a paso y diferencias entre diagramas y pilas de llamadas. Cada elemento de un diagrama enlaza al archivo, símbolo o commit correspondiente, para que quien revisa pueda pasar de un cuadro o una línea de la imagen al código que representa.
¿diffmap es gratuito? ¿Qué licencia tiene?
diffmap es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿diffmap sigue mantenido?
Mantenimiento activo. El último commit de diffmap fue el 6 nov 2026.
¿Para qué puedo usar diffmap?
Revisar un cambio grande generado por un agente de programación antes de integrarlo. Explicar a un compañero el flujo de una solicitud o los cambios de estado en una rama de funcionalidad. Dejar comentarios línea por línea en el diff de un agente y enviárselos en forma de lista numerada. Compartir con un equipo, mediante un enlace, una explicación de una solicitud de incorporación de cambios que se pueda revisar.
¿Cómo se instala diffmap?
Pega el prompt de diffmap en tu agente para probarlo en un repositorio con cambios Instala la skill generate-diffmap: npx skills add tanishqkancharla/diffmap --skill generate-diffmap Ejecuta el visor local con un archivo spec: npx @tanishqkancharla/diffmap serve path/to/file.md
¿Dónde consigo diffmap?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/tanishqkancharla/diffmap

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

Proyectos relacionados