Promover Cambios
Ejecuta el flujo de trabajo completo de lanzamiento desde el estado de trabajo actual hasta un release etiquetado en GitHub en main.
Rama actual: !git branch --show-current 2>/dev/null || echo "desconocida"
Estado de Git: !git status --short 2>/dev/null || echo "no es un repositorio git"
Última etiqueta: !git describe --tags --abbrev=0 2>/dev/null || echo "ninguna"
Commits recientes desde la última etiqueta:
!`git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --oneline -10 2>/dev/null || git log --oneline -10`
Próxima versión (calculada a partir de los commits anteriores):
!`(last=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0"); IFS='.' read -r ma mi pa <<< "${last#v}"; log=$(git log "${last}..HEAD" --format="%s" 2>/dev/null); if echo "$log" | grep -qE "^[a-z]+(\([^)]+\))?!:"; then echo "v$((ma+1)).0.0"; elif echo "$log" | grep -qE "^feat"; then echo "v${ma}.$((mi+1)).0"; else echo "v${ma}.${mi}.$((pa+1))"; fi)`
Paso 0: Verificaciones previas
gh auth status 2>&1 || { echo "ERROR: gh no está autenticado. Ejecuta: gh auth login"; exit 1; }
Verificar archivos .env sin seguimiento que podrían agregarse accidentalmente:
git status --short | grep -E '^\?\? .*\.env' && echo "ADVERTENCIA: se detectaron archivos .env sin seguimiento — revisa antes de agregar"
cat .gitignore 2>/dev/null | grep -q '\.env' || echo "ADVERTENCIA: .gitignore no excluye archivos .env"
Si algún archivo .env se agregaría:
if [ -t 0 ]; then
# Interactivo — pedir confirmación antes de continuar
read -p "ADVERTENCIA: se detectaron archivos .env. ¿Continuar? (y/N) " confirm
[[ "$confirm" =~ ^[Yy]$ ]] || { echo "Cancelado."; exit 1; }
else
# No interactivo — detención forzosa; demasiado arriesgado continuar sin revisión humana
echo "ERROR: se detectaron archivos .env sin seguimiento en modo no interactivo. Abortando."
exit 1
fi
Paso 1: Hacer commit de cualquier cambio sin seguimiento
Si el estado de git anterior muestra cambios sin seguimiento o sin commit:
- Revisar el diff:
git diffygit diff --cached - Agregar cambios de forma selectiva — preferir archivos con seguimiento:
git add -u, luego revisar y agregar archivos nuevos intencionalmente de forma individual. Evitargit add -Aa menos que el usuario lo confirme explícitamente. - Redactar un mensaje de commit convencional a partir de los cambios — comenzar con un prefijo de tipo
(
feat:,fix:,docs:,chore:, etc.) y un resumen conciso - Hacer commit usando un heredoc para que los mensajes multilínea tengan el formato correcto
Si no hay nada sin commit, saltar al Paso 2.
Paso 2: Subir (push)
Subir la rama actual al remoto:
git push -u origin HEAD
Paso 3: Fusionar a main (solo ramas de funcionalidad)
Saltar este paso si ya estás en main (o la rama predeterminada del repositorio).
Si estás en una rama de funcionalidad:
-
Escanear commits desde la última etiqueta en busca de referencias a issues:
git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --format="%B"Buscar
Closes #N,Fixes #N,Resolves #N(sin distinción de mayúsculas/minúsculas). Recopilar todos los números de issue encontrados. Si no se encuentra ninguno:if [ -t 0 ]; then # Interactivo — preguntar al usuario read -p "¿Algún issue de GitHub que esto resuelva? (ej. 12 15 — o presiona Enter para omitir) " issues else # No interactivo — omitir silenciosamente issues="" fi -
Crear un PR con destino a main, incluyendo palabras clave de cierre en el cuerpo para que GitHub cierre los issues automáticamente al fusionar:
gh pr create --title "<tipo>: <resumen>" --body "$(cat <<'EOF' ## Resumen <puntos clave de los commits> Closes #N, Closes #N 🤖 Generado con [claude-workflow-skills:promote](https://github.com/ali5ter/claude-workflow-skills) en nombre de [Alister](https://github.com/ali5ter) EOF )"Omitir las líneas
Closessi no se identificaron issues. -
Habilitar auto-merge (preferir squash):
gh pr merge --auto --squash -
Esperar hasta que se fusione:
gh pr view --json state --jq '.state' -
Cambiar a main y traer los cambios:
git checkout main && git pull
Paso 4: Confirmar la próxima versión
La próxima versión se precalcula en el bloque de contexto anterior usando estas reglas semver:
- Asunto del commit con
!:(ej.feat!:,fix!:) → incremento major - Asunto del commit que comienza con
feat→ incremento minor - Todos los demás commits → incremento patch
Confirmar que la versión calculada sea correcta según la lista de commits. Si no existe una etiqueta anterior, usar
v1.0.0. Sobrescribir solo si la versión calculada está claramente incorrecta (por ejemplo, la inyección devolvió
un error o una salida vacía).
Paso 5: Sincronizar el manifiesto del plugin (si existe)
Si existe .claude-plugin/plugin.json, actualizar su campo version a <next-version> (sin prefijo v
— los manifiestos de plugin usan semver simple, como 1.2.3):
node -e "
const fs = require('fs');
const f = '.claude-plugin/plugin.json';
const d = JSON.parse(fs.readFileSync(f, 'utf8'));
d.version = '<next-version>';
fs.writeFileSync(f, JSON.stringify(d, null, 2) + '\n');
"
Luego hacer commit y subir:
git add .claude-plugin/plugin.json
git commit -m "chore: sincronizar versión de plugin.json a v<next-version>"
git push
Saltar este paso por completo si .claude-plugin/plugin.json no existe.
Paso 6: Etiquetar y publicar release
git tag -a v<next-version> -m "Release v<next-version>"
git push origin v<next-version>
gh release create v<next-version> \
--generate-notes \
--title "v<next-version>"
Paso 7: Cerrar issues resueltos (solo rama main)
Saltar este paso si se creó un PR en el Paso 3 — GitHub cerrará los issues automáticamente cuando
el PR se fusione mediante las palabras clave Closes #N en el cuerpo del PR.
Si la promoción fue directamente en main (sin PR), cerrar los issues identificados ahora:
gh issue close <N> --comment "Resuelto en $(gh release view v<next-version> --json url --jq '.url')"
Paso 8: Limpiar la rama de funcionalidad fusionada
Si se fusionó una rama de funcionalidad en el Paso 3, eliminarla local y remotamente:
git branch -d <rama-funcionalidad>
git push origin --delete <rama-funcionalidad>
Paso 9: Confirmar estado limpio
git status
git log --oneline -5
Reportar la URL del release de GitHub desde gh release view v<next-version> --json url --jq '.url'.