Qwen Code Slash Komutlarıyla Achu Uygulamasını Geliştirme Yöntemleri

Günümüzde geliştiriciler, karmaşık projeleri hızlı ve verimli bir şekilde hayata geçirmek için yapay zeka destekli araçlardan faydalanıyor. Qwen Code’un sunduğu slash komutları ve akıllı alt ajan sistemleri, özellikle Electron, React ve TypeScript gibi modern teknolojilerle geliştirilen uygulamaların inşasında devrim yaratmaya başladı. Peki, bu araçları kullanarak nasıl daha organize, ölçeklenebilir ve maliyet etkin bir geliştirme süreci oluşturabilirsiniz?

Achu uygulamasının arkasındaki geliştirici, Qwen Code’un sunduğu /init, /plan, /compress ve /remember gibi komutları nasıl kullanarak projesini baştan sona optimize ettiğini ayrıntılarıyla paylaştı. Bu yöntemler, yalnızca token tüketimini azaltmakla kalmıyor, aynı zamanda geliştirme sürecindeki bağlam kaybını da minimize ediyor. Özellikle büyük ölçekli projelerde, her oturumda projeyi yeniden anlamak yerine, sürekli bir bilgi birikimi oluşturmanın önemi giderek artıyor.

Neden Qwen Code?

Geliştirme araçları konusunda pek çok seçenek bulunan geliştirici, Qwen Code’a geçmeden önce farklı modelleri denemiş. Claude Code, Gemini CLI ve diğer bazı alternatifler üzerinde çalışmalar yürütmüş. Ancak Qwen Code’un sunduğu açık kaynak olma avantajı, zengin slash komut sistemi ve özellikle TypeScript ile Electron projelerindeki üstün performansı, onu tercih sebebi haline getirmiş.

Geliştirici, ağır görevler için Qwen Max modelini kullanırken, daha hafif görevler içinse hızlı yanıtlar alabilmek adına /model --fast qwen3-coder-flash komutunu tercih ediyor. Bu esneklik, hem performansı hem de maliyetleri optimize etmeyi mümkün kılıyor. Ayrıca, Qwen Code’un alt ajan desteği de oldukça güçlü. Birden fazla bağımsız görevi aynı anda ve aynı bağlam içinde yürütebilmek, projelerin karmaşıklığını önemli ölçüde azaltıyor.

Projeye Başlarken: /init Komutunun Gücü

Yeni bir projeye başlarken ya da uzun bir aradan sonra projeye geri döndüğünüzde, ilk adım olarak /init komutunu çalıştırmanız gerekiyor. Bu komut, mevcut dizindeki dosya yapısını, önemli dosyaları ve projenin genel yapısını otomatik olarak analiz ediyor. Ardından, Qwen Code’a proje hakkında temel bir anlayış kazandırıyor.

Bunun ardından, geliştirici projeye özel bir bağlam dosyası oluşturuyor. Bu dosyada, projenin amacı, mevcut kilometre taşı, kullanılan teknoloji yığını ve bilinen kısıtlar (örneğin Electron IPC sınırları, Upstash Redis entegrasyonu veya Gumroad tabanlı gelir modeli) gibi kritik bilgileri elle ekliyor. Tıpkı yeni bir geliştiriciyi ekibe dahil ederken yaptığımız gibi, projenin tüm detaylarını olabildiğince net bir şekilde tanımlamak, ilerleyen süreçte yaşanabilecek yanlış anlaşılmaları ve gereksiz tekrarları ortadan kaldırıyor.

Spec Odaklı Planlama: /plan Komutuyla Proaktif Geliştirme

Yeni bir özelliği hayata geçirmeden önce, geliştirici /plan komutunu kullanarak Qwen Code’u planlama moduna alıyor. Bu modda, kod yazımı başlamadan önce projeye dair detaylı bir spesifikasyon oluşturuluyor. Geliştirici, /plan komutunu kullanarak özelliğin ne yapması gerektiğini, hangi sınırlamalara sahip olduğunu ve kabul kriterlerini tanımlıyor.

Planlama süreci iteratif bir şekilde ilerliyor. İlk olarak, özelliğin detaylı bir tanımı yapılıyor. Ardından, Qwen Code’a önerilerde bulunması ve olası yaklaşımları değerlendirmesi isteniyor. Geliştirici, önerilen yaklaşımları projenin mimari yapısına uygunluğu açısından yeniden gözden geçiriyor ve gerekirse revizyonlar talep ediyor. Bu süreç, genellikle 2 ila 3 tur devam ediyor ve nihai spesifikasyon oluşturulana kadar devam ediyor.

