Codex ile Uzun Süreli Görevlerde İş Birliği

Codex uzun süreler boyunca çalışabilir, özellikle de bir /goal ona kalıcı bir hedef verdiğinde. Daha zor olan kısım, saatler veya günler boyunca çalışırken, yeni uygulama detaylarını ortaya çıkarırken ve çeşitli doğrulama türlerinden geçerken odaklanmış kalmaktır.

Uygulama başladığında, ilk varsayımlar genellikle değişir. İş birliği modelinin, hedefi korurken hem size hem de Codex'e yeni kanıtlar ortaya çıktıkça planı revize etme alanı tanıması gerekir.

Son birkaç haftadır beş uygulama kullanıyorum:

1. Codex'in işi planlamasına ve yol haritasını tutmasına izin verin.
2. Ana akışı koordinasyona odaklı tutun.
3. Her kilometre taşından sonra yol haritasını denetleyin ve kodu gözden geçirin.
4. Bilgisayar Kullanımı testi için yerel akışlar kullanın.
5. Kısa güncellemeler ve panolar aracılığıyla ilerlemeyi raporlayın.

Codex'te GPT Image 2 ile oluşturuldu

1. Codex'in işi planlamasına ve yol haritasını tutmasına izin verin

Genellikle /plan modu yerine bir sohbetle başlarım. Ne inşa etmeye çalıştığımı tarif eder, kaba fikirleri söyler, kısıtlamaları paylaşır ve Codex'in ilk bir plan önerecek kadar bağlam elde edene kadar soru sormasına izin veririm.

Bu, erken tartışmayı esnek tutar. Codex yardım etmeye başlamadan önce yarı oluşmuş fikirleri resmi bir spesifikasyona dönüştürmem gerekmez. Benimle röportaj yapabilir, ne anladığını yansıtabilir, boşlukları belirleyebilir ve konuşmayı yavaş yavaş uygulanabilir bir plana dönüştürebilir.

Proje şekillenmeye başladığında, Codex'ten mevcut Goal'i ayarlamasını isterim. Goal modu, Codex'e kalıcı bir hedef vererek, hedef tamamlanana, engellenene veya değiştirilene kadar aynı sonuç için birden çok tur boyunca çalışmaya devam etmesini sağlar.

Hedefi kendim /goal ile ayarlayabilirim, ancak genellikle Codex'ten yapmasını isterim. Goal modu, koşum takımı (harness) aracılığıyla sunulur, böylece Codex sohbetimizi, proje bağlamını ve şimdiye kadar öğrendiği her şeyi net bir hedefte sentezleyebilir. Ayrıca, bu hedefin tamamlanmış sayılması için gereken kanıtları da tanımlayabilir.

Daha büyük projeler için, Codex'ten daha geniş yol haritasını GOALS.md dosyasına yazmasını isterim. Bu, Codex'in yerleşik bir özelliğinden ziyade bir proje kuralıdır ve dosyaya dilediğiniz ismi verebilirsiniz.

GOALS.md dosyasını genellikle düz bir görev listesi yerine kilometre taşları etrafında düzenlerim. Her kilometre taşı şunları kaydeder:

• hedeflenen sonuç
• şu anda kapsam dahilindeki iş
• önemli kararlar
• bilinen engeller
• devam etmeden önce gereken kanıtlar

Codex, proje geliştikçe dosyayı günceller. Yeni bulgular bir kilometre taşının kapsamını değiştirebilir, yeni bir tane ekleyebilir veya tamamlanma için gereken kanıtları değiştirebilir.

Aynı anda yalnızca bir Goal modu hedefi aktiftir. Kilometre taşları tamamlandıkça, Codex GOALS.md dosyasını günceller, sonraki hedefi etkinleştirir ve ona doğru çalışmaya devam eder.

2. Ana akışı koordinasyona odaklı tutun

Yol haritası oluştuktan sonra, ana akışı hedefe, kısıtlamalara, kararlara ve mevcut proje durumuna odaklı tutarım.

Sırada ne olması gerektiğine karar verir, sınırlı görevleri devreder ve sonuçları değerlendirir. Her uygulama detayını taşıması gerekmez.

Bir çalışan, yabancı bir kodu okumak, birkaç yaklaşım denemek veya başarısız bir testin izini sürmek için bir saat harcayabilir. Koordinatörün yalnızca daha geniş projeyi etkileyen bilgilere ihtiyacı vardır:

• çalışanın ne öğrendiği
• neyin değiştiği
• destekleyici kanıtlar
• sırada ne olması gerektiği

Codex bu işi bir alt ajana (subagent) devredebilir veya ayrı bir akış oluşturabilir. İşlevsel olarak aynı görevi yerine getirebilirler. Daha sonra işe geri dönmeyi beklediğimde ayrı bir akış kullanırım, çünkü Codex uygulamasında görünür kalır ve kendi geçmişini tutar.

