Verdent Docs
Yaygın iş akışları

Çok adımlı görev örnekleri

Verdent ile karmaşık çok adımlı görevleri yönetme

Verdent for VS Code karmaşık çok adımlı görevleri otonom olarak parçalara ayırmada başarılıdır. Bu kılavuz, yaygın çok adımlı senaryolar için adım adım iş akışları sunar ve Verdent'in görev ayrıştırma, bağımlılık yönetimi ve aşamalı yürütmeyi tam olarak nasıl ele aldığını gösterir.


Karmaşık uygulamalar için Plan Mode'u kullanma

Diyelim ki Verdent kod tabanınızda herhangi bir değişiklik yapmadan önce ayrıntılı bir planı incelemek istiyorsunuz.

Plan Mode'a geçin

Arayüzdeki "Switch Mode" düğmesine tıklayın ve "Plan Mode" seçeneğini seçin.

Plan Mode salt okunurdur: Verdent dosyaları değiştirmeden veya komut çalıştırmadan kodu analiz edebilir, araştırma yapabilir ve planlar oluşturabilir.

Karmaşık isteğinizi gönderin

Refactor this codebase to replace our custom authentication with OAuth 2.0

Verdent mevcut uygulamanızı kapsamlı bir şekilde analiz eder.

Netleştirici soruları yanıtlayın

Verdent belirsizliği ortadan kaldırmak için sorular sorabilir:

  • Hangi OAuth sağlayıcısını kullanmalıyız?
  • Token'lar localStorage'da mı yoksa cookie'lerde mi saklanmalı?
  • Birden fazla OAuth sağlayıcısını desteklememiz gerekiyor mu?

Planı netleştirmek için bu soruları yanıtlayın.

Ayrıntılı planı inceleyin

Verdent şunları gösteren kapsamlı bir plan sunar:

  • Oluşturulacak dosyalar
  • Değiştirilecek mevcut dosyalar
  • Mantıksal sıradaki uygulama adımları
  • Adımlar arasındaki bağımlılıklar

Devam etmeden önce bu planı dikkatlice inceleyin.

Sonraki eyleminizi seçin

Planı inceledikten sonra Verdent iki seçenek sunar:

  • Değişiklik istemek veya netleştirici sorular sormak için Edit'i seçin
  • Agent Mode'a geçmek ve yürütmeye başlamak için Start Building'i seçin

Yürütmeden önce plan üzerinde istediğiniz kadar yineleme yapabilirsiniz.

İpuçları:

  • Birden fazla dosyayı etkileyen özellikler için Plan Mode'u kullanın
  • Yaklaşımı netleştirmek için birden fazla tur plan incelemesi yapın
  • Yürütmeden önce ekip tartışması için planı bir dosyaya kaydedin
  • Plan Mode, beklentileriniz ile Verdent'in önerdiği çözüm arasındaki uyumu sağlamaya yardımcı olur
  • Plan biçimini özelleştirin: Plan yapısını, ayrıntı düzeyini ve biçimlendirme tercihlerini kontrol etmek için Settings → Rules → Plan Rules'a erişin

Büyük özellik isteklerini parçalara ayırma

Diyelim ki birden fazla entegre bileşene sahip karmaşık bir e-ticaret ödeme sistemi oluşturuyorsunuz.

Üst düzey hedefi belirtin

Build a complete checkout system with cart management, payment processing, order confirmation, and inventory updates

Verdent yapılması gerekenleri analiz eder.

Verdent mantıksal alt görevler oluşturur

Sistem bunu otonom olarak şunlara ayırır:

  1. Alışveriş sepeti veri modeli ve API oluştur
  2. Öğe ekleme/çıkarma/güncelleme özellikleriyle sepet arayüzü oluştur
  3. Teslimat adresi formuyla ödeme sayfasını uygula
  4. Ödeme ağ geçidini entegre et (Stripe veya yapılandırılmış sağlayıcı)
  5. Sipariş onay sayfası oluştur
  6. Stok güncelleme mantığı ekle
  7. E-posta onay sistemini uygula
  8. Entegrasyon testleri yaz

Her alt görev, açık açıklamalarla yapılacaklar listesinde gösterilir.

Verdent bağımlılıkları otomatik olarak yönetir

Verdent alt görevleri doğru sırayla yürütür:

  • Onları kullanan API uç noktalarından önce veri modellerini oluşturur
  • Onları çağıran frontend bileşenlerinden önce backend uç noktalarını oluşturur
  • Test eklemeden önce temel özellikleri uygular

