Codex'in Sizi Daha İyi Anlamasını Nasıl Sağlarsınız: Verimliliği %90 Artırmak İçin Bu Hafıza Tekniklerinde Uzmanlaşın

Codex App'i bir süre kullandıysanız, benzer hayal kırıklıkları yaşamış olabilirsiniz: her yeni sohbette temel tercihleri tekrar tekrar belirtmek zorunda kalmak veya beklentilerinizin ötesinde sistem komutlarını yanlışlıkla çalıştırması.

Bu sık karşılaşılan sorunların özü, Codex'inizin istikrarlı bir uzun vadeli hafızaya sahip olmamasıdır. Bu verimsiz tekrarlayan iletişimleri tamamen çözmek için, ona eksiksiz bir hafıza sistemi kurmalısınız.

Bu makale, AGENTS.md ve Memories özelliğini yapılandırarak Codex'e kalıcı hafıza kazandırmayı, böylece niyetinizi gerçekten anlamasını ve verimlilik artışı sağlamasını anlatacak.

1. AGENTS.md

1. Nedir?

AGENTS.md, Codex'in her başlangıcında otomatik olarak okuduğu önceden yazılmış bir kural talimatları kümesidir.

AGENTS.md olmadan, Codex her seferinde boş bir sayfa olarak başlar—çalışma alışkanlıklarınızı, proje geçmişinizi veya işlem yürütme sınırlarını bilmez.

İlgili kurallar yapılandırıldığında, bu bağlamlar kalıcı hale gelir ve aynı sorunu asla tekrar açıklamak zorunda kalmazsınız.

2. Nasıl yapılandırılır ve kullanılır

1️⃣ Genel Katman: Yerel bilgisayarınızdaki ~/.codex/AGENTS.md dizininde saklanır ve tüm projeleriniz için geçerlidir. Genel kişisel tercihler ve genel kurallar yazmak için uygundur.

Codex App'te bu, Kişiselleştirme ayarları sayfasındaki "Özel Talimatlar" bölümüne karşılık gelir.

İşte önerilen temel bir şablon; yukarıda gösterilen yere doğrudan kopyalayıp yapıştırabilir ve ardından ihtiyaçlarınıza göre sürekli ayarlayabilirsiniz:

