Git

• Tareas de repositorio: Cualquier tarea que implique un repositorio de Git — crear ramas, preparar cambios, hacer commits, hacer push o abrir pull requests.
• Colaboración en equipo: Cuando la seguridad del historial es importante y necesitas flujos de ramas de funcionalidades, flujos de trabajo de hotfix o higiene de commits lista para PR aplicada automáticamente.
• Depuración del historial: Cuando necesitas rastrear regresiones con git bisect, recuperar commits perdidos mediante git reflog o deshacer cambios de forma segura.
• Resolución de conflictos: Cuando los merges o rebases producen conflictos y el agente necesita un enfoque estructurado y verificado para resolverlos.

• Control de versiones no-Git: Si el proyecto usa Mercurial, SVN u otro sistema de control de versiones, los comandos de esta habilidad no serán aplicables.
• Tareas de análisis de solo lectura: Si el agente únicamente necesita leer el código fuente sin interactuar con Git en absoluto, la habilidad añade una sobrecarga innecesaria.

La habilidad impone --force-with-lease sobre --force para evitar sobreescribir el trabajo de los compañeros de equipo, y prohíbe el force-push en ramas compartidas como main/master. Se debe satisfacer una lista de verificación de seguridad integrada antes de cualquier operación destructiva como reset --hard o rebase.

Incluye flujos paso a paso para escenarios de Feature Branch y Hotfix, incluyendo cuándo aplastar commits, cómo sincronizar con git fetch --all --prune, y cómo etiquetar versiones. Diseñado para adaptarse tanto a equipos con desarrollo basado en trunk como a equipos que usan el estilo gitflow.

Después de editar los archivos con conflictos, la habilidad verifica que no queden marcadores de conflicto usando grep, confirma que el código compila correctamente y ofrece una vía de escape mediante git merge --abort cuando una fusión se vuelve demasiado compleja. Se sugiere el rebase como alternativa cuando las fusiones se complican.

Cubre git reflog para recuperar commits perdidos (hasta ~90 días), restaurar ramas eliminadas mediante SHA, y deshacer commits sin perder trabajo usando git reset --soft. También incluye un flujo de trabajo completo con git bisect para identificar con precisión los commits que introducen regresiones.

La habilidad impone el formato de mensaje de commit type(scope): description con una primera línea de menos de 72 caracteres, utilizando tipos estándar (feat, fix, docs, refactor, etc.). Esto mantiene el historial legible y compatible con herramientas automatizadas de registro de cambios.

Documenta y protege contra los errores frecuentes de Git: estado de HEAD desvinculado, problemas de sensibilidad a mayúsculas y minúsculas entre macOS/Windows y Linux CI, errores al clonar submódulos, conflictos al recuperar el stash, y la confirmación accidental de archivos grandes o secretos. Usa git add -p para una preparación parcial y granular.

Un agente construye una nueva funcionalidad, crea una rama desde main, realiza commits de forma incremental con mensajes convencionales, hace rebase sobre el último main antes de enviar los cambios, aplasta los commits de corrección y abre una rama lista para PR — todo sin intervención manual en Git.

Cuando se detecta un error en producción, el agente crea una rama hotfix/ a partir de main, aplica la corrección, la fusiona tanto en main como en develop, etiqueta la versión y elimina la rama, siguiendo con precisión el flujo de hotfix documentado.

El agente ejecuta git bisect para realizar una búsqueda binaria en el historial de commits, marcando commits como buenos o malos en función de los resultados de pruebas automatizadas, hasta identificar el commit exacto que introdujo un error.

Durante un rebase de rama de funcionalidad de larga duración, el agente resuelve los conflictos archivo por archivo, verifica que no queden marcadores <<</>>>, confirma que la compilación pasa correctamente y continúa el rebase — o lo aborta de forma limpia si el conflicto es demasiado complejo.