Bağımlılıklar manuel müdahale olmadan otomatik olarak yönetilir.

Gerçek zamanlı ilerlemeyi izleyin

Verdent her alt görev üzerinde çalışırken yapılacaklar listesinin gerçek zamanlı güncellenmesini izleyin. Yapılacak öğeler beklemede → devam ediyor → tamamlandı şeklinde ilerler.

İpuçları:

  • Çoğu görev için ayrıştırmayı Verdent'in otonom olarak yapmasına izin verin
  • Yürütmeden önce ayrıştırmayı incelemek istiyorsanız Plan Mode'u kullanın
  • Verdent, uç durumlarla veya yeni gereksinimlerle karşılaştığında yaklaşımını ayarlar
  • Görünür yapılacaklar listesi, çok adımlı yürütmede şeffaflık sağlar

Çok aşamalı yeniden düzenleme projeleri

Diyelim ki büyük bir kod tabanını yeniden düzenliyorsunuz ve buna yönetilebilir aşamalarla yaklaşmak istiyorsunuz.

Çok aşamalı yaklaşımı tanımlayın

In Plan Mode: Refactor this codebase to replace our custom authentication with OAuth 2.0. I want this done in phases so we can test incrementally.

Verdent aşama ayrımı önerir

Verdent çok aşamalı bir plan önerir:

  • Aşama 1: OAuth kütüphanesini ekle ve uç noktaları yapılandır
  • Aşama 2: Kullanıcı modelini ve veritabanı şemasını güncelle
  • Aşama 3: Mevcut kimlik doğrulama mantığını taşı
  • Aşama 4: Kullanımdan kaldırılmış kimlik doğrulama kodunu kaldır
  • Aşama 5: Testleri ve dokümantasyonu güncelle

Her aşama bağımsız olarak test edilebilir.

Aşama aşama yürütün

Aşama 1'i onaylayın, Verdent'in onu yürütmesine izin verin ve sonra test edin:

npm test

Aşama 1'in çalıştığı doğrulandıktan sonra Aşama 2'ye geçin.

Gerekirse sonraki aşamaları ayarlayın

Aşama 1'de öğrendiklerinize göre, kalan aşamalar için yaklaşımı ayarlayabilirsiniz:

For Phase 2, let's also add user role migration to the database schema changes

Tüm aşamaları aşamalı olarak tamamlayın

Her aşama arasında test ve doğrulama yaparak tüm aşamalardan geçin, böylece güvenlik sağlanır ve rota düzeltmesine olanak tanınır.

İpuçları:

  • Çok aşamalı yeniden düzenleme, aşamalı testi mümkün kılarak riski azaltır
  • Her aşama, kod tabanını çalışır durumda bırakmalıdır
  • Gerekirse kolay geri alma için her aşamadan sonra commit yapın
  • Sonraki aşamaları, önceki aşamalardan öğrendiklerinize göre ayarlayın

Backend ve frontend değişikliklerini koordine etme

Diyelim ki hem backend API'larında hem de frontend bileşenlerinde senkronize güncellemeler gerektiren bir özellik ekliyorsunuz.

Full-stack özelliği tanımlayın

Add a commenting system where users can add comments to blog posts. Include backend API, database schema, and frontend UI

Verdent backend öncelikli yaklaşımı koordine eder

Verdent full-stack özellikler için genellikle backend öncelikli çalışır:

  1. Yorumlar tablosu için veritabanı taşıması oluştur
  2. Yorum oluşturmak için API uç noktası ekle
  3. Yorumları almak için API uç noktası ekle
  4. Yorum verisi için TypeScript arayüzleri tanımla
  5. Frontend yorum formu bileşeni oluştur
  6. Yorum görüntüleme bileşeni oluştur
  7. Frontend'i API uç noktalarına bağla

Verdent tutarlılığı sağlar

Verdent şunları sağlar:

  • Frontend TypeScript arayüzleri, backend veri yapılarıyla eşleşir
  • API uç noktası URL'leri, frontend kodunda doğru şekilde referanslanır
  • İstek/yanıt biçimleri, backend ve frontend arasında uyumludur
  • Hata yönetimi, tüm yığında tutarlıdır

Entegrasyon testi

Write integration tests for the commenting system covering the full stack

Verdent, backend ve frontend'in birlikte doğru çalıştığını doğrulayan testler oluşturur.

