Integración con control de versiones
Trabajar con Git y otros sistemas de control de versiones
Verdent for VS Code se integra a la perfección con Git y otros sistemas de control de versiones, lo que permite operaciones de control de versiones en lenguaje natural, generación automática de mensajes de commit y gestión inteligente de ramas. Esta guía te muestra cómo aprovechar la integración con Git de Verdent para flujos de trabajo de control de versiones eficientes.
Crear mensajes de commit significativos
Supón que hiciste cambios y quieres que Verdent genere un mensaje de commit descriptivo.
Solicitar un commit con un mensaje generado
Stage all changes and create a commit with an appropriate messageVerdent analiza tus cambios usando git diff.
Verdent analiza los cambios
Verdent examina:
- Los archivos modificados y su propósito
- La naturaleza de los cambios (nueva función, corrección de errores, refactorización)
- El alcance del impacto
- La funcionalidad relacionada
Genera un mensaje de commit descriptivo
git commit -m "feat: add user profile image upload with S3 integration
- Add file upload endpoint to user API
- Integrate AWS S3 for image storage
- Update user model with profileImage field
- Add frontend image upload component with preview"El mensaje sigue el formato de commit convencional y describe lo que cambió.
Se crea el commit
Los cambios se confirman con el mensaje generado. Puedes revisar el commit:
git log -1Consejos:
- Verdent sigue los formatos de commit convencionales (feat, fix, refactor, docs, etc.)
- Los mensajes de commit se centran en el "qué" y el "porqué", no en el "cómo"
- Puedes personalizar el formato de los mensajes de commit en las reglas de usuario o las reglas de proyecto
- Solicita estilos de mensaje de commit específicos: "Crea un commit con un mensaje detallado de varias líneas"
Personalizar los formatos de los mensajes de commit
Supón que quieres que Verdent siga las convenciones de mensajes de commit específicas de tu equipo.
Define las preferencias de mensajes de commit en VERDENT.md para todos los proyectos:
# VERDENT.md
## Git Commit Messages
When generating commit messages:
- Always include ticket number in format: [PROJ-123]
- Use present tense verbs
- Maximum 50 characters for first line
- Include detailed explanation in body
- Add "Co-authored-by" for pair programming sessions
Example format:
[PROJ-123] Add user authentication feature
Detailed explanation of changes...
Co-authored-by: Team Member <email@example.com>Verdent sigue estas reglas de forma global.
Define convenciones de commit específicas del proyecto en AGENTS.md:
# AGENTS.md
## Git Commit Conventions
For this project, use conventional commits with these scopes:
- feat(api): API changes
- feat(ui): Frontend changes
- fix(auth): Authentication fixes
- docs(readme): Documentation updates
Always reference GitHub issue: "Fixes #123" or "Relates to #456"Las reglas se aplican solo a este proyecto.
Proporciona instrucciones puntuales directamente:
Create a commit with message format: "[TICKET-NUMBER] description" including reference to issue #42Verdent genera:
git commit -m "[PROJ-42] Add search functionality
Relates to #42"Consejos:
- Las reglas de usuario se aplican de forma global a todos los proyectos
- Las reglas de proyecto (AGENTS.md) anulan las reglas de usuario en proyectos específicos
- Las instrucciones en línea anulan ambas para necesidades puntuales
- Se recomienda el formato Conventional Commits para mantener la coherencia
Crear pull requests
Supón que quieres que Verdent cree un pull request completo.
Asegúrate de que los cambios estén confirmados
Make sure all my changes are committedVerdent verifica el estado de git y confirma cualquier cambio sin confirmar.
Subir la rama al remoto
Push this branch to originVerdent sube:
git push origin feature/user-notificationsSolicitar la creación del PR
Create a pull request for this featureVerdent usa la CLI de gh para crear el PR.
Verdent genera la descripción del PR
Verdent analiza los commits y los cambios para generar:
Título: Añadir sistema de notificaciones de usuario
Cuerpo:
## Summary
- Implements real-time user notifications
- Adds WebSocket support for instant delivery
- Includes email fallback for offline users
- Comprehensive test coverage
## Test Plan
- [ ] Test real-time notifications in browser
- [ ] Verify email fallback for offline users
- [ ] Check notification persistence across sessions
- [ ] Test with multiple concurrent users
## Changes
- Added NotificationService with WebSocket integration
- Created notification UI components
- Integrated SendGrid for email notifications
- Added notification preferences to user settingsEl PR se crea con una descripción completa.
Consejos:
- Verdent analiza todos los commits de la rama para generar la descripción del PR
- Solicita formatos de PR específicos: "Crea un PR con un plan de pruebas detallado"
- Incluye capturas de pantalla: "Añade esta captura de pantalla a la descripción del PR"
- Puedes refinar la descripción del PR antes de crearlo: "Actualiza el PR para mencionar el cambio incompatible"
Resolver conflictos de fusión
Supón que te encuentras con conflictos de fusión y necesitas la ayuda de Verdent para resolverlos.
Intentar la fusión
Merge main into this feature branchSe produce un conflicto de fusión:
Auto-merging src/auth.ts
CONFLICT (content): Merge conflict in src/auth.tsSolicitar la resolución del conflicto
Help me resolve the merge conflict in src/auth.tsVerdent lee los marcadores de conflicto.
Verdent analiza ambas versiones
Verdent examina:
- Los cambios de la rama actual (HEAD)
- Los cambios entrantes (rama main)
- El contexto alrededor de los conflictos
- La intención de ambos cambios
Verdent propone una resolución
The conflict is between your JWT implementation and the main branch's session-based auth. I'll merge both approaches to support both authentication methods.Verdent resuelve el conflicto integrando ambos cambios de forma inteligente.
Marcar el conflicto como resuelto
git add src/auth.ts
git commit -m "Merge main into feature/jwt-auth, resolved conflicts"El conflicto se resuelve y la fusión se completa.
Consejos:
- Verdent entiende el contexto del código para resolver los conflictos de forma inteligente
- Revisa siempre las resoluciones de conflictos antes de confirmar
- Para conflictos complejos, pídele a Verdent que explique primero ambas versiones
- Prueba a fondo después de resolver los conflictos
Verdent analiza los conflictos de fusión entendiendo la intención de ambas ramas y sugiere resoluciones que preservan la funcionalidad de ambos lados.
Gestionar ramas y etiquetas
Supón que necesitas gestionar ramas y crear etiquetas de versión.
Crear y cambiar de rama:
Create a new branch called feature/user-notificationsVerdent ejecuta:
git checkout -b feature/user-notificationsgit checkout maingit checkout -b feature/payment-integration
git push -u origin feature/payment-integrationFusionar ramas de funciones:
Merge the feature/user-notifications branch into mainVerdent realiza el flujo de trabajo de fusión:
git checkout main
git pull origin main
git merge feature/user-notifications
git push origin mainVerdent se asegura de que main esté actualizada antes de fusionar.
Crear etiquetas anotadas:
Create an annotated tag for version 1.2.0 with release notesVerdent crea una etiqueta detallada:
git tag -a v1.2.0 -m "Release 1.2.0
New Features:
- User notification system
- Email integration
- Real-time WebSocket support
Bug Fixes:
- Fixed authentication timeout issue
- Resolved cart calculation bug"Subir etiquetas:
Push all tags to originVerdent sube:
git push origin --tagsConsejos:
- Usa nombres de rama descriptivos:
feature/user-auth,fix/cart-bug,refactor/api-layer - Trae siempre los últimos cambios antes de fusionar
- Usa etiquetas anotadas para las versiones (incluyen metadatos)
- Sigue el versionado semántico: v1.2.3 (mayor.menor.parche)
Las convenciones de nombres de rama coherentes ayudan a Verdent a entender tu flujo de trabajo. Define patrones en AGENTS.md para el cumplimiento automático.
Preguntas frecuentes
¿Verdent confirma automáticamente mis cambios?
No. Verdent solo crea commits cuando lo solicitas explícitamente. Mantienes el control total sobre cuándo se confirman los cambios. Simplemente pide "Prepara todos los cambios y crea un commit" cuando estés listo.
¿Puedo editar el mensaje de commit antes de confirmar?
Sí. Puedes pedirle a Verdent que revise el mensaje de commit antes de crearlo. Di "Actualiza el mensaje de commit para mencionar el cambio incompatible" o "Haz que ese mensaje de commit sea más conciso". Verdent regenerará el mensaje según tus comentarios.
¿Verdent funciona con GitHub, GitLab, Bitbucket y otras plataformas de Git?
Sí. Verdent usa comandos estándar de Git, por lo que funciona con cualquier repositorio de Git independientemente de la plataforma de alojamiento. Para crear pull requests, Verdent usa la CLI de gh, que requiere GitHub, pero todas las demás operaciones de Git funcionan de forma universal.
¿Verdent subirá a los repositorios remotos sin preguntar?
No. Verdent solo sube a los repositorios remotos cuando lo solicitas explícitamente. Todas las operaciones de Git (commit, push, merge, rebase) requieren tu instrucción explícita por seguridad.
¿Puede Verdent resolver todos los tipos de conflictos de fusión?
Verdent puede resolver la mayoría de los conflictos de fusión basados en texto al entender el contexto y la intención del código. Los conflictos de archivos binarios o los conflictos muy complejos de varias vías pueden requerir intervención manual. Revisa siempre la resolución de conflictos de Verdent antes de confirmar.