Güvenilir Bir AI ile Kodlama İş Akışı Nasıl Kurulur

AI kodlama iş akışı nedir?

AI kodlama iş akışı, mühendislik değerlendirmesinden vazgeçmeden bir yazılım görevi boyunca AI'yı kullanmanın tekrarlanabilir bir yoludur. Geliştirici başarının ne anlama geldiğini tanımlar ve her önemli değişikliği inceler. Kodlama agent'ı önce projeyi araştırır ve bir yaklaşım önerir. Onaydan sonra ilgili dosyaları düzenleyebilir ve projenin kontrollerini çalıştırabilir.

Yapılandırılmamış AI kodlama neden daha fazla iş yaratır

Yapılandırılmamış AI kodlama, kod hemen ortaya çıktığı için hızlı hissettirir. Gizli maliyet, geliştiricilerin varsayımları çözmesi veya orijinal isteğin ötesine yayılan değişiklikleri onarması gerektiğinde daha sonra ortaya çıkar.

Planlama ve uygulama aynı anda gerçekleşir

Bir istek belirsiz olduğunda agent, kodu yazarken aynı zamanda özelliğin ne yapması gerektiğine karar vermek zorunda kalır. Bu kararlar geliştiricinin amaçladığıyla örtüşmeyebilir. Örneğin, "karanlık mod geçiş anahtarı ekle" dediğinizde agent, geçiş anahtarının nereye ait olduğunu veya kullanıcı uygulamayı kapattıktan sonra seçimin hatırlanıp hatırlanmaması gerektiğini bilemez.

Büyük prompt'lar incelemesi zor değişiklikler üretir

Geniş kapsamlı bir istek, agent'ı projenin birbirine bağlı birçok parçasını tek seferde değiştirmeye yönlendirir. Ortaya çıkan yama (patch), her dosya tek başına makul görünse bile bir geliştiricinin güvenle anlayamayacağı kadar büyük olabilir. Örneğin, "bir ayarlar sayfası oluştur" isteği hem arayüzü hem de tercihlerin saklanma biçimini etkileyebilir.

Eksik bağlam genel geçer kod üretir

Bir kodlama agent'ı görmediği proje kurallarına uyamaz. İlgili dosyalar veya depo talimatları olmadan, zaten var olan bir yerde yeni bir soyutlama getirebilir. Ayrıca yüklü bağımlılık sürümüyle uyuşmayan bir API kullanabilir.

Hızlı üretim, yeniden çalışmanın maliyetini gizler

Üretim süresi, teslim süresi değildir. Bir dakikada teslim edilen bir yama, yine de bir öğleden sonra süren hata ayıklama gerektirebilir. Daha iyi ölçü, net bir gereksinimden ekibin sürdürmeye istekli olduğu doğrulanmış bir değişikliğe kadar geçen süredir.

AI kodlama iş akışına genel bakış

Aşağıdaki iş akışı, tekrarlanabilir araştırma ve uygulama işini agent'a bırakırken kararlar üzerindeki kontrolü geliştiricide tutar.

Kimi Code, depo dosyalarını inceleyerek, onaylanan düzenlemeleri yaparak ve projenin doğrulama komutlarını çalıştırarak bu döngüyü destekleyebilir.

Adım 1: Kod istemeden önce sonucu tanımlayın

Bir uygulama şekli belirlemeden önce istenen davranışı tanımlayın. Etkilenen kullanıcıyı veya sistemi belirleyin, görev sınırını tanımlayın ve değişiklikten sonra kontrol edilebilecek kabul kriterleri ekleyin.

Basit bir örnek düşünün. Mevcut bir web uygulamasına karanlık mod eklemek istediğinizi varsayalım. Kodlama agent'ına şu isteği verebilirsiniz:

Agent bu isteğe göre hareket edebilir, ancak eksik gereksinimleri kendisi doldurmak zorunda kalır. Geçiş anahtarını arayüzün yanlış bir bölümüne yerleştirebilir veya karanlık modu yalnızca bir sayfaya uygulayabilir. Üretilen kod teknik olarak çalışabilirken yine de yanlış bir kullanıcı deneyimi sunabilir.

Daha kullanışlı bir prompt, agent düzenlemeye başlamadan önce sonucu tanımlar:

