Sürüm kontrolü entegrasyonu
Git ve diğer sürüm kontrol sistemleriyle çalışma
Verdent for VS Code, Git ve diğer sürüm kontrol sistemleriyle sorunsuz biçimde entegre olur; doğal dilde sürüm kontrolü işlemleri, otomatik commit mesajı oluşturma ve akıllı dal yönetimi sağlar. Bu kılavuz, verimli sürüm kontrolü iş akışları için Verdent'in Git entegrasyonundan nasıl yararlanacağınızı gösterir.
Anlamlı commit mesajları oluşturma
Diyelim ki değişiklikler yaptınız ve Verdent'in açıklayıcı bir commit mesajı oluşturmasını istiyorsunuz.
Oluşturulan mesajla commit isteme
Stage all changes and create a commit with an appropriate messageVerdent değişikliklerinizi git diff kullanarak analiz eder.
Verdent değişiklikleri analiz eder
Verdent şunları inceler:
- Değiştirilen dosyalar ve amaçları
- Değişikliklerin niteliği (yeni özellik, hata düzeltmesi, yeniden düzenleme)
- Etki kapsamı
- İlgili işlevsellik
Açıklayıcı bir commit mesajı oluşturur
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"Mesaj, conventional commit biçimini takip eder ve neyin değiştiğini açıklar.
Commit oluşturulur
Değişiklikler, oluşturulan mesajla commit edilir. Commit'i inceleyebilirsiniz:
git log -1İpuçları:
- Verdent conventional commit biçimlerini takip eder (feat, fix, refactor, docs vb.)
- Commit mesajları "nasıl" değil, "ne" ve "neden" üzerine odaklanır
- Commit mesajı biçimini User Rules veya Project Rules içinde özelleştirebilirsiniz
- Belirli commit mesajı stilleri isteyin: "Ayrıntılı, çok satırlı bir mesajla commit oluştur"
Commit mesajı biçimlerini özelleştirme
Diyelim ki Verdent'in ekibinizin belirli commit mesajı kurallarına uymasını istiyorsunuz.
Tüm projeler için commit mesajı tercihlerini VERDENT.md içinde tanımlayın:
# 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 bu kuralları genel olarak takip eder.
Projeye özgü commit kurallarını AGENTS.md içinde tanımlayın:
# 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"Kurallar yalnızca bu projeye uygulanır.
Doğrudan tek seferlik talimatlar verin:
Create a commit with message format: "[TICKET-NUMBER] description" including reference to issue #42Verdent şunu oluşturur:
git commit -m "[PROJ-42] Add search functionality
Relates to #42"İpuçları:
- User Rules tüm projelerde genel olarak geçerlidir
- Project Rules (AGENTS.md) belirli projeler için User Rules'u geçersiz kılar
- Satır içi talimatlar, tek seferlik ihtiyaçlar için her ikisini de geçersiz kılar
- Tutarlılık için Conventional Commits biçimi önerilir
Pull request oluşturma
Diyelim ki Verdent'in kapsamlı bir pull request oluşturmasını istiyorsunuz.
Değişikliklerin commit edildiğinden emin olun
Make sure all my changes are committedVerdent git durumunu kontrol eder ve commit edilmemiş tüm değişiklikleri commit eder.
Dalı uzak depoya gönderme
Push this branch to originVerdent şunu gönderir:
git push origin feature/user-notificationsPR oluşturma isteme
Create a pull request for this featureVerdent, PR oluşturmak için gh CLI kullanır.
Verdent PR açıklaması oluşturur
Verdent commit'leri ve değişiklikleri analiz ederek şunları oluşturur:
Başlık: Kullanıcı bildirim sistemi ekle
Gövde:
## 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 settingsPR, kapsamlı bir açıklamayla oluşturulur.
İpuçları:
- Verdent PR açıklaması oluşturmak için daldaki tüm commit'leri analiz eder
- Belirli PR biçimleri isteyin: "Ayrıntılı bir test planı içeren bir PR oluştur"
- Ekran görüntüleri ekleyin: "Bu ekran görüntüsünü PR açıklamasına ekle"
- Oluşturmadan önce PR açıklamasını iyileştirebilirsiniz: "PR'ı, kırıcı değişiklikten bahsedecek şekilde güncelle"
Birleştirme çakışmalarını çözme
Diyelim ki birleştirme çakışmalarıyla karşılaştınız ve bunları çözmek için Verdent'in yardımına ihtiyacınız var.
Birleştirmeyi deneyin
Merge main into this feature branchBirleştirme çakışması oluşur:
Auto-merging src/auth.ts
CONFLICT (content): Merge conflict in src/auth.tsÇakışma çözümü isteme
Help me resolve the merge conflict in src/auth.tsVerdent çakışma işaretlerini okur.
Verdent her iki sürümü de analiz eder
Verdent şunları inceler:
- Geçerli dal değişiklikleri (HEAD)
- Gelen değişiklikler (main dalı)
- Çakışmaların çevresindeki bağlam
- Her iki değişikliğin amacı
Verdent çözüm önerir
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 her iki değişikliği akıllıca birleştirerek çakışmayı çözer.
Çakışmayı çözüldü olarak işaretleyin
git add src/auth.ts
git commit -m "Merge main into feature/jwt-auth, resolved conflicts"Çakışma çözülür ve birleştirme tamamlanır.
İpuçları:
- Verdent çakışmaları akıllıca çözmek için kod bağlamını anlar
- Commit etmeden önce çakışma çözümlerini her zaman inceleyin
- Karmaşık çakışmalar için önce Verdent'den her iki sürümü açıklamasını isteyin
- Çakışmaları çözdükten sonra kapsamlı şekilde test edin
Verdent her iki dalın amacını anlayarak birleştirme çakışmalarını analiz eder ve her iki taraftaki işlevselliği koruyan çözümler önerir.
Dalları ve etiketleri yönetme
Diyelim ki dalları yönetmeniz ve sürüm etiketleri oluşturmanız gerekiyor.
Dal oluşturma ve değiştirme:
Create a new branch called feature/user-notificationsVerdent şunu çalıştırır:
git checkout -b feature/user-notificationsgit checkout maingit checkout -b feature/payment-integration
git push -u origin feature/payment-integrationÖzellik dallarını birleştirme:
Merge the feature/user-notifications branch into mainVerdent birleştirme iş akışını gerçekleştirir:
git checkout main
git pull origin main
git merge feature/user-notifications
git push origin mainVerdent birleştirmeden önce main'in güncel olduğundan emin olur.
Açıklamalı etiketler oluşturma:
Create an annotated tag for version 1.2.0 with release notesVerdent ayrıntılı etiket oluşturur:
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"Etiketleri gönderme:
Push all tags to originVerdent şunu gönderir:
git push origin --tagsİpuçları:
- Açıklayıcı dal adları kullanın:
feature/user-auth,fix/cart-bug,refactor/api-layer - Birleştirmeden önce her zaman en son değişiklikleri çekin
- Sürümler için açıklamalı etiketler kullanın (meta veri içerirler)
- Anlamsal sürümlemeyi takip edin: v1.2.3 (major.minor.patch)
Tutarlı dal adlandırma kuralları, Verdent'in iş akışınızı anlamasına yardımcı olur. Otomatik uyum için kalıpları AGENTS.md içinde tanımlayın.
Sık sorulan sorular
Verdent değişikliklerimi otomatik olarak commit eder mi?
Hayır. Verdent yalnızca açıkça istediğinizde commit oluşturur. Değişikliklerin ne zaman commit edileceği konusunda tam kontrol sizdedir. Hazır olduğunuzda yalnızca "Tüm değişiklikleri stage'le ve bir commit oluştur" diye sorun.
Commit etmeden önce commit mesajını düzenleyebilir miyim?
Evet. Commit oluşturulmadan önce Verdent'den commit mesajını gözden geçirmesini isteyebilirsiniz. "Commit mesajını kırıcı değişiklikten bahsedecek şekilde güncelle" veya "O commit mesajını daha öz hale getir" diyebilirsiniz. Verdent geri bildiriminize göre mesajı yeniden oluşturur.
Verdent, GitHub, GitLab, Bitbucket ve diğer Git platformlarıyla çalışır mı?
Evet. Verdent standart Git komutlarını kullanır, bu nedenle barındırma platformundan bağımsız olarak herhangi bir Git deposuyla çalışır. Pull request oluşturmak için Verdent, GitHub gerektiren gh CLI kullanır, ancak diğer tüm Git işlemleri evrensel olarak çalışır.
Verdent sormadan uzak depolara push yapar mı?
Hayır. Verdent yalnızca açıkça istediğinizde uzak depolara push yapar. Tüm Git işlemleri (commit, push, merge, rebase) güvenlik için açık talimatınızı gerektirir.
Verdent her tür birleştirme çakışmasını çözebilir mi?
Verdent kod bağlamını ve amacını anlayarak metin tabanlı çoğu birleştirme çakışmasını çözebilir. İkili dosya çakışmaları veya çok karmaşık çok yönlü çakışmalar manuel müdahale gerektirebilir. Commit etmeden önce Verdent'in çakışma çözümünü her zaman inceleyin.