AgentSkillsCN

changelog-gen

根据git提交自动生成面向用户的更新日志。分析历史记录、分类更改,并将技术性提交转化为清晰、友好的客户发布说明。

SKILL.md
--- frontmatter
name: changelog-gen
description: Crea automáticamente changelogs orientados al usuario a partir de commits de git. Analiza el historial, categoriza los cambios y transforma commits técnicos en notas de release claras y amigables para el cliente.

Generador de Changelog

Esta skill transforma los commits técnicos de git en changelogs elegantes y fáciles de usar que tus clientes y usuarios realmente entenderán y apreciarán.

Cuándo usar esta Skill

  • Preparar las notas para una nueva release de software.
  • Crear resúmenes semanales o mensuales de actualizaciones de producto.
  • Documentar cambios para los clientes.
  • Escribir las novedades para las tiendas de aplicaciones (App Store, Play Store).
  • Generar notificaciones de actualización.
  • Crear documentación interna sobre los lanzamientos.
  • Mantener una página pública de changelog o actualizaciones de producto.

Qué Hace esta Skill

  1. Escanea el Historial de Git: Analiza los commits de un período de tiempo específico o entre versiones.
  2. Categoriza los Cambios: Agrupa los commits en categorías lógicas (funcionalidades, mejoras, correcciones de errores, cambios disruptivos, seguridad).
  3. Traduce de Técnico a Amigable: Convierte el lenguaje de los commits de desarrollador a uno orientado al cliente.
  4. Formatea Profesionalmente: Crea entradas de changelog limpias y estructuradas.
  5. Filtra el Ruido: Excluye commits internos (refactorización, tests, etc.).
  6. Sigue las Mejores Prácticas: Aplica directrices de changelog y la voz de tu marca.

Cómo Usar

Uso Básico

Desde el repositorio de tu proyecto:

code
Crea un changelog con los commits desde la última release
code
Genera un changelog para todos los commits de la última semana
code
Crea las notas de la release para la versión 2.5.0

Con Rango de Fechas Específico

code
Crea un changelog para los commits entre el 1 y el 15 de marzo

Con Guías de Estilo Personalizadas

code
Crea un changelog para los commits desde la v2.4.0, usando mis guías de estilo definidas en ESTILO_XXX.md.

Si el cliente no indica un estilo explícitamente, usa ESTILO_CHANGELOG como estilo predeterminado.

Ejemplo

Usuario: "genera el changelog de esta semana"

Salida:

markdown
# Actualizaciones - Semana del 2026-01-07 al 2026-01-14

  ## Nuevas funcionalidades

  - Soporte A2A end-to-end: bindings HTTP+JSON y JSON-RPC, scaffolding gRPC, almacenamiento de tareas, suscripciones y push config para interoperar entre agentes.
  - Discovery avanzado: nuevos providers, registro y soporte de AgentCard para descubrimiento de agentes y reintentos.
  - Gobernanza configurable: loader y motor de politicas con integracion en demos y ejemplo de politica deny.
  - Planner mas rico: condiciones avanzadas y auditoria; mejora de hooks de auditoria.

  ## Mejoras

  - Experiencia de demo y UI: streaming web, estilos finales de UI, defaults de discovery y guias de ejecucion mas claras.
  - CLI y operaciones: comandos avanzados, overrides de config via CLI y barrido runtime.
  - Observabilidad: propagacion de trace context en A2A gRPC.

  ## Correcciones

  - Runner y scripts: arreglos en argumentos y expansion de config del demo runner; flag verbose consistente.
  - A2A y tareas: correcciones en manejo de task id y validacion de recursos/operaciones terminales.

  ## Documentacion

  - Arquitectura y roadmap: actualizaciones de estado A2A/planner y avances de roadmap.e
  - Demos y ejemplos: referencias de ejecucion de agentes y ajustes en ejemplos MCP.

Consejos

  • Ejecuta la skill desde la raíz de tu repositorio git.
  • Especifica rangos de fechas para changelogs más acotados.
  • Usa tu propio fichero ESTILO_CHANGELOG.md para un formato consistente. Si no se especifica, se usa ESTILO_CHANGELOG.md por defecto.
  • Revisa y ajusta el changelog generado antes de publicarlo.
  • Guarda la salida directamente en tu fichero CHANGELOG.md.

Casos de Uso Relacionados

  • Crear las notas de una release en GitHub.
  • Escribir las descripciones de actualización para tiendas de aplicaciones.
  • Generar correos electrónicos de actualización para usuarios.
  • Crear publicaciones para anunciar novedades en redes sociales.