giostriquer/agent-workshop

Push

Realiza commit y push de los cambios a la rama actual.

Esta habilidad no está restringida a una rama en particular — siempre opera en la rama actualmente checkout. Adapta la línea de trailer en el paso 8 a continuación según la preferencia de atribución de commits de tu proyecto.

Inicio rápido

1. Detecta la rama actual con git branch --show-current.
2. Si no hay nombre de rama actual, detente y muestra el error.
3. Obtén la última versión de origin/<rama-actual> con git pull --ff-only origin <rama-actual>. Si falla, detente y muestra el error.
4. Inspecciona el diff antes del stage.
5. Prefiere la actualización significativa más reciente en docs/change-log.md como fuente del mensaje de commit, cuando sea relevante.
6. Si la actualización del change-log no es la fuente real del cambio, deriva el mensaje del área principal modificada en el diff.
7. Prepara todos los cambios con git add -A.
8. Realiza el commit con un mensaje multilínea y añade el trailer estándar del proyecto (típicamente una línea Co-Authored-By: o atribución similar; específica del proyecto).
9. Haz push con git push origin <rama-actual>.
10. Reporta la rama, el hash del commit y el asunto en una oración.

Guía de mensajes de commit

Utiliza un asunto conciso de estilo convencional como:

• docs: para documentación o actualizaciones de rutas
• feat: para nuevas capacidades, sistemas o contenido
• fix: para correcciones de comportamiento
• refactor: para cambios estructurales sin cambios mayores de comportamiento
• test: para adiciones o revisiones significativas de la superficie de pruebas
• chore: para trabajo de mantenimiento que no encaja mejor en otro lugar

Para el cuerpo:

• resume las áreas modificadas más significativas
• prefiere 1 línea por cambio mayor
• mantenlo basado en el diff real

Cuando uses docs/change-log.md como fuente:

• prefiere la sección o entrada nueva más significativa que realmente describa el cambio principal
• no fuerces un mensaje derivado del change-log cuando la actualización del log sea incidental

Cuando no uses el change-log como fuente:

• deriva el asunto del área modificada más importante en el diff
• si el diff es demasiado ambiguo para resumirlo con confianza, pregunta al usuario el mensaje de commit en lugar de adivinar

Reglas

• Utiliza siempre la rama actual checkout.
• Nunca uses --force o --force-with-lease.
• Nunca uses --no-verify.
• Falla con claridad: si un paso falla, detente y muestra el error.