Bu yaklaşımın en büyük avantajı, kod yazımına başlamadan önce tüm projeyi baştan sona düşünme fırsatı sunması. Spesifikasyon ne kadar net olursa, ortaya çıkan kodun kalitesi de o kadar yüksek oluyor. Geliştirici, bu yöntemi kullanarak neredeyse herhangi bir aracın sunduğundan daha iyi bir geliştirme disiplini kazandığını belirtiyor.

Paralel Çalışma için Alt Ajanların Kullanımı

Spesifikasyon tamamlandığında, geliştirici artık paralel olarak yürütülebilecek görevler için alt ajanları devreye alıyor. Qwen Code’un sunduğu alt ajan sistemi, .qwen/agents/ dizininde saklanan özel Markdown dosyaları aracılığıyla özelleştirilebiliyor. Her bir alt ajan, kendi sistem komutları, izin verilen araç listesi ve model tercihine sahip olabiliyor.

Achu projesi için geliştirilen alt ajanlar arasında test alt ajanı ve kod denetleyici alt ajanı bulunuyor. Test alt ajanı, Vitest ve Electron test desenlerine odaklanırken, kod denetleyici alt ajanı yalnızca dosyaları okuyarak incelemeler yapıyor.

Alt ajanların en güçlü yanı, proje içindeki görevlerin aynı anda ve aynı bağlam içinde yürütülebilmesi. Geliştirici, Qwen Code’a paralel olarak yürütülmesini istediği görevleri açıkça belirtirken, alt ajanlar bu görevleri arka planda ve token maliyetlerini artırmadan gerçekleştiriyor. Örneğin, geliştirici Privacy Guard IPC işleyicisi, Ollama entegrasyonu ve Upstash Redis oylama akışı gibi üç farklı görevi paralel olarak yürütmek istediğinde, Qwen Code otomatik olarak bu görevleri alt ajanlara dağıtıyor ve sonuçları tek bir yerde topluyor.

Alt ajan yapılandırması .qwen/agents/testing.md dosyasında şu şekilde tanımlanıyor:

---
name: testing
description: "Achu için Vitest birim testleri ve Electron entegrasyon testleri yaz. Testle ilgili herhangi bir görevi PROAKTİF şekilde yerine getir."
approvalMode: auto-edit
tools:
  - read_file
  - write_file
  - read_many_files
  - run_shell_command
---

Electron + React + TypeScript projesi için test uzmanı olarak hareket et. Sadece JSON formatında çıktı üret, markdown sınırlayıcıları kullanma ve ekstra metin ekleme.

Bağlam Temizliği ve Token Yönetimi: /compress ve /remember

Geliştirme süreci boyunca, proje bağlamının temiz ve optimize edilmiş kalması kritik önem taşıyor. Qwen Code’un /compress komutu, mevcut oturumdaki token sayısını azaltmak için kullanılabiliyor. Bu komut, proje bağlamını daha kompakt bir şekilde yeniden düzenliyor ve gereksiz detayların filtrelenmesini sağlıyor.

Bunun yanı sıra, /remember komutu aracılığıyla mimari kararlar ve önemli ayrıntılar kalıcı olarak saklanabiliyor. Bu sayede, geliştirici farklı oturumlarda projeye geri döndüğünde, tüm geçmiş kararları ve bağlamı yeniden oluşturmak zorunda kalmıyor. Bu özellik, özellikle uzun süreli projelerde büyük bir zaman tasarrufu sağlıyor.

Geleceğe Bakış: Yapay Zekanın Geliştirici Deneyimine Katkıları

Yapay zeka destekli geliştirme araçları, sadece kod yazmayı kolaylaştırmakla kalmıyor, aynı zamanda geliştiricilerin projelere dair stratejik düşünme yeteneklerini de güçlendiriyor. Qwen Code’un slash komutları ve alt ajan sistemi, geliştiricilere daha organize, verimli ve sürdürülebilir bir geliştirme süreci sunuyor. Bu araçlar sayesinde, özellikle karmaşık ve büyük ölçekli projelerde, hem zaman hem de maliyet açısından önemli kazanımlar elde etmek mümkün hale geliyor.

Gelecekte, bu tür akıllı geliştirme araçlarının daha da yaygınlaşması ve geliştiricilerin günlük çalışmalarına daha derinlemesine entegre olması bekleniyor. Yapay zeka destekli araçların sunduğu bu yeni olanaklar, yazılım geliştirme dünyasında verimlilik ve yenilik açısından yeni bir dönemin kapılarını aralıyor.