Bu sürüm, agent'a tanımlanmış bir hedef verir ve ürünle ilgili kararları sessizce almasını önler. Ayrıca geliştiriciye bitmiş işi incelemek için somut bir yol sunar. Özelliğin "bitmiş görünüp görünmediğini" sormak yerine, davranışını belirtilen gereksinimlerle karşılaştırarak kontrol edebilirsiniz.

Adım 2: Doğru kodlama altyapısını (harness) ve modeli seçin

Model, AI'nın kodu ne kadar iyi anladığını ve akıl yürüttüğünü belirler. Kodlama altyapısı, bu akıl yürütmenin projenizde doğrulanmış bir değişikliğe dönüşüp dönüşemeyeceğini belirler. İkisini de erken seçmek, görevin üstesinden gelemeyecek araçlar etrafında bir iş akışı kurmanızı engeller.

Döngüyü tamamlayabilecek bir altyapı seçin

İyi bir kodlama harness'i, yalnızca kod parçacıkları üretmekten fazlasını yapmalıdır. Depoya erişimi, dosyaları düzenleme izni ve projenin mevcut komutlarını çalıştırabilme yeteneği olmalıdır. Bir görev birden fazla dosyayı etkilediğinde planlama desteği ve net onay kontrolleri de önemlidir.

Modeli göreve göre seçin

Hızlı bir düzenleme için yalnızca hızlı bir kodlama modeli yeterli olabilir. Karmaşık hata ayıklama veya dosyalar arası bir yeniden düzenleme ise daha güçlü akıl yürütme ve çevredeki kodu anlamaya yetecek bağlam gerektirir. Model ayrıca harness'in sunduğu araçlarla güvenilir şekilde çalışmalıdır.

Kimi Code'u Kimi ile Kodlama'da kullanın

Kimi Code, görev düzeyinde geliştirme için eksiksiz bir harness sunar. Tanıdık olmadığınız bir depoyu keşfedebilir, düzenlemeden önce bir plan oluşturabilir, ilgili dosyaları güncelleyebilir ve gerçek proje üzerinde testler çalıştırabilir. Onu terminalden, tarayıcıdan veya uyumlu bir IDE'den kullanabilirsiniz.

Üçüncü taraf kodlama araçları için Kimi Code platformu, kararlı Kimi K3 modelini sunar. Bu model, istemci yapılandırmanızı değiştirmenize gerek kalmadan yükseltilebilir. Daha hızlı yineleme önemli olduğunda, yüksek hızlı model aynı kodlama yeteneğini daha yüksek çıktı hızıyla sunar.

Kimi Code ve Kimi modeli birlikte iş akışının iki tarafını da kapsar: model kod akıl yürütmesini üstlenirken, harness bu akıl yürütmeyi incelenebilir bir değişikliğe dönüştürür.

Adım 3: Kodlama ajanının projeyi incelemesine izin verin

Beklenen sonuç netleştiğinde, mevcut davranışı kontrol eden kodu bulması için ajana talimat verin. Herhangi bir dosya değişikliğinden önce keşif, görevi daraltmalıdır.

Depo talimatlarıyla başlayın

Ajana önce deponun kendi rehberliğini gösterin. Bu, README.md, CONTRIBUTING.md gibi dosyalarda veya bir ajan talimat dosyasında bulunabilir. Burada işe yarayan ayrıntılar; projenin gerçekten kullandığı komutlar, kod kuralları ve sınırların dışında kalan işlemlerdir.

Şuna benzer bir prompt kullanın:

Yanıt, okuduğu talimat dosyalarını adlandırmalı ve ilgili komutları alıntılamalıdır. Depoda görünmeyen bir komut önerirse, çalıştırmadan önce bu komutun nereden geldiğini sorun.

Düzenlemeden önce ilgili kodu bulun

İşe yarayan bir bağlam haritası, belirli dosyaları adlandırır ve her birinin neden önemli olduğunu açıklar. Geniş dizinlerin bir listesi yeterli değildir. Yanıt, dahil olduğunu bildiğiniz paylaşılan bir yardımcı programı atlıyorsa, planlama başlamadan önce haritayı düzeltin. Ajan, davranışı giriş noktasından bağımlı olduğu modüllere kadar izlemelidir. Ayrıca mevcut testleri ve varsa benzer bir uygulamayı da bulmalıdır.

