Rehber Codex CLI ile mevcut projede ilk görev nasıl başlatılır?

Codex CLI’yi mevcut projede kullanmaya, proje kökünden küçük ve sonucu görülebilen bir görev vererek başlayın. İlk denemede uygulamanın tamamını yeniden yazdırmak yerine bir hatanın nedenini bulmak veya tek bir davranışı düzeltmek daha kolay denetlenir. Codex’in dosyaları görebilmesi ile projenin çalıştırma ortamının hazır olması farklı koşullardır.

Başlangıç koşullarını hazırlayın​

Bu anlatım Codex CLI’nin kurulu olduğunu ve hesabınızla kullanılabildiğini varsayar. Projenin mevcut başlatma ve kontrol komutlarını README’den doğrulayın. Git kullanıyorsanız kaydedilmemiş değişikliklerinizi bilin; araç çıktısıyla kendi çalışmanızı ayırmak için başlangıç durumunu kontrol edin.

İlk görevi dar kapsamda çalıştırın​

1. Terminali proje kökünde açın. Paket veya uygulama tanımının bulunduğu klasörde codex komutunu çalıştırın. Yanlış klasördeyseniz önce kapatıp doğru proje üzerinden başlayın.
2. Önce yapıyı açıklatın. “Dosyaları değiştirmeden uygulamanın başlangıç noktasını, ilgili formu ve mevcut test komutunu göster” isteğini verin. Dosya yollarını kontrol edin.
3. Tek davranış isteyin. Örneğin “Boş kullanıcı adı gönderildiğinde alan altında uyarı göster; başarılı giriş davranışını koru” deyin. Beklenen sonucu ve sorunun oluşma yolunu ekleyin.
4. İzin isteğinin kapsamını okuyun. Bir komut istenen işle ilgisizse geniş yetki vermek yerine neden gerektiğini açıklatın. Yerel bir hata düzeltmesi için canlı veri tabanı veya dağıtım erişimi gerekmeyebilir.
5. Sonucu kanıtıyla değerlendirin. Değişen dosyaları ve çalıştırılan kontrolün gerçek çıktısını inceleyin. “Düzeltildi” ifadesinin yanında hangi örneğin denendiğini görün.

İyi bir ilk istek örneği​

src/forms/LoginForm içindeki boş kullanıcı adı sorununu düzelt. Önce ilgili doğrulama yolunu bul. Yalnız bu davranışı değiştir; tasarımı ve sunucu kimlik doğrulamasını koru. Mevcut kontrol varsa kullan, sonra boş ve geçerli giriş için sonucu açıkla.

Genişletmek için tıkla ...

Kontrol komutu çalışmıyorsa bütün bağımlılıkları rastgele yükseltmeyin. Eksik ortamı veya başlangıçta zaten görülen hatayı ayırın. Kodun değişmiş olması görevin tamamlandığı anlamına gelmez; başta tarif ettiğiniz görünür davranış gerçekleştiğinde ilk görev doğrulanmış olur.

İlk Codex görevinde mevcut test komutu ortam eksikliği yüzünden çalışmıyorsa, bunu düzeltilen kodun başarısızlığıyla nasıl ayırmalı? Örnek olarak uygulamadaki küçük bir alan denetimi değişirken başlangıçta da eksik bir bağımlılık bulunduğunu düşünelim. Son raporda bu iki durumu birbirinden ayıracak bilgi ne olmalı?

Değişiklikten önceki kontrol sonucunu kaydetmek bu ayrımı sağlar. Aynı komut başlangıçta da aynı eksik bağımlılık hatasıyla duruyorsa, yeni kodun doğrulandığı söylenemez; fakat hatanın yeni değişiklikten doğduğu da varsayılmaz. Eksik ortam koşulu ile değişen davranış ayrı belirtilmeli ve mümkünse ilgili davranış başka uygun yoldan gözlenmelidir.

Burada bütün bağımlılıkları yükseltmek yerine gereken ortamı açıklığa kavuşturmak daha kontrollü olur. Çalıştırılacak betiğin ne yaptığını ve proje tanımında gerçekten bulunduğunu kontrol etmek gerekir. Ortam hazırlandıktan sonra aynı kabul örnekleri yeniden denenmeli; eski başarısız çıktı, yeni kodun sonucuymuş gibi bırakılmamalı.