Ana içeriğe atla

Beceriler ve Araçlar

Paylaşılan beceriler .agents/skills/ içinde bulunur. Bu kaynakları düzenleyin, ardından Claude Code için .claude/skills/ dizinini üretmek üzere yarn ai-workflow:sync komutunu çalıştırın. Codex, becerileri doğrudan .agents/skills/ dizininde keşfeder.

Paylaşılan rol istemleri .agents/roles/*.md içinde bulunur. Bu, uygulamaların yerleşik olarak tanıdığı bir ajan keşif yolu değil, depoya özgü bir kaynak biçimidir. scripts/ai-workflow-files.mjs bu kaynakları aşağıdaki uygulamaya özgü dosyalara dönüştürür; yarn ai-workflow:sync bunları yazar. Yeni bir çalışma kopyasının önce bir üreteç çalıştırmaya gerek kalmadan yerleşik yapılandırmaya sahip olması için üretilen dosyaları kaynaklarıyla birlikte işleyin. Bir kaynağı kaldırdıktan sonra, ondan üretilmiş ve artık kullanılmayan çıktıları açıkça kaldırın; doğrulayıcı dosyaları sessizce silmek yerine bunları raporlar.

Yerleşik keşif yolları​

2026-09-12 tarihinde resmî belgelere göre doğrulandı:

UygulamaProje talimatlarıBu deponun kullandığı becerilerBu deponun kullandığı özel ajanlar
CodexAGENTS.md.agents/skills/<name>/SKILL.mdÜretilen .codex/agents/<name>.toml
Claude CodeCLAUDE.md, @AGENTS.md dosyasını içe aktarırÜretilen .claude/skills/<name>/SKILL.mdÜretilen .claude/agents/<name>.md

Kaynaklar: Codex becerileri, Codex alt ajanları, Claude belleği, Claude becerileri, Claude alt ajanları.

Yerleşik ajan dizinlerinin yerine .agents/roles kullanmayın ve Claude'un .agents/skills dizinini keşfettiğini varsaymayın. Claude orada başvurulan bir dosyayı yine de sıradan proje bağlamı olarak okuyabilir.

Yapay zekâ dizinleri, üretilen metin platformlar arasında aynı kalsın diye .gitattributes aracılığıyla LF satır sonları kullanır. Becerilere ait destekleyici varlıklar bayt bayt kopyalanır.

Beceriler​

BeceriAmaç
commitYetkilendirilmiş, kapsamı belirli yerel işlemeler oluşturur
commit-format, issue-formatİstendiğinde biçim önerileri sunar
make-closed-issueYetkilendirilmiş bir sorun kaydı, kapsamı belirli bir işleme ve PR oluşturur
review-and-merge-prPR geri bildirimlerini önceliklendirir; yalnızca istenen kapsam içinde düzeltir/yayımlar/birleştirir
fix-merge-conflictsÇakışmaları çözer ve birleştirilmiş sonucu doğrular
releaseSürüm metnini hazırlar ve yetkilendirilmiş sürüm adımlarını uygular
code-quality-reviewÖnemsiz olmayan diff'leri veya açıkça istenen bir kalite endişesini inceler
retroKanıtlanmış hataları, tekrarlanmalarını önleyen odaklı kontrollere veya yönergelere dönüştürür
refactor-pass, deslopMevcut değişikliklerde istenen temizlik
debug-agentKanıta dayalı hata ayıklama; gerektiğinde enstrümantasyonla
you-might-not-need-an-effectOdaklı efekt/memo incelemesi
vercel-react-best-practicesUygulanabilir React performans rehberliği; bu Vite istemcisi için Next.js/yalnızca sunucu kurallarını atlayın
translateÇeviriler üretir, ardından haritaları tek bir yazıcı üzerinden uygular
playwright-cli, inspect-elementsTarayıcı doğrulaması ve DOM'dan kaynağa eşleme
profile-browsingKapsamı belirli tarayıcı ve React profillemesi
test-apkSağlanan eşlikçi Android sarmalayıcısını doğrular
impeccable, improve-threejsKapsamı belirli arayüz tasarımı ve Three.js render incelemesi
implement-planİsteğe bağlı, sınırlı yetki devriyle bir planı uygular
readmeDoğrulanmış proje belgelerinin bakımını yapar
context7Sürüme uygun kütüphane belgelerini getirir
find-skillsAçıkça istendiğinde ek beceriler bulur

Roller ve modeller​

browser-check, profiler, test-apk, translator ve reviewer için özel rolleri koruyun. Sıradan uygulama geliştirme ve kod keşfi işleri için çalıştırma ortamının yerleşik worker/general-purpose veya explorer rolünü kullanın. Kabul ölçütlerini ve sahipliği üst ajan belirler; ağır kontrolleri tek bir sahip çalıştırır.

Codex ajan dosyaları name, description ve developer_instructions alanlarını içerir. .codex/config.toml, max_concurrent_threads_per_session ile eşzamanlı alt ajan sayısını dörtle sınırlar. Paylaşılan rol meta verisi adı, açıklamayı ve isteğe bağlı korumalı alan modunu içerir; bilerek hiçbir model alanı içermez.

Model ve akıl yürütme alanlarını depoya işlenmiş becerilere ve özel ajanlara eklemeyin. Bu, her uygulamanın belgelenmiş öncelik sırasına göre çalışma zamanındaki çağrı tercihlerine, kullanıcı varsayılanlarına ve üst ajandan devralmaya olanak tanır. Claude aile takma adları sürüm bakımını azaltır ama yine de bir aile seçer. Gerektiğinde bu tür seçimleri kullanıcı/oturum ayarlarında tutun. Devralma, mevcut en iyi modelin otomatik olarak seçileceğini vaat etmez. Bir latest takma adı uydurmayın veya rutin görevlere model kataloğu araştırması eklemeyin. Bkz. Codex seçimi ve Claude seçimi.

sandbox-mode: read-only, Codex'in korumalı alanına eşlenir. Claude'un araç listesi ve rol talimatları onun inceleme iş akışını kısıtlar, ancak Bash erişimi işletim sistemi düzeyinde bir korumalı alan değildir.

Paylaşılan beceri frontmatter'ı, uygun olduğu yerlerde kullanıcı tarafından çağrılan iş akışları için disable-model-invocation: true kullanır. Codex'teki karşılığı olan ayar agents/openai.yaml içinde policy.allow_implicit_invocation: false olarak bulunur; doğrulayıcı ikisini de zorunlu tutar. Çağrı meta verisi açık yetkilendirme kurallarını tamamlar; bir inceleme isteği, yalnızca bir beceri yayımlama adımları içerdiği için asla yayımlamaya yetki vermez.

Kontroller ve keşif​

  • yarn ai-workflow:sync, kurulu js-yaml ve smol-toml paketlerini kullanarak uyumluluk çıktılarını yeniden üretir.
  • yarn ai-workflow:check kaynakları/frontmatter'ı/yapılandırmaları ayrıştırır; üretilen çıktıları, çağrı meta verisini, model alanlarının yerleşimini ve yalnızca biçimlendirme yapan kanca bağlantısını kontrol eder. Model tanımlayıcılarını bir sağlayıcı kataloğuna göre çözümlemez.
  • yarn ai-workflow:test, kanca yükleri ve iş akışı üretimi/doğrulaması için yalıtılmış Node fixture'larını çalıştırır.
  • Bir ajan uygulamasını yükselttikten sonra beceri/rol keşfini o uygulamada doğrulayın. Sözdizimi/denklik kontrolleri bir yükleyici kontrolünün yerini tutmaz. Mevcut bir oturum eski kataloğu tutuyorsa uygulamayı yeniden yükleyin.
  • Kancalar, çalıştırma ortamının proje güvenini ve kanca incelemesini gerektirir; bir kontrolü geçirmek için güveni atlatmayın. Bkz. hooks-setup.md.

Yararlı talimatları sürdürmek​

OpenAI'ın beceriler ve istemler rehberini (2026-09-12'de incelendi) izleyin: açıklamaları kesin tutun, ayrıntıları yalnızca ilgili olduklarında yükleyin ve kullanıcının istediği kapsamı koruyun. Paylaşılan beceriler farklı modellere hizmet eder; rutin uygulama seçimlerine izin verirken projeye özgü değişmezleri koruyun.

Bir becerinin amacını, karar sınırlarını ve temel kısıtlarını SKILL.md içinde tutun. Kapsamlı, moda özgü komutları veya örnekleri isteğe bağlı başvurular olarak bağlayın. Kısa açıklamalarda tetikleme koşullarını başa koyun; eşleşen bir anahtar sözcük tek başına görevi genişletmemelidir. Davranışı bilinçli olarak değiştirilmedikçe mevcut çağrı meta verisini koruyun.

Kapsamlı bir talimat değişikliğinden sonra birkaç temsili küçük ve büyük isteği deneyin. Hangi becerilerin/başvuruların seçildiğini, eylemlerin kapsam içinde kalıp kalmadığını, doğrulamanın değişiklikle örtüşüp örtüşmediğini ve yetkilendirilmiş işin tamamlanıp tamamlanmadığını kontrol edin. Şema ve fixture testleri araçların doğruluğunu ortaya koyar, ajanın karar kalitesini değil.

Araçlar ve tarayıcı sahipliği​

Mevcut beceri/araç kataloğunu ve kurulu proje CLI'larını tercih edin. GitHub için gh, tarayıcı doğrulaması için playwright-cli, kütüphane davranışı önemli olduğunda da resmî/sürüme özgü belgeleri kullanın. Yinelenen beceriler kurmaktan veya yalnızca mevcut bir biçimlendiriciyi çalıştırmak için sabitlenmemiş bir paket indirmekten kaçının.

MCP yükü çalıştırma ortamına bağlıdır: ertelenmiş araç yükleme, her şemanın baştan yüklenmesini önleyebilir. MCP'yi başlı başına modası geçmiş saymak yerine entegrasyonları ilgili olanlarla sınırlı tutun. Mevcut CLI tercihleri yeniden üretilebilirlik ve kaynak denetimi açısından yararlı olmayı sürdürür.

Tüm tarayıcı oturumları, makine genelinde tek bir etkin tarayıcıyı zorunlu kılan ./scripts/pw-session.sh betiğini kullanır. Varsayılan olarak yeni ve yalıtılmış bir oturum açın. Kullanıcının mevcut kişisel tarayıcısına erişim açık yetkilendirme gerektirir; bu yetkilendirmeyi sonraki adımlarda yeniden kullanın. Tarayıcıları/görüntü alanlarını etkilenen davranışa göre seçin, seçilen motorları sırayla çalıştırın, temizlik sırasında tam adıyla belirtilen oturumu kapatın ve asla close-all/kill-all kullanmayın. Bkz. playwright-cli becerisi ve verification.md.