Gerektiğinde harici bağlam ekleyin

Kod tabanı bir soruyu yanıtlayamadığında harici dokümantasyonu devreye sokun. Kesin resmi dokümantasyon URL'sini sağlayın veya ajandan resmi kaynağı bulmasını isteyin. Dokümantasyonu depoda kurulu olan sürümle eşleştirin. Hata günlükleri ve sorun açıklamaları da faydalıdır, ancak bunları bir prompt'a yerleştirmeden önce kimlik bilgilerini veya özel kullanıcı verilerini kaldırın.

Herhangi bir düzenlemeye izin vermeden önce çalışma ağacını kontrol edin ve mevcut değişiklikleri kaydedin. Sürüm kontrolüyle ilgili tam iş akışı Adım 8'de ele alınmıştır.

Adım 4: Planlamayı yürütmeden ayırın

Planlama ve kodlama farklı inceleme soruları gerektirir. Planlama sırasında önerilen yönün sisteme uygun olup olmadığına siz karar verirsiniz. Uygulama sırasında ise onaylanan yönün doğru şekilde izlenip izlenmediğini kontrol edersiniz.

Açık, kodsuz bir planlama promptu kullanın:

Onaylamadan önce planı gözden geçirin. Uygun olduğu yerlerde mevcut proje soyutlamalarının kullanıldığını doğrulayın. Gizli kapsam genişlemesine, özellikle gereksinimin parçası olmayan yeni bağımlılıklara veya genel API değişikliklerine dikkat edin. Önerilen testlerin yalnızca yeni yazılan işlevleri çalıştırmak yerine istenen davranışı gösterdiğini kontrol edin.

Bu aşamanın çıktısı onaylanmış bir plandır. Ajan ayrıntılı bir yanıt üretmiş olması, işin bittiği anlamına gelmez. Varsayımlar ve dosya kapsamı doğru olana kadar planı kendiniz düzenleyin veya revizyon isteyin.

Adım 5: Planı incelenebilir görevlere bölün

Her uygulama görevinin tek bir net hedefi ve sonucu doğrulamanın tek bir yolu olmalıdır. Bu, değişikliği inceleyecek kadar küçük tutar ve bir şeyler ters gittiğinde nedenini bulmayı kolaylaştırır.

Örneğin, Adım 1'deki karanlık mod özelliği aşağıdaki görevlere bölünebilir:

1. Mevcut renk belirteçlerini ve temayla ilgili stilleri gözden geçirin.

2. Bir tema tercihi ekleyin ve kullanıcının seçimini kaydedin.

3. Koyu temayı paylaşılan düzenlere ve bileşenlere uygulayın.

4. Tema geçiş anahtarını ayarlar menüsüne ekleyin.

5. Seçilen temanın değiştirilmesi ve kaydedilmesi için testler ekleyin.

6. Ana sayfalarda görsel veya erişilebilirlik sorunlarını kontrol edin.

Ajandan tüm özelliği tek seferde uygulamasını istemek yerine bu görevleri sırayla işleyin. Tek bir uygulama görevi için şuna benzer bir prompt kullanın:

Beklenen sonuç, gerçekten çalıştırılmış testlerle birlikte odaklanmış bir kod değişikliğidir. Bir sonraki göreve geçmeden önce ikisini de gözden geçirin. Ajan aynı zamanda ayarlar geçiş anahtarını da eklerse veya ilgisiz bileşenleri düzenlerse, önce bu değişiklikleri ayırın veya geri alın.

Ajan bir görevle sürekli zorlanıyorsa görevi küçültün. Örneğin, kalıcılığı uygulamadan önce yalnızca tema tercihini eklemesini isteyin. Daha dar bir görev, ajanın yapması gereken varsayım sayısını azaltır ve devam etmeden önce doğrulamanız için daha net bir nokta sağlar.

Adım 6: Sıkı bir döngüde uygulayın, test edin ve inceleyin

Plan yönetilebilir görevlere bölündükten sonra, bunları teker teker tamamlayın. Amacı ve kapsamı hâlâ netken her değişikliği gözden geçirin.