1# AGENTS.md
2
3## Temel Davranış
4
5- Varsayılan olarak Türkçe yanıtla, kullanıcı açıkça başka bir dil talep etmedikçe.
6- Yanıtlar kısa ve doğrudan olmalı, gereksiz dolgu ve tekrardan kaçınmalı.
7- Görev tanımı net değilse, yürütmeye başlamadan önce onay iste.
8- Kullanıcının niyeti dışındaki ihtiyaçlar hakkında aktif olarak tahminde bulunma; yalnızca isteneni yap.
9
10## Güvenlik Sınırları
11
12- Varsayılan olarak salt okunur; kullanıcı açıkça talimat vermedikçe dosyaları aktif olarak değiştirme veya silme.
13- Geri döndürülemez işlemler (silme, üzerine yazma veya harici API'leri çağırarak yazma gibi) içermeden önce onay alınmalıdır.
14- Çıktıda hiçbir anahtar, token veya hassas kimlik bilgisi yazdırma.
15
16## Mühendislik Standartları
17
18- Aşırı mühendislikten kaçının; yalnızca açıkça gerekli olan veya görev için bariz şekilde gerekli olan değişiklikleri yapın, çözümü basit tutun.
19- İstenmedikçe özellik ekleme, kodu yeniden düzenleme veya ek optimizasyonlar yapma.
20- Değiştirilmeyen koda yorum, tip ek açıklaması veya docstring ekleme.
21- Yorumları yalnızca mantık kendini açıklamadığında ekle.
22- Gerçekleşmesi muhtemel olmayan senaryolar için hata işleme veya yedekleme mantığı ekleme.
23- Yalnızca bir kez kullanılan yardımcı işlevler veya soyutlama katmanları oluşturma.
24- Kullanılmadığı onaylanan kodu doğrudan sil; yorum açıklaması bırakma.

2️⃣ Proje Katmanı: Proje dizininde saklanır, temel olarak projenin temasına ve özelliklerine göre kuralları özelleştirmek için kullanılır.

İyi bir proje düzeyi AGENTS.md tipik olarak aşağıdaki yönleri kapsamalıdır:

• Proje geçmişi ve yapısı: Projenin ne olduğu ve önemli dizinlerin nerede olduğu.
• Yürütme yöntemleri: Projenin nasıl başlatılacağı, çalıştırılacağı veya işletileceği.
• Standartlar ve kısıtlamalar: Uyulması gereken standartlar ve açıkça yapılmaması gereken şeyler.
• Tamamlanma kriterleri: Bir görevin ne zaman bittiğinin nasıl belirleneceği.

3. AGENTS.md En İyi Uygulamaları

Temel bir AGENTS.md yapılandırmak yalnızca ilk adımdır. Aşağıdaki pratik ilkeler, hafıza sisteminizin üst sınırını belirler:

1️⃣ Kural Katmanlaması, Net Sorumluluklar

Codex'te AGENTS.md, yakınlık ilkesini izler: Alt Dizin > Kök Dizin > Genel. Yani, mevcut çalışmanın bulunduğu dizindeki kurallar en yüksek önceliğe sahiptir.

Bu, proje düzeyindeki kuralların aynı türdeki genel ayarları doğrudan geçersiz kılacağı anlamına gelir. Tüm kurallar karıştırılırsa, yüksek öncelikli yerel kurallar, genel temel mantığı kolayca yanlışlıkla kirletebilir veya bozabilir.

Bu nedenle, makul bir kural hafıza sistemi "endişe ayrımı" ilkesini izlemelidir: genel katman yalnızca genel kuralları içerir, örneğin dil tercihleri, güvenlik sınırları ve temel davranış alışkanlıkları; proje katmanı ise yalnızca o projeye özgü kuralları içerir, örneğin derleme komutları, kod kuralları ve modül açıklamaları.

İkisi kendi görevlerini yerine getirir, birbirine karışmaz ve birleştirildiğinde hiçbir çatışma ortaya çıkmaz.

2️⃣ Temelden Başlayın, Gerektikçe İterasyon Yapın

AGENTS.md'nin bir kerede yazılması gerekmez. En temel kurallarla başlayın. Codex aynı hatayı tekrarladığında, doğrudan kuralları incelemesini ve güncellemesini isteyin, örneğin:

"Az önce geçen seferkiyle aynı hatayı yaptın. Lütfen nedenini özetle ve ilgili deneyimi AGENTS.md'ye ekle."

Bu şekilde, kurallar her zaman gerçek kullanım sürtüşmelerinden gelir ve AGENTS.md kullanımla birlikte sürekli olarak gelişir.

3️⃣ Hafif Tutun, Karmaşık İçerikleri Ayrı Ayrı Bölün

Kullanım derinleştikçe, AGENTS.md'nin içeriği artabilir. Bu noktada her şeyi tek bir dosyaya yığmak gerekmez. Bunun yerine, belirli konular için içerikleri bağımsız dosyalara yazın ve ardından ana dosyada bunlara referans verin.

Örneğin, proje mimarisi açıklamasını ayrı olarak ARCHITECTURE.md olarak yazın ve AGENTS.md'ye yalnızca tek satırlık bir referans ekleyin:

"Bu projenin temel mimarisi ve dizin kuralları için, mevcut dizindeki ARCHITECTURE.md dosyasına bakın."

2. Memories Özelliği

İlgili kuralları aktif olarak yapılandırmanın yanı sıra, Codex ayrıca aktif bir hafıza özelliğini de destekler; bunun Ayarlar - Kişiselleştirme - Hafıza bölümünden etkinleştirilmesi gerekir, aşağıda gösterildiği gibi:

Düğmeyi açtıktan sonra, Codex konuşmadaki etkili bilgileri ve anahtar tercihleri aktif olarak hafızaya özetler. Codex'inizin hangi hafızaları eklediğini görmek isterseniz, ~/.codex/memory içindeki Memory.md dosyasını açarak Codex'inizin eklediği hafıza içeriğini görüntüleyebilirsiniz. İşte benimki:

Son Olarak

Bir hafıza sistemi kurmak, zamanla gelişen bir süreçtir. İnanın bana, eylem kurallarını iyileştirmeye ve güncellemeye devam ettiğiniz ve hafızaları sürekli biriktirdiğiniz sürece, Codex hızla sizi en iyi anlayan ve kullanımı en kolay olan temel üretkenlik aracınız haline gelecektir.