Özelleştirme

Özelleştirme, Codex'in ekibinizin çalışma biçimine uygun çalışmasını sağlamanın yoludur.

Codex'te özelleştirme, birlikte çalışan birkaç katmandan oluşur:

• Kalıcı talimatlar için proje yönergeleri (AGENTS.md)
• Önceki çalışmalardan öğrenilen yararlı bağlam için Anılar
• Yeniden kullanılabilir iş akışları ve alan uzmanlığı için Beceriler
• Harici araçlara ve paylaşılan sistemlere erişim için MCP
• Çalışmaları uzmanlaşmış alt ajanlara devretmek için Alt ajanlar

Bunlar birbirinin rakibi değil, tamamlayıcısıdır. AGENTS.md davranışı şekillendirir, anılar yerel bağlamı geleceğe taşır, beceriler tekrarlanabilir süreçleri paketler ve MCP, Codex'i yerel çalışma alanının dışındaki sistemlere bağlar.

AGENTS Yönergeleri

AGENTS.md, Codex'e deponuzla birlikte taşınan ve ajan çalışmaya başlamadan önce uygulanan kalıcı proje yönergeleri sağlar. Dosyayı küçük tutun.

Codex'in bir depoda her zaman uymasını istediğiniz kurallar için kullanın; örneğin:

• Derleme ve test komutları
• İnceleme beklentileri
• Depoya özgü kurallar
• Dizine özgü talimatlar

Ajan kod tabanınız hakkında yanlış varsayımlarda bulunduğunda bunları AGENTS.md içinde düzeltin ve düzeltmenin kalıcı olması için ajandan AGENTS.md dosyasını güncellemesini isteyin. Bunu bir geri bildirim döngüsü olarak değerlendirin.

AGENTS.md ne zaman güncellenmeli?

• Yinelenen hatalar: Ajan aynı hatayı tekrar tekrar yapıyorsa bir kural ekleyin.
• Çok fazla okuma: Doğru dosyaları bulmasına rağmen çok fazla belge okuyorsa yönlendirme yönergeleri ekleyin (hangi dizinlere/dosyalara öncelik verileceği).
• Yinelenen PR geri bildirimi: Aynı geri bildirimi birden fazla kez veriyorsanız bunu kurala dönüştürün.
• GitHub'da: Güncellemeyi bir bulut sohbetine devretmek için bir pull request yorumunda @codex etiketini bir istekle (örneğin, @codex add this to AGENTS.md) kullanın.
• Sapma kontrollerini otomatikleştirme: Yönerge eksiklerini arayan ve AGENTS.md dosyasına nelerin eklenebileceğini öneren yinelenen kontrolleri (örneğin günlük) çalıştırmak için zamanlanmış görevleri kullanın.

AGENTS.md dosyasını bu kuralları uygulayan altyapıyla eşleştirin: pre-commit hook'ları, linter'lar ve tür denetleyicileri sorunları siz görmeden yakalar; böylece sistem, yinelenen hataları önleme konusunda daha akıllı hâle gelir.

Codex yönergeleri birden fazla konumdan yükleyebilir: Codex ana dizininizdeki genel bir dosya (geliştirici olarak sizin için) ve ekiplerin depoya kaydedebileceği depoya özgü dosyalar. Çalışma dizinine daha yakın dosyalar önceliklidir. Codex'in sizinle nasıl iletişim kuracağını (örneğin inceleme tarzı, ayrıntı düzeyi ve varsayılanlar) şekillendirmek için genel dosyayı kullanın; depo dosyalarını ise ekip ve kod tabanı kurallarına odaklı tutun.

<FileTree class="mt-4" tree={[ { name: "~/.codex/", open: true, children: [ { name: "AGENTS.md", comment: "Genel (geliştirici olarak sizin için)" }, ], }, { name: "repo-root/", open: true, children: [ { name: "AGENTS.md", comment: "Depoya özgü (ekibiniz için)" }, ], }, ]} />

AGENTS.md ile özel talimatlar

Beceriler

Beceriler, Codex'e tekrarlanabilir iş akışları için yeniden kullanılabilir yetenekler kazandırır. Daha zengin talimatları, betikleri ve başvuruları destekleyip görevler genelinde yeniden kullanılabilir kaldıkları için beceriler çoğu zaman yeniden kullanılabilir iş akışlarına en uygun seçenektir. Beceriler yüklenir ve ajana görünür olur (en azından meta verileri); böylece Codex onları keşfedip örtük olarak seçebilir. Bu, zengin iş akışlarını bağlamı baştan şişirmeden kullanılabilir tutar.

İş akışlarını yerel olarak oluşturmak ve yinelemeli biçimde geliştirmek için beceri klasörlerini kullanın. İş akışı için zaten bir eklenti varsa kanıtlanmış bir kurulumdan yararlanmak üzere önce onu yükleyin. Kendi iş akışınızı ekipler arasında dağıtmak veya bağlayıcılarla paketlemek istediğinizde onu bir eklenti olarak paketleyin. Beceriler yazım biçimi olarak kalır; eklentiler ise yüklenebilir dağıtım birimidir.

Bir beceri genellikle bir SKILL.md dosyasından ve isteğe bağlı betiklerden, başvurulardan ve varlıklardan oluşur.