Her görev için şu döngüyü kullanın:

Önce diff'i gözden geçirerek başlayın. Ajanın yalnızca mevcut görev için gereken dosyaları değiştirdiğini doğrulayın. Yama, ilgisiz bir yeniden düzenleme veya sonraki bir adım için planlanmış bir iş içeriyorsa, testleri çalıştırmadan önce bu değişiklikleri kaldırın veya ayırın.

Ardından, deponun zaten tanımladığı doğrulama komutlarını kullanın. Bunları genellikle package.json dosyasında, proje dokümantasyonunda veya CI yapılandırmasında bulabilirsiniz. Örneğin npm script'leri kullanan bir JavaScript veya TypeScript projesi şu tür komutlar sağlayabilir:

Daha hızlı geri bildirim almak için önce odaklı testi çalıştırın. Başarılı olursa daha kapsamlı kontrollerle devam edin. Başarılı bir çalıştırma hatasız tamamlanmalıdır:

Bu komutlar yalnızca birer örnektir. Projenin gerçekte hangi paket yöneticisini ve script'leri kullandığını kontrol etmeden bunları bir depoya kopyalamayın. Bir Python veya Go projesinin doğrulama süreci farklı olacaktır; hatta iki JavaScript projesi bile farklı script adları kullanabilir.

Ekstra ipucu: İş akışını Kimi Code ile uygulamaya koyun

Kimi Code, yalnızca bir sonraki satır düzeyinde değil, görev düzeyinde çalışır. İstediğiniz sonucu tarif edin; ilgili kodu bulabilir, bir uygulama planı önerebilir, gerekli dosyaları güncelleyebilir ve projenin kontrollerini çalıştırabilir. Her adımı elle bir araya getirmek yerine, incelemeniz için odaklanmış bir değişiklik alırsınız.

Yabancı bir kod tabanını daha hızlı anlayın

Kimi Code bir giriş noktasından başlayarak yürütme akışını ilgili modüller boyunca izleyebilir. İlgili testleri ve mevcut proje kalıplarını belirler, böylece dosyaları elle toplamak veya deponun nasıl çalıştığını açıklamak için harcanan süre azalır.

Göreve koddan fazlasını dahil edin

Geliştirme bağlamı genellikle hata ekran görüntülerini, tasarım referanslarını, grafikleri veya kaydedilmiş davranışları içerir. Kimi Code, kaynak kodun yanı sıra çok modlu girdileri de kullanabilir; bu da uygulamanın görevi tanımlayan asıl kanıtları yansıtmasına yardımcı olur.

Değişiklikleri gerçek projede test edin

Kimi Code, düzenleme yaptıktan sonra deponun mevcut test ve kalite komutlarını çalıştırabilir. Bir kontrol başarısız olursa, gerçek hata çıktısını okuyup bu geri bildirimden hareket eder; bu da hiç çalıştırılmamış bağımsız bir kod önerisine kıyasla size daha fazla güven verir.

İyi iş akışlarını tekrarlanabilir süreçlere dönüştürün

Skills, yinelenen görevler için talimatları koruyabilirken, Hooks önemli noktalarda önceden tanımlanmış eylemleri tetikler. MCP, Kimi Code'u ekibinizin zaten kullandığı araçlara bağlar ve Plugins bu yetenekleri tekrar kullanımı ve paylaşımı kolay bir kurulumda bir araya getirebilir.

Uzun süren görevleri ilerletmeye devam edin

Kısa bir oturumda tamamlanamayacak işler için /goal, Kimi Code'a doğru bir hedef ve tamamlanma kriterleri verir. Devam eden turlar boyunca ilerlemeyi takip eder ve her seferinde tüm hedefi yeniden belirtmenize gerek kalmadan görevin ilerlemesine yardımcı olur.

Adım 7: Yapay zekanın oluşturduğu kodu bir bakım sorumlusu gibi inceleyin

Değişikliği kabul etmeden önce nihai diff'i kendiniz okuyun. Kodun istenildiği gibi çalışıp çalışmadığını ve mevcut projeye uyup uymadığını kontrol edin.

Doğruluk

Kod kabul kriterlerini karşılıyor mu? Normal kullanıcı akışını ve en az bir hata durumunu kontrol edin. Testlerin istediğiniz davranışı kapsadığından emin olun.

