Builder ajanı
Builder ajanı bir görevin gerektirdiği kod değişikliklerini dosya dosya, tam olarak tarif eder. Kod geçişi gerçek diff'i yazmadan önce altı yerleşik iş akışında çalışır.
Builder ajanı uygular. Bir plan verildiğinde, yapılacak kod değişikliklerini tam olarak tarif eder: dosya başına, temel kod veya sözde kodla ve gerekçesiyle. Takip gerektiren her şeyi de not eder.
Nerede çalışır
| İş akışı | Adım |
|---|---|
| Plan, Build, Review & Test | Build |
| Security-Sensitive Change | Implement |
| UI Implementation | Implement |
| Incident Response | Mitigation |
| Performance Tuning | Apply |
| Quality-Gated Change | Build |
Girdiler
- Oturumun görevi.
- Projenin reposundaki ilgili dosyaların salt okunur bir anlık görüntüsü; proje sıfırdan başlıyorsa hiçbir şey.
- Önceki adımlar. Çoğu iş akışında bu, Architect'ten veya UI Designer'dan gelen bir plandır. Security-Sensitive Change'de buna Security Auditor'ın risk analizi de dahildir. Quality-Gated Change'de Builder ilk sırada çalışır ve yalnızca görevden yola çıkar.
Çıktılar
Builder'ın adımı metin döndürür: dosya başına değişiklikler ve bunların ardındaki gerekçe. Bu, sonra olacaklar için girdilerden biridir.
Çalıştığı her iş akışında Builder'ın adımı, kod yazılmadan önceki son adımdır. Hemen ardından oturum bir kod geçişi çalıştırır. Bu geçiş görevi, kodu ve ekibin o ana kadarki işini (Builder'ın açıklaması dahil) okur ve değiştirdiği her dosyanın yeni içeriğinin tamamını döndürür. Platform bu dosyaları geçici bir klona yazar ve gerçek bir git diff'i alır. İncelediğiniz, projenin testlerinin üzerinde çalıştığı ve onaydan sonra pull request olarak repoya giren şey bu diff'tir.
Builder'ınkinden sonra gelen Review ve Test gibi adımlar, kod yazılıp testler çalıştıktan sonra çalışır. Onlara yalnızca Builder'ın açıklaması değil, bu diff ve kaydedilen test sonucu gösterilir.
Örnek çalıştırma
Gösterim amaçlı bir örnektir, kaydedilmiş bir oturum değildir. Incident Response iş akışında Incident Responder, ödeme sayfasındaki ani 500 hatası artışını triyajdan geçirmiştir ve Architect bunu, bir ödeme sağlayıcısından gelen boş (null) bir para birimi koduna kadar izlemiştir. Builder'ın Mitigation adımı; ödeme adaptöründe siparişin para birimine geri dönen bir koruma, bu geri dönüş devreye girdiğinde yazılan bir günlük satırı ve sağlayıcı eşlemesini doğru şekilde düzeltmek için bir takip notu önerir. Kod geçişi bunu iki dosyalık bir diff'e dönüştürür ve projenin testleri onun üzerinde çalışır. Ardından Tester'ın Verify adımı diff'i ve test sonucunu okur.
Sınırlar
- Komut çalıştırmaz, kod derlemez ve test yürütmez. Testler daha sonra, bir sandbox içinde, diff üzerinde çalışır.
- Tarif ettiği ile kod geçişinin yazdığı farklı olabilir. Açıklamayı değil, diff'i inceleyin.
- Kod geçişi, kendisinden önceki adımların yazdıklarının sabit bir miktarını okur. Bu adımlar uzun olduğunda, sonuncuları gördüğü kısımdan kesilebilir.
- İncelenemeyecek kadar büyük bir değişiklik, oturumu bu gerekçeyle sonlandırır. Asla sessizce kısaltılmaz.
- Çalışma alanınızın harcama limiti oturumun tamamı için geçerlidir. Ajan başına ayrı bir limit yoktur. Bkz. maliyet kontrolleri.
Sık sorulan sorular
Builder ajanı repomu doğrudan düzenler mi?
Hayır. Değişikliği tarif eder. Ayrı bir kod geçişi, tam dosyaları reponun geçici bir kopyasına yazar ve bir diff üretir; bu diff ancak yayın kapısından ve onaydan sonra repoya girer.
Builder hangi modeli kullanır?
Oturumun modelini. Auto kademesinde adımı önce Economy kademesine, dosyaları yazan kod geçişi ise önce Standard kademesine gider.