Bu, özellikle birkaç iş parçası paralel olarak yürütüldüğünde kullanışlı hale gelir. Ana akış, her araştırma, uygulama veya inceleme kolayca incelenebilir durumdayken projeyi koordine etmeye devam edebilir.

3. Her kilometre taşından sonra yol haritasını denetleyin ve kodu gözden geçirin

GOALS.md, Codex'in en son güncellediği anda bilinenleri yansıtır. Bir kilometre taşının sonunda, proje genellikle yeni bir şey ortaya çıkarmıştır.

Devam etmeden önce, başka bir akıştan yol haritasını mevcut durumla karşılaştırmasını isterim:

• Kilometre taşı gerçekten tamamlandı mı?
• Bir sonraki hedef hala doğru hedef mi?
• Eksik kilometre taşları var mı?
• Yeni kanıtlar iş sırasını değiştirdi mi?
• Tamamlanma tanımı hala geçerli mi?

Bu denetimi her kilometre taşının sonunda ve ayrıca yeni kanıtlar projenin yönünü önemli ölçüde değiştirdiğinde gerçekleştiririm.

Ayrıca uygulama üzerinde /review çalıştırırım.

Bir oturum açma akışı için uygulama ve uzak testlerin tamamlandığını varsayalım. Yol haritası denetimi, akışın gerçek bir oturum açmış tarayıcıda hiç kimse tarafından test edilmediğini fark edebilir. Aynı zamanda, /review, uzak testler geçse bile yeni yolun bir belirteci (token) yanlış sakladığını bulabilir.

Koordinatör GOALS.md'yi günceller, belirteç düzeltmesini devreder, eksik tarayıcı doğrulamasını ekler ve ancak o zaman bir sonraki kilometre taşını etkinleştirir.

Denetimleri ve incelemeleri genellikle ayrı akışlarda tutarım. Bir alt ajan da aynı işi yapabilir, ancak ayrı bir akış, daha sonra dönebileceğim görünür bir kayıt bırakır.

4. Bilgisayar Kullanımı testi için yerel akışlar kullanın

Codex oturumlarımın çoğu uzak bir örnekte (instance) çalışır, böylece dizüstü bilgisayarım kapalıyken iş devam edebilir. Bazı kontroller hala yerel makineme bağlıdır:

• oturum açmış bir tarayıcı
• yerel kimlik bilgileri
• Xcode
• macOS izinleri
• iOS Simulator

Uzak koordinatör, bu kontrollerden biri için yerel bir akış oluşturabilir. Uzak farkı (diff) uygular veya ilgili dalı (branch) ya da commit'i kontrol ederim, böylece yerel akış doğru kodu test eder.

Yerel akış, tarayıcıyı veya uygulamayı çalıştırır ve ekran görüntüleri, günlükler ve bulgular döndürür. Bir kontrol başarısız olduğunda, uzak bir çalışan sorunu düzeltir ve yerel akış tekrar test eder.

Tipik bir döngü şöyle görünür:

1. Uzak bir çalışan oturum açma akışını uygular.
2. Uzak testler geçer.
3. Yerel bir akış, Codex Chrome uzantısını kullanır.
4. Tarayıcı testi bir yönlendirme hatası ortaya çıkarır.
5. Uzak bir çalışan bunu düzeltir.
6. Yerel akış kontrolü tekrarlar.

Proje varsayılan olarak uzak kalır. Bilgisayarım yalnızca gerektiren kontroller için katılır. Dizüstü bilgisayarımı tekrar açtığımda, uzak akış da yerel akışın tekrar kullanılabilir hale gelmesini kontrol etmeye devam edebilir.

5. Kısa güncellemeler ve panolar aracılığıyla ilerlemeyi raporlayın

Çalışan akışları genellikle tek bir görevi raporlar. Projeye döndüğümde, genel duruma dair bir görüşe ihtiyacım vardır:

• neyin tamamlandığı
• neyin değiştiği
• neyin kaldığı
• neyin karar gerektirdiği

Proje durumu her değiştiğinde Codex'ten üç kısa bölüm kullanarak rapor vermesini isterim:

**Tamamlananlar

Sıradakiler

Herhangi bir engel**

Bu, neredeyse Codex ile günlük bir stand-up toplantısı yapmak gibidir, ancak saat başı.

Codex aynı güncellemeyi Slack üzerinden, doğrudan mesaj olarak veya özel bir proje kanalında gönderebilir.

Codex uygulamasındayken, ana akışı kesintiye uğratmadan durumu kontrol etmek için /side komutunu da kullanırım. Yan akıştan, tamamlananları, kalanları ve yardımıma ihtiyaç olup olmadığını (örneğin, manuel bir tıklama, onay veya başka bir clickops parçası) sorabilirim.