Mimari

Kod, projede zaten kullanılan kalıpları takip ediyor mu? Mantığı uygun modüle yerleştirmeli ve gereksiz soyutlamalardan kaçınmalıdır.

Güvenlik

Yeni girdilerin doğrulandığını ve izinlerin uygulandığını kontrol edin. Günlüklerin gizli bilgileri veya kişisel verileri açığa çıkarmadığından emin olun. Kabul etmeden önce yeni her bağımlılığı gözden geçirin.

Sürdürülebilirlik

Kod, agent'ın açıklaması olmadan anlaşılabilir olmalıdır. İsimler açık olmalı, yorumlar ise yalnızca koddan açıkça anlaşılmayan kararları açıklamalıdır.

Kapsam

Diff'in yalnızca mevcut görev için gerekli değişiklikleri içerdiğini doğrulayın. İlgisiz yeniden düzenlemeleri, beklenmedik arayüz değişikliklerini ve gereksiz biçimlendirme düzenlemelerini kaldırın.

Agent tarafından oluşturulan bir özet incelemeye yardımcı olabilir, ancak kodu okumanın yerini tutmaz. Açıklayamayacağınız kodu asla yayına almayın.

Adım 8: İş akışı boyunca sürüm kontrolü kullanın

Sürüm kontrolü, yapay zeka destekli çalışmayı incelemeyi ve geri almayı kolaylaştırır. Burada ayrı bir adım olarak yer alsa da sağladığı koruma, agent herhangi bir dosyayı düzenlemeden önce başlar. Mevcut çalışmayı görev sırasında yapılan değişikliklerden ayırabilmek için çalışma ağacını başlangıçta inceleyin.

Bu komutları depo kök dizininde açılmış bir terminalde çalıştırın:

Temiz bir başlangıç ağacı, git status --short komutundan hiçbir çıktı üretmez. Dosyalar zaten değiştirilmişse bunları kaydedin ve agent'a bunların üzerine yazmamasını söyleyin. Her görevden sonra diff'i tekrar inceleyin. Doğrulanmış durumun bir sürüm kontrolü kontrol noktasına hazır olup olmadığına geliştirici karar vermelidir.

Bir deneyin birçok dosyayı etkileyebileceği durumlarda ayrı bir branch veya worktree kullanın. Paralel çalışan agent'lar aynı çalışma dizinini düzenlememelidir. Her iş akışına net dosya sahipliği verin, ardından kontrolleri geçtikten sonra entegre edin.

Bir kodlama agent'ının geçmişi yeniden yazmasına, yerel çalışmayı silmesine, force-push yapmasına veya açık onay olmadan değişiklikleri yayınlamasına izin vermeyin. Bu eylemler sıradan dosya düzenlemelerinden daha geniş bir etki alanına sahiptir ve ayrı bir karar gerektirir.

Adım 9: Kodlama oturumları arasında bağlamı koruyun

Uzun görevler genellikle tek bir konuşmadan daha uzun sürer. Mühendislik durumunu sohbet geçmişine güvenmek yerine depo eserlerinde saklayın.

Şunları içeren kısa bir özellik belgesi tutun:

• Kabul edilen spesifikasyon

• Onaylanan uygulama planı

• Tamamlanan görevler ve mevcut yapılacaklar (TODO) maddesi

• Orijinal yaklaşımı değiştiren kararlar

• Daha önce çalıştırılan komutlar ve en son sonuçları

• Bilinen riskler veya açık sorular

Devir prompt'u ile yeni bir oturum başlatın:

Yanıt, belgelerle ve mevcut depo durumuyla eşleşmelidir. Yeni oturumdan devam etmesini istemeden önce her türlü uyuşmazlığı giderin. Bu devir işlemi, ai coding agent'ların proje durumunu eksik konuşma geçmişinden yeniden kurma ihtiyacını azaltır.

Çoklu agent'lı AI kodlama iş akışları nasıl çalışır

Çoklu agent'lı AI kodlama iş akışları, ayrı agent'lara farklı roller atar. Bir agent depoyu incelerken başka bir agent tamamlanmış bir diff'i gözden geçirebilir. Değer, aynı anda birden fazla sohbet açmaktan değil, sorumluluğun bölünmesinden gelir.