<FileTree class="mt-4" tree={[ { name: "my-skill/", open: true, children: [ { name: "SKILL.md", comment: "Zorunlu: talimatlar + meta veriler" }, { name: "scripts/", comment: "İsteğe bağlı: yürütülebilir kod" }, { name: "references/", comment: "İsteğe bağlı: belgeler" }, { name: "assets/", comment: "İsteğe bağlı: şablonlar, kaynaklar" }, ], }, ]} />

Beceri dizini, Codex'in iş akışının bir parçası olarak çağırdığı CLI betiklerini içeren bir scripts/ klasörü barındırabilir (örneğin başlangıç verisi sağlamak veya doğrulamalar çalıştırmak için). İş akışı harici sistemlere (sorun izleyiciler, tasarım araçları, belge sunucuları) ihtiyaç duyduğunda beceriyi MCP ile eşleştirin.

Örnek SKILL.md:

---
name: commit
description: Stage and commit changes in semantic groups. Use when the user wants to commit, organize commits, or clean up a branch before pushing.
---

1. Do not run `git add .`. Stage files in logical groups by purpose.
2. Group into separate commits: feat → test → docs → refactor → chore.
3. Write concise commit messages that match the change scope.
4. Keep each commit focused and reviewable.

Becerileri şunlar için kullanın:

• Tekrarlanabilir iş akışları (sürüm adımları, inceleme rutinleri, belge güncellemeleri)
• Ekibe özgü uzmanlık
• Örnekler, başvurular veya yardımcı betikler gerektiren prosedürler

Beceriler genel (geliştirici olarak sizin için kullanıcı dizininizde) veya depoya özgü (ekibiniz için .agents/skills içine kaydedilmiş) olabilir. İş akışı ilgili proje için geçerliyse depo becerilerini .agents/skills içine yerleştirin; tüm depolarda kullanmak istediğiniz beceriler için kullanıcı dizininizi kullanın.

Codex, beceriler için aşamalı açıklama kullanır:

• Keşif için meta verilerle (name, description) başlar
• SKILL.md dosyasını yalnızca bir beceri seçildiğinde yükler
• Başvuruları yalnızca gerektiğinde okur veya betikleri çalıştırır

Beceriler açıkça çağrılabilir; görev beceri açıklamasıyla eşleştiğinde Codex bunları örtük olarak da seçebilir. Açık beceri açıklamaları, tetikleme güvenilirliğini artırır.

Beceri oluşturma

MCP

MCP (Model Context Protocol), Codex'i harici araçlara ve bağlam sağlayıcılarına bağlamanın standart yoludur. Özellikle Figma, Linear, GitHub veya ekibinizin bağımlı olduğu şirket içi bilgi hizmetleri gibi uzaktan barındırılan sistemler için kullanışlıdır.

Codex; sorun izleyiciler, tasarım araçları, tarayıcılar veya paylaşılan belge sistemleri gibi yerel deponun dışında bulunan yeteneklere ihtiyaç duyduğunda MCP'yi kullanın.

Bunu düşünmenin bir yolu şöyledir:

• Ana bilgisayar: Codex
• İstemci: Codex içindeki MCP bağlantısı
• Sunucu: Harici araç veya bağlam sağlayıcısı

MCP sunucuları şunları sunabilir:

• Araçlar (eylemler)
• Kaynaklar (okunabilir veriler)
• İstemler (yeniden kullanılabilir istem şablonları)

Bu ayrım, güven ve yetenek sınırlarını değerlendirmenize yardımcı olur. Bazı sunucular esas olarak bağlam sağlarken diğerleri güçlü eylemler sunar.

Uygulamada MCP çoğu zaman becerilerle eşleştirildiğinde en yararlı hâle gelir:

• Bir beceri iş akışını tanımlar ve kullanılacak MCP araçlarını belirtir

Model Context Protocol

Alt ajanlar

Farklı rollere sahip farklı ajanlar oluşturabilir ve araçları farklı biçimlerde kullanmaları için onlara istem verebilirsiniz. Örneğin bir ajan belirli test komutlarını ve yapılandırmalarını çalıştırırken başka bir ajan hata ayıklama amacıyla üretim günlüklerini getiren MCP sunucularına sahip olabilir. Her alt ajan odağını korur ve işi için doğru araçları kullanır.

Alt ajanlar

Beceriler ve MCP'yi birlikte kullanma

Beceriler ve MCP birlikte kullanıldığında tüm parçalar birleşir: beceriler tekrarlanabilir iş akışlarını tanımlar, MCP ise bunları harici araçlara ve sistemlere bağlar. Bir beceri MCP'ye bağlıysa Codex'in onu otomatik olarak yükleyip bağlayabilmesi için bu bağımlılığı agents/openai.yaml içinde bildirin (bkz. Beceri oluşturma).

Sonraki adım

Şu sırayla ilerleyin:

1. Codex'in depo kurallarınıza uyması için AGENTS.md ile özel talimatları ayarlayın. Bu kuralları uygulamak için pre-commit hook'ları ve linter'lar ekleyin.
2. Yeniden kullanılabilir bir iş akışı zaten varsa bir eklenti yükleyin. Aksi takdirde bir beceri oluşturun ve paylaşmak istediğinizde bunu bir eklenti olarak paketleyin.
3. İş akışları harici sistemlere (Linear, GitHub, belge sunucuları, tasarım araçları) ihtiyaç duyduğunda MCP kullanın.
4. Gürültülü veya uzmanlık gerektiren görevleri alt ajanlara devretmeye hazır olduğunuzda Alt ajanları kullanın.