Yan akıştan özet alma

Yan akıştan talimatlarımı ana akışa iletmesini isteme

Daha sonra bir talimatı netleştirebilir, bir engeli çözebilir, bağlam ekleyebilir veya yan akıştan güncellenmiş yönergeleri ana akışa geri göndermesini isteyebilirim.

Birkaç kilometre taşı veya paralel iş akışı olan projeler için ayrıca bir progress-dashboard.html dosyası tutarım. Bu, Codex'in yerleşik bir arayüzü değil, özel bir proje yapıtıdır (artifact). Şunları gösterebilir:

• aktif hedef
• tamamlanan kilometre taşları
• kanıtlar
• engeller
• kararlar
• son güncellemeler

Birkaç saat sonra döndüğümde, her çalışan akışını okumadan projenin durumunu anlayabilirim. Codex, panoyu bir Site olarak da dağıtabilir, böylece uzaktan erişilebilir kalır.

Özet

Bu yapıyı, bir projenin yeni bilgiler ortaya çıkarması, birkaç bağımsız iş parçası içermesi veya birden fazla ortamdan kanıt gerektirmesi muhtemel olduğunda kullanırım.

İş akışı basit bir döngüyü takip eder. Codex ilk konuşmayı bir yol haritasına dönüştürür, bir kilometre taşını etkinleştirir, işi devreder ve devam etmeden önce sonucu kontrol eder. Yerel akışlar, makinemi gerektiren kontrolleri hallederken, güncellemeler ve panolar her şeyi sıfırdan yeniden oluşturmadan projeye dönmeme yardımcı olur.

Önemli olan kısım, proje durumunu bir sonraki kararın Codex'in gerçekte ne öğrendiğini yansıtacağı kadar güncel tutmaktır.

Deneyin

Bunu yeni bir Codex akışına yapıştırın:

Bunu uzun soluklu bir proje olarak koordine et.

Önce ne inşa etmeye çalıştığım konusunda benimle röportaj yaparak başla. Kaba fikirleri ve kısıtlamaları sohbet havasında anlatmama izin ver, ardından bu tartışmayı bir ilk plana dönüştür.

Ortak yol haritası olarak GOALS.md dosyasını oluştur. Kilometre taşları etrafında düzenle ve her biri için hedeflenen sonucu, kapsamı, kararları, engelleri ve gereken kanıtları belirt.

Bir seferde yalnızca bir Goal modu hedefi belirle ve sürdür. Aktif hedef, mevcut kilometre taşına karşılık gelmelidir.

Bu akışı hedefe, kısıtlamalara, kararlara ve proje durumuna odaklı tut. Uygulamayı alt ajanlara veya yeni akışlara devret.

Çalışanların tam dökümler yerine sonuçlar, değişiklikler ve kanıtlar döndürmesini şart koş.

Daha sonra incelemek, devam ettirmek veya gözden geçirmek isteyebileceğim işler için ayrı akışlar kullan. Kendi görünür geçmişine ihtiyaç duymayan sınırlı işler için alt ajanlar kullan.

Her kilometre taşından sonra, GOALS.md dosyasını mevcut duruma karşı denetlemek ve uygulama üzerinde /review çalıştırmak için ayrı bir akış kullan. Bir sonraki hedefi etkinleştirmeden önce yol haritasını güncelle.

Tarayıcıma, masaüstü uygulamalarıma, izinlere, kimlik bilgilerine veya cihaz durumuna bağlı olan Bilgisayar Kullanımı testleri için yerel akışlar kullan.

*Proje durumu değiştiğinde, yalnızca şunları raporla: - Tamamlananlar - Sıradakiler - Herhangi bir engel*

Proje birden çok kilometre taşı veya çalışanı kapsadığında progress-dashboard.html dosyasını güncel tut. Üzerinde anlaşılan kanıtlar mevcut olana kadar tamamlandı olarak bildirme.

Alternatif olarak, bu makalenin bir Appshot'ını alıp Codex'e şunu da sorabilirsiniz:

Bu makaleden orchestrate-projects adında yeniden kullanılabilir bir Codex becerisi oluştur.

Bu uygulamaları koru:

*- Codex'in benimle röportaj yapmasına ve ilk planları oluşturmasına izin ver - kilometre taşı tabanlı bir yol haritası olarak GOALS.md kullan - bir seferde yalnızca bir Goal modu hedefini aktif tut - ana akışı koordinasyona odaklı tut - her kilometre taşından sonra yol haritasını denetle ve /review çalıştır - daha sonra tekrar göz atmak isteyebileceğim işler için ayrı akışlar kullan - Bilgisayar Kullanımı testi için yerel akışlar kullan - ilerlemeyi kısa güncellemeler, Slack ve progress-dashboard.html aracılığıyla raporla*