Instala la habilidad belt CLI:
npx skills add belt-sh/cli
Registro de cambios de producto
Escribe registros de cambios y notas de versión que los usuarios lean y les importen a través de la CLI de inference.sh.
Inicio rápido
Requiere la CLI de inference.sh (
belt). Instrucciones de instalación
belt login
# Genera una imagen visual de anuncio de funcionalidad
belt app run falai/flux-dev-lora --input '{
"prompt": "clean product UI screenshot mockup, modern dashboard interface showing a new analytics chart feature, light mode, minimal design, professional SaaS product",
"width": 1248,
"height": 832
}'
Formato de entrada
La anatomía de una buena entrada
### Nuevo: Exportación masiva para informes 📊
Ahora puedes exportar hasta 10,000 filas de una sola vez desde cualquier vista de informe.
Selecciona tus filas, haz clic en Exportar y elige formato CSV o Excel.
Anteriormente limitado a 500 filas por exportación.
Estructura: Etiqueta de categoría -> Título orientado al usuario -> Qué puedes hacer ahora -> Cómo -> Qué cambió -> Imagen
Lenguaje orientado al usuario
❌ Lenguaje interno:
"Implementación de la cola de procesamiento por lotes para el servicio de exportación"
"Refactorización de la clase ReportExporter para soportar paginación"
"Corrección de error en la serialización CSV (PR #4521)"
✅ Lenguaje orientado al usuario:
"Ahora puedes exportar hasta 10,000 filas de una sola vez desde cualquier informe"
"Los informes ahora se cargan 3 veces más rápido al filtrar grandes conjuntos de datos"
"Se corrigió un problema por el cual los archivos CSV exportados tenían columnas faltantes"
Reglas:
- Escribe lo que el usuario puede HACER, no lo que CONSTRUISTE
- Comienza con "Ahora puedes..." / "Los informes ahora..." / "Se corrigió un problema por el cual..."
- Incluye el beneficio, no solo el mecanismo
- Usa tiempo presente
Categorías
Categorías estándar
| Categoría | Color | Icono | Uso |
|---|---|---|---|
| Nuevo | Verde | ✨ o 🆕 | Funcionalidades o capacidades completamente nuevas |
| Mejorado | Azul | ⚡ o 🔧 | Mejoras en funcionalidades existentes |
| Corregido | Amarillo/Naranja | 🐛 o 🔨 | Correcciones de errores |
| Eliminado | Rojo | 🗑️ o ⚠️ | Funcionalidades obsoletas o eliminadas |
| Seguridad | Púrpura | 🔒 | Parches de seguridad |
Reglas de categorización
- Nuevo = algo que los usuarios no podían hacer antes
- Mejorado = algo que los usuarios podían hacer, ahora es mejor/más rápido/más fácil
- Corregido = algo que estaba roto, ahora funciona correctamente
- No uses "Actualizado" — es irrelevante. ¿Fue mejorado o corregido?
Numeración de versiones
Versionado semántico (SemVer)
MAYOR.MENOR.PARCHE
3 . 2 . 1
| Componente | Incrementar cuando | Ejemplo |
|---|---|---|
| MAYOR | Cambios que rompen la compatibilidad, rediseño importante | 2.0.0 -> 3.0.0 |
| MENOR | Nuevas funcionalidades, compatible con versiones anteriores | 3.1.0 -> 3.2.0 |
| PARCHE | Correcciones de errores, pequeñas mejoras | 3.2.0 -> 3.2.1 |
Versionado basado en fecha
2026-02-08 o 2026.02.08 o 8 de febrero de 2026
Ideal para productos SaaS con despliegue continuo.
Estructura de la página de registro de cambios
# Registro de cambios
## 8 de febrero de 2026
### Nuevo
- **Exportación masiva para informes** — Exporta hasta 10,000 filas de una sola vez. [Más información →](enlace)
- **Modo oscuro** — Activa el modo oscuro desde Configuración > Apariencia.
### Mejorado
- **Carga del panel** — Los paneles ahora se cargan 3 veces más rápido en grandes conjuntos de datos.
- **Búsqueda** — Los resultados de búsqueda ahora incluyen elementos archivados.
### Corregido
- Se corrigió un problema por el cual los archivos CSV exportados tenían encabezados de columna faltantes.
- Se corrigió un error por el cual el selector de fecha mostraba una zona horaria incorrecta.
---
## 1 de febrero de 2026
### Nuevo
- **Webhooks de API** — Recibe notificaciones cuando ocurran eventos en tu cuenta.
### Corregido
- Se corrigió un problema por el cual las notificaciones por correo electrónico se retrasaban hasta 2 horas.
Registros de cambios visuales
Cuándo agregar imágenes
| Tipo de cambio | Imagen |
|---|---|
| Nueva funcionalidad de IU | Captura de pantalla de la nueva funcionalidad |
| Rediseño de IU | Comparativa antes/después |
| Nuevo flujo de trabajo | Capturas de pantalla paso a paso o video corto |
| Mejora de rendimiento | Gráfico que muestra la mejora |
| Funcionalidad compleja | GIF animado o demo en video |
Generación de imágenes
# Captura de pantalla de funcionalidad (si tienes la aplicación en ejecución, usa el navegador agente)
belt app run infsh/agent-browser --input '{
"url": "https://tu-app.com/nueva-funcionalidad",
"action": "screenshot"
}'
# Comparativa antes/después
belt app run infsh/stitch-images --input '{
"images": ["captura-antes.png", "captura-despues.png"],
"direction": "horizontal"
}'
# Captura de pantalla anotada con llamada
belt app run bytedance/seededit-3-0-i2i --input '{
"prompt": "add a red circle highlight around the export button in the top right area",
"image": "captura.png"
}'
# Banner de anuncio de funcionalidad
belt app run falai/flux-dev-lora --input '{
"prompt": "clean modern product announcement banner, gradient blue to purple background, abstract geometric shapes, professional SaaS aesthetic, wide format",
"width": 1248,
"height": 832
}'
Cambios que rompen la compatibilidad
Los cambios que rompen la compatibilidad necesitan un tratamiento especial:
### ⚠️ Cambio importante: Endpoints de API v2 obsoletos
**Qué cambió:** Los endpoints de API v1 dejarán de funcionar el 15 de marzo de 2026.
**Qué necesitas hacer:**
1. Actualiza tus llamadas a la API para usar endpoints v2 ([guía de migración →](enlace))
2. Actualiza la autenticación para usar tokens Bearer en lugar de claves de API
3. Prueba tu integración antes del 15 de marzo
**Cronograma:**
- Ahora: endpoints v2 disponibles, v1 sigue funcionando
- 1 de marzo: v1 devuelve advertencias de obsolescencia
- 15 de marzo: v1 deja de funcionar
Si necesitas ayuda con la migración, contacta a [email protected].
Canales de distribución
| Canal | Formato | Cuándo |
|---|---|---|
| Página de registro de cambios | Detalle completo, todas las entradas | Cada versión |
| Notificación en la aplicación | Resumen de 1-2 líneas | Nuevas funcionalidades, cambios importantes |
| Correo electrónico | Destacados seleccionados, imágenes | Versiones importantes (mensual/trimestral) |
| Publicación en blog | Análisis profundo con contexto | Grandes lanzamientos |
| Redes sociales | Destacado de una sola funcionalidad | Funcionalidades notables |
| Slack/Discord | Anuncio breve | Si tienes una comunidad |
Formato de snippet para redes sociales
🆕 Nuevo en [Producto]: [Nombre de la funcionalidad]
[Descripción de 1-2 oraciones de lo que ahora puedes hacer]
[Captura de pantalla o video demo]
Pruébalo ahora → [enlace]
Consejos de redacción
Haz
- Agrupa los cambios relacionados
- Lidera con el cambio más grande/más solicitado
- Enlaza a la documentación para funcionalidades complejas
- Incluye quién lo solicitó ("Por petición popular:")
- Muestra rutas de migración para cambios importantes
- Fecha cada entrada
No hagas
- No digas "varias correcciones de errores" — lista correcciones específicas o sáltalas
- No incluyas referencias internas (números de PR, IDs de tickets, nombres de ramas)
- No uses "Se actualizó [funcionalidad]" sin decir cómo
- No incluyas cambios que a nadie le importan (actualizaciones de dependencias, refactorizaciones internas)
- No vuelques el historial de commits — una entrada de registro de cambios puede representar muchos commits
Frecuencia del registro de cambios
| Tipo de producto | Frecuencia | Notas |
|---|---|---|
| SaaS (despliegue continuo) | Lote semanal | Agrupa los cambios de una semana |
| SaaS (funcionalidades importantes) | Por lanzamiento de funcionalidad | Con publicación en blog |
| Software versionado | Por versión | Vinculado a semver |
| API | Por versión + avisos de obsolescencia | Incluye guías de migración |
| Aplicación móvil | Por versión en la tienda | Coincide con "Novedades" de la tienda |
Errores comunes
| Error | Problema | Solución |
|---|---|---|
| Lenguaje de desarrollador | Los usuarios no entienden | Escribe lo que los usuarios pueden hacer |
| "Correcciones de errores y mejoras" | Información nula | Lista correcciones específicas |
| Sin fechas | No se puede saber qué es nuevo | Fecha cada entrada |
| Sin imágenes | Los usuarios se saltan el texto | Captura de pantalla de las funcionalidades principales |
| Cambios importantes ocultos | Los usuarios se enteran demasiado tarde | Advertencia destacada + cronograma |
| Registro de commits como registro de cambios | Ruidoso, inútil | Selecciona y reescribe |
Habilidades relacionadas
npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering
Explora todas las aplicaciones: belt app list