Pratik bir kurulum şu rolleri içerebilir:

• Planlayıcı: Gereksinimi kod tabanıyla eşleştirir ve dosyaları düzenlemeden sıralı bir plan önerir.

• Uygulayıcı: İzole bir çalışma alanında dar kapsamlı bir görevi tamamlar.

• Test Eden: Kabul kriterlerini kontrol eder ve hataları bağımsız olarak yeniden üretir.

• İnceleyici: Uygulamanın doğru olduğunu varsaymadan diff'i doğruluk veya gizli risk açısından inceler.

• İnsan entegratör: Kararları onaylar, birleştirme sırasını kontrol eder ve birleşik sonucu doğrular.

Çoklu agent'lı iş akışları, görevler net biçimde ayrıştırılabildiğinde en iyi sonucu verir. Her agent'a aynı onaylanmış spesifikasyonu verin, sahiplikleri açıkça belirleyin ve çakışmaları önlemek için izole branch'ler veya worktree'ler kullanın. Küçük bir düzeltme veya tek bir değişen dosyaya bağlı bir görev için genellikle tek bir agent daha verimlidir.

Kimi Code, daha büyük görevleri bağımsız context'lere sahip alt agent'lara bölebilir. Agent Swarm ile birden fazla alt agent, görevin farklı bölümleri üzerinde paralel olarak çalışabilir, ardından bulgularını inceleme ve entegrasyon için ana iş akışına geri döndürebilir. Bu, görev sınırlarını ve nihai onayı sizin kontrolünüzde tutarken yürütme süresini azaltır.

İş akışını göreve göre seçin

Her kodlama görevi aynı miktarda planlama gerektirmez. Basit bir düzeltme hızla ilerleyebilirken, karmaşık veya riskli bir değişiklik yayınlanmadan önce daha fazla inceleme gerektirir.

• Küçük değişiklik: İlgili kodu inceleyin, tek bir odaklı düzenleme yapın, ilgili testi çalıştırın ve diff'i gözden geçirin.

• Orta ölçekli özellik: Kısa bir spesifikasyon yazın, uygulama planını onaylayın ve işi birkaç küçük göreve bölerek tamamlayın. İncelemeden önce daha geniş test paketini çalıştırın.

• Yüksek riskli değişiklik: Bir tasarım incelemesi ve bir geri alma planı ekleyin. Kimlik doğrulama, ödemeler veya veri geçişini içeren değişiklikler ayrıca güvenlik incelemesi ve kademeli bir yayın gerektirebilir.

• Çoklu agent'lı proje: Her agent'a aynı spesifikasyonu ve açık görev sahipliğini verin. Çalışmalarını birleştirdikten sonra ilgili testlerin tamamını yeniden çalıştırın.

Kimi Code bu iş akışlarının her birini destekleyebilir. Basit görevler için hafif bir süreç kullanın, ardından bir değişiklik geri alınması daha zor veya kullanıcıları etkileme olasılığı daha yüksek olduğunda daha fazla planlama ve inceleme ekleyin.

Yeniden kullanılabilir AI kodlama iş akışı prompt'u

Bu şablonu herhangi bir kodlama agent'ı ile kullanın. Köşeli parantez içindeki her alanı değiştirdikten sonra agent'a gönderin.

Bunu Kimi Code'da açılış talimatı olarak kullanabilirsiniz. Tüm özelliği tek bir prompt'a sığdırmaya çalışmak yerine, çalışma ilerledikçe Current phase ve Task alanlarını güncelleyin.

Sonuç

Güvenilir bir AI kodlama iş akışının amacı, üretilen kod miktarını en üst düzeye çıkarmak değildir. Yanlış varsayımları erken ortaya çıkarır ve her değişikliği incelenebilir tutar. Kimi Code, kodu okuyup düzenleyerek, shell komutları çalıştırarak, ilgili web sayfalarını getirerek ve görev geliştikçe eylemlerini uyarlayarak bu süreci destekler. Mimariden ve nihai yayın kararından geliştirici sorumlu kalır. Küçük, doğrulanabilir bir görevle başlayın. Sürece daha fazla adım, projenin riski bunu gerektirdiğinde ekleyin.