Remotion Bits Release
Usa este skill cuando prepares y publiques una nueva release de remotion-bits desde este repositorio.
Qué Hace Este Skill
Este skill realiza el flujo de trabajo completo de release:
- Aumenta la versión en
./package.json. Por defecto, un aumento de tipo patch a menos que el usuario solicite explícitamente minor, major o una versión específica. - Actualiza
CHANGELOG.mdcon notas de release concisas para la nueva versión. - Ejecuta
npm run registry:build. - Realiza el commit de los cambios de release con
chore: vX.Y.Z. - Hace push del commit de release a
master. - Investiga los cambios notables desde la release anterior en el historial de Git y los PRs fusionados.
- Abre el formulario de release de GitHub prellenado con el navegador del sistema, no el navegador interno.
- Después de que la release de GitHub se publique, despliega la documentación con
./scripts/deploy-docs.sh. - Publica el paquete en npm con
npm publish.
Precondiciones
- Trabaja desde la raíz del repositorio.
- No inicies el servidor de desarrollo de documentación.
- Asume que la publicación de la release requiere credenciales válidas de GitHub, Cloudflare y npm ya configuradas en el entorno.
- Si el working tree contiene cambios no relacionados del usuario, no los reviertas. O trabaja alrededor de ellos o detente y pregunta antes de tocarlos si afectan los archivos de release.
Flujo de Release
1. Determinar la Versión Objetivo
- Lee la versión actual desde
./package.json. - Si el usuario dio una versión específica, úsala.
- Si el usuario dio un tipo de aumento, aplícalo.
- De lo contrario, aumenta patch.
- La etiqueta git y el título de la release deben ser
vX.Y.Z.
2. Preparar las Notas de Release
- Revisa los commits desde la última etiqueta de release.
- Revisa los PRs fusionados cuando ayuden a resumir los cambios.
- Actualiza
CHANGELOG.mdinsertando la sección de la nueva versión al principio. - Mantén las entradas concisas y orientadas al usuario.
- Usa este formato:
### vX.Y.Z
- Característica: Breve descripción de la nueva funcionalidad
- Corrección: Breve descripción de la corrección de errores
- Mejora: Breve descripción de la mejora
- Documentación: Breve descripción del cambio en la documentación
3. Aumentar la Versión y Construir el Registro
- Actualiza
./package.jsona la nueva versión. - Ejecuta:
npm run registry:build
- Si la construcción falla, detente y corrige el problema subyacente antes de continuar.
4. Commit y Push de la Release
- Revisa el diff de la release.
- Realiza el commit de la release preparada con:
git commit -am "chore: vX.Y.Z"
- Haz push del commit a
master. - Si el repositorio está por detrás del remoto o el push falla, resuelve ese estado antes de continuar.
5. Crear el Borrador de la Release de GitHub
- Construye las notas de release a partir del resumen del changelog y los commits recientes.
- Abre esta URL con
xdg-openu otro comando de apertura a nivel de sistema, nunca el navegador interno:
https://github.com/everlier/remotion-bits/releases/new?tag=vX.Y.Z&target=master&title=vX.Y.Z&body=...
-
Prellena el formulario con:
tag:vX.Y.Ztarget:mastertitle:vX.Y.Zprerelease:false
-
El cuerpo de la release debe seguir esta estructura:
## Novedades
- Una frase corta por cada nueva funcionalidad notable.
- Una frase corta por cada corrección de errores notable.
- Una frase corta por cada mejora notable.
**Changelog Completo**: https://github.com/everlier/remotion-bits/compare/vX.Y.(Z-1)...vX.Y.Z
- Pausa para que el usuario publique la release de GitHub si se requiere confirmación en el navegador.
6. Desplegar la Documentación
- Después de que la release de GitHub se publique, ejecuta:
./scripts/deploy-docs.sh
7. Publicar en npm
- Confirma que la autenticación de npm esté disponible.
- Publica desde la raíz del repositorio:
npm publish
Reglas de Decisión
- Por defecto, las releases son de tipo patch a menos que el usuario indique lo contrario.
- Si las notas de release no están claras, derívalas del historial de commits antes de preguntar al usuario.
- Si un comando modifica artefactos de release, mantén esos cambios generados en el commit de release.
- Si la publicación requiere un paso manual en el navegador, detente en el límite, dile exactamente al usuario qué está esperando y luego continúa después de la confirmación.
- Si faltan credenciales para GitHub, Cloudflare o npm, detente e informa del requisito faltante en lugar de reintentar ciegamente.
Lista de Verificación de Finalización
package.jsontiene la versión objetivo.CHANGELOG.mdtiene una nueva sección superior para esa versión.npm run registry:buildse completó correctamente.- El commit de release
chore: vX.Y.Zexiste y se ha hecho push amaster. - El formulario de release de GitHub se abrió con los valores prellenados correctos.
- El despliegue de documentación se completó.
npm publishse completó correctamente.