İpuçları:

  • Backend öncelikli yaklaşım, frontend'in entegre olacağı çalışan API'lara sahip olmasını sağlar
  • Verdent, backend ve frontend kodu arasındaki tutarlılığı otomatik olarak korur
  • TypeScript arayüzleri, entegrasyon sorunlarını derleme zamanında yakalamaya yardımcı olur
  • Entegrasyon testleri, tüm özelliğin uçtan uca çalıştığını doğrular

Paralel yürütme için alt aracıları kullanma

Diyelim ki eş zamanlı olarak yapılabilecek birden fazla bağımsız göreviniz var.

Paralelleştirilebilir görevleri belirleyin

Generate unit tests for all service classes in the src/services directory

Bu test dosyaları bağımsızdır ve paralel olarak oluşturulabilir.

Verdent birden fazla alt aracıya devreder

Verdent, bağımsız görevler üzerinde eş zamanlı çalışmak için otomatik olarak birden fazla alt aracı kullanır:

  • Alt aracı 1: UserService için testler oluşturur
  • Alt aracı 2: PaymentService için testler oluşturur
  • Alt aracı 3: NotificationService için testler oluşturur
  • Alt aracı 4: AuthService için testler oluşturur

Tüm çalışma paralel olarak gerçekleşir ve zaman tasarrufu sağlar.

Sonuçlar entegre edilir

Her alt aracı kendi sonuçlarını döndürür. Verdent, tüm test dosyalarını uygun adlandırma ve yapıyla projeye entegre eder.

Sıralı doğrulama

Paralel oluşturmadan sonra, hepsinin çalıştığını doğrulamak için testleri sıralı olarak çalıştırın:

npm test

İpuçları:

  • Verdent, bağımsız görevleri alt aracıları kullanarak otomatik olarak paralelleştirir
  • Gevşek bağlı çalışma (ayrı test dosyaları, bağımsız bileşenler) paralelleştirmeden fayda sağlar
  • Sıkı bağlı çalışma (bağımlılıkları olan dosyalar), doğruluk için sıralı olarak yapılır
  • Paralel yürütme, büyük ölçekli değişiklikleri önemli ölçüde hızlandırır

Sık sorulan sorular

Çok adımlı bir görevin ortasında Verdent'i durdurabilir miyim?

Evet. Yürütmeyi istediğiniz zaman kesebilirsiniz. Verdent, üzerinde çalıştığı mevcut adımı tamamlar ve sonra durur. O noktaya kadar olan ilerleme korunur. Yapılanları inceleyebilir, ayarlamalar yapabilir ve devam edebilir veya farklı bir yaklaşım benimseyebilirsiniz.

Uzun bir görevde Verdent'in şu anda ne yaptığını nasıl bilirim?

Yapılacaklar listesini izleyin. Herhangi bir anda "devam ediyor" olarak işaretlenmiş bir öğeyle gerçek zamanlı durumu gösterir. Etkin öğe, Verdent'in şu anda tam olarak ne üzerinde çalıştığını gösterir. Tamamlanan öğeler tamamlandı olarak işaretlenir ve bekleyen öğeler kalan işleri gösterir.

Verdent'in görevimi nasıl parçaladığına katılmazsam ne olur?

Yürütmeden önce ayrıştırmayı incelemek ve ayarlamak için Plan Mode'u kullanın. Plan Mode'da "Frontend çalışmasını ayrı bileşenlere ayır" veya "Bu iki adımı birleştir" gibi geri bildirimler verebilirsiniz. Verdent, herhangi bir kod yazılmadan önce planı girdinize göre revize eder.

Her çok adımlı görev için Plan Mode'u kullanmalı mıyım?

Mutlaka değil. Birçok dosyayı etkileyen karmaşık özellikler, büyük yeniden düzenlemeler için veya yaklaşımı önce incelemek istediğinizde Plan Mode'u kullanın. Tanıdık, basit görevler için Verdent gerçek zamanlı yapılacaklar listesi görünürlüğüyle doğrudan yürütebilir. Plan Mode, daha yüksek riskli değişiklikler için bir inceleme adımı ekler.

Yürütme başladıktan sonra Verdent'in planını değiştirebilir miyim?

Verdent çalışırken düzeltici yönlendirme sağlayabilirsiniz. "Aslında, API entegrasyonu için farklı bir yaklaşım kullan" deyin, Verdent kalan adımları ayarlar. Büyük plan değişiklikleri için durmak, yapılanları commit etmek ve revize edilmiş yaklaşımla yeni bir oturum başlatmak daha iyidir.


Ayrıca bakınız