Versionskontrolle-Integration
Arbeiten mit Git und anderen Versionskontrollsystemen
Verdent for VS Code lässt sich nahtlos mit Git und anderen Versionskontrollsystemen integrieren und ermöglicht Versionskontrolloperationen in natürlicher Sprache, automatisierte Commit-Nachrichten-Generierung und intelligentes Branch-Management. Dieser Leitfaden zeigt Ihnen, wie Sie die Git-Integration von Verdent für effiziente Versionskontroll-Workflows nutzen können.
Aussagekräftige Commit-Nachrichten erstellen
Angenommen, Sie haben Änderungen vorgenommen und möchten, dass Verdent eine beschreibende Commit-Nachricht generiert.
Commit mit generierter Nachricht anfordern
Stage all changes and create a commit with an appropriate messageVerdent analysiert Ihre Änderungen mithilfe von git diff.
Verdent analysiert die Änderungen
Verdent untersucht:
- Geänderte Dateien und ihren Zweck
- Art der Änderungen (neue Funktion, Fehlerbehebung, Refactoring)
- Umfang der Auswirkungen
- Zugehörige Funktionalität
Generiert eine beschreibende Commit-Nachricht
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"Die Nachricht folgt dem Conventional-Commit-Format und beschreibt, was geändert wurde.
Der Commit wird erstellt
Die Änderungen werden mit der generierten Nachricht committet. Sie können den Commit überprüfen:
git log -1Tipps:
- Verdent folgt den Conventional-Commit-Formaten (feat, fix, refactor, docs usw.)
- Commit-Nachrichten konzentrieren sich auf das „Was“ und „Warum“, nicht auf das „Wie“
- Sie können das Format der Commit-Nachrichten in Benutzerregeln oder Projektregeln anpassen
- Fordern Sie bestimmte Commit-Nachrichtenstile an: „Erstelle einen Commit mit einer detaillierten mehrzeiligen Nachricht“
Anpassen der Formate für Commit-Nachrichten
Angenommen, Sie möchten, dass Verdent den spezifischen Commit-Nachrichten-Konventionen Ihres Teams folgt.
Definieren Sie Ihre Präferenzen für Commit-Nachrichten in VERDENT.md für alle Projekte:
# 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 befolgt diese Regeln global.
Definieren Sie projektspezifische Commit-Konventionen in 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"Die Regeln gelten nur für dieses Projekt.
Geben Sie einmalige Anweisungen direkt an:
Create a commit with message format: "[TICKET-NUMBER] description" including reference to issue #42Verdent generiert:
git commit -m "[PROJ-42] Add search functionality
Relates to #42"Tipps:
- Benutzerregeln gelten global für alle Projekte
- Projektregeln (AGENTS.md) überschreiben Benutzerregeln für bestimmte Projekte
- Inline-Anweisungen überschreiben beide für einmalige Anforderungen
- Das Conventional-Commits-Format wird für Konsistenz empfohlen
Pull Requests erstellen
Angenommen, Sie möchten, dass Verdent einen umfassenden Pull Request erstellt.
Sicherstellen, dass die Änderungen committet sind
Make sure all my changes are committedVerdent prüft den Git-Status und committet alle nicht committeten Änderungen.
Branch zum Remote-Repository pushen
Push this branch to originVerdent pusht:
git push origin feature/user-notificationsErstellung des PR anfordern
Create a pull request for this featureVerdent verwendet die gh-CLI, um den PR zu erstellen.
Verdent generiert die PR-Beschreibung
Verdent analysiert Commits und Änderungen, um Folgendes zu generieren:
Titel: Benachrichtigungssystem für Benutzer hinzufügen
Text:
## 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 settingsDer PR wird mit einer umfassenden Beschreibung erstellt.
Tipps:
- Verdent analysiert alle Commits im Branch, um die PR-Beschreibung zu generieren
- Fordern Sie bestimmte PR-Formate an: „Erstelle einen PR mit detailliertem Testplan“
- Fügen Sie Screenshots hinzu: „Füge diesen Screenshot der PR-Beschreibung hinzu“
- Sie können die PR-Beschreibung vor der Erstellung verfeinern: „Aktualisiere den PR, um die Breaking Change zu erwähnen“
Merge-Konflikte lösen
Angenommen, Sie stoßen auf Merge-Konflikte und benötigen die Hilfe von Verdent, um sie zu lösen.
Merge versuchen
Merge main into this feature branchEs tritt ein Merge-Konflikt auf:
Auto-merging src/auth.ts
CONFLICT (content): Merge conflict in src/auth.tsKonfliktlösung anfordern
Help me resolve the merge conflict in src/auth.tsVerdent liest die Konfliktmarkierungen.
Verdent analysiert beide Versionen
Verdent untersucht:
- Änderungen im aktuellen Branch (HEAD)
- Eingehende Änderungen (main-Branch)
- Kontext rund um die Konflikte
- Absicht beider Änderungen
Verdent schlägt eine Lösung vor
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 löst den Konflikt, indem beide Änderungen intelligent zusammengeführt werden.
Konflikt als gelöst markieren
git add src/auth.ts
git commit -m "Merge main into feature/jwt-auth, resolved conflicts"Der Konflikt ist gelöst und der Merge ist abgeschlossen.
Tipps:
- Verdent versteht den Codekontext, um Konflikte intelligent zu lösen
- Überprüfen Sie Konfliktlösungen stets, bevor Sie committen
- Bitten Sie Verdent bei komplexen Konflikten, zunächst beide Versionen zu erläutern
- Testen Sie nach der Konfliktlösung gründlich
Verdent analysiert Merge-Konflikte, indem die Absicht beider Branches verstanden wird, und schlägt Lösungen vor, die die Funktionalität beider Seiten erhalten.
Branches und Tags verwalten
Angenommen, Sie müssen Branches verwalten und Release-Tags erstellen.
Branches erstellen und wechseln:
Create a new branch called feature/user-notificationsVerdent führt aus:
git checkout -b feature/user-notificationsgit checkout maingit checkout -b feature/payment-integration
git push -u origin feature/payment-integrationFeature-Branches zusammenführen:
Merge the feature/user-notifications branch into mainVerdent führt den Merge-Workflow aus:
git checkout main
git pull origin main
git merge feature/user-notifications
git push origin mainVerdent stellt sicher, dass main vor dem Zusammenführen aktuell ist.
Tipps:
- Verwenden Sie aussagekräftige Branch-Namen:
feature/user-auth,fix/cart-bug,refactor/api-layer - Ziehen Sie stets die neuesten Änderungen, bevor Sie zusammenführen
- Verwenden Sie annotierte Tags für Releases (sie enthalten Metadaten)
- Folgen Sie der semantischen Versionierung: v1.2.3 (Major.Minor.Patch)
Konsistente Branch-Namenskonventionen helfen Verdent, Ihren Workflow zu verstehen. Definieren Sie Muster in AGENTS.md für automatische Einhaltung.
Häufig gestellte Fragen
Committet Verdent meine Änderungen automatisch?
Nein. Verdent erstellt Commits nur, wenn Sie diese ausdrücklich anfordern. Sie behalten die volle Kontrolle darüber, wann Änderungen committet werden. Fragen Sie einfach „Stage alle Änderungen und erstelle einen Commit“, wenn Sie bereit sind.
Kann ich die Commit-Nachricht vor dem Committen bearbeiten?
Ja. Sie können Verdent bitten, die Commit-Nachricht vor der Erstellung zu überarbeiten. Sagen Sie „Aktualisiere die Commit-Nachricht, um die Breaking Change zu erwähnen“ oder „Mache diese Commit-Nachricht prägnanter.“ Verdent generiert die Nachricht basierend auf Ihrem Feedback neu.
Funktioniert Verdent mit GitHub, GitLab, Bitbucket und anderen Git-Plattformen?
Ja. Verdent verwendet Standard-Git-Befehle, sodass es mit jedem Git-Repository unabhängig von der Hosting-Plattform funktioniert. Für die Erstellung von Pull Requests verwendet Verdent die gh-CLI, die GitHub erfordert, aber alle anderen Git-Operationen funktionieren universell.
Pusht Verdent ohne Rückfrage zu Remote-Repositories?
Nein. Verdent pusht nur zu Remote-Repositories, wenn Sie dies ausdrücklich anfordern. Alle Git-Operationen (Commit, Push, Merge, Rebase) erfordern aus Sicherheitsgründen Ihre ausdrückliche Anweisung.
Kann Verdent alle Arten von Merge-Konflikten lösen?
Verdent kann die meisten textbasierten Merge-Konflikte lösen, indem der Codekontext und die Absicht verstanden werden. Binärdatei-Konflikte oder sehr komplexe Mehrwege-Konflikte erfordern möglicherweise manuelles Eingreifen. Überprüfen Sie stets die Konfliktlösung von Verdent, bevor Sie committen.