Belgeler / Ajan

Bellek, skill'ler ve kurallar

Proje belleği, skill'ler, prompt'lar, hook'lar ve kurallarla ajana kalıcı bağlam verme ve ajanın hatalarından nasıl öğrendiği.

Ajan her konuşmada sıfırdan başlamaz. Projeyle ilgili önemli şeyleri hatırlar, göreve göre prosedürler yükler ve ekibinizin kurallarına uyar.

Her şey proje panelinin Ajan sekmesinde; Skills, Prompts, Hooks, Kurallar ve Yükle alt sekmeleriyle yönetilir. Üstte kapsamı seçersiniz: Platform (Yuli'nin ajanı) veya Abonelikler (Claude Code, Kiro, Codex ve Antigravity).

Proje belleği

Ajanın hatırlaması gerekenler: projenin yönergeleri, kararları, kuralları ve bilgileri.

  • Kaydetme: Sohbette «şunu hatırla…» deyin ya da elle ekleyin.
  • Görüntüleme ve düzenleme: sohbet başlığı → Diğer eylemler → Proje belleği.
  • Nerede durur: .ai/memory/ içinde, projeyle birlikte sürümlenebilir.
Grup Örnek
Yönergeler «Her zaman Java 17 örnekleriyle yanıt ver.»
Kararlar «Ödeme modülünde altıgen mimari kullanıyoruz.»
Kurallar «DTO'lar Dto ile biter ve api/dto içinde bulunur.»
Proje bilgileri «Yerel profil orders_dev veritabanını kullanır.»

Depoyla birlikte gelen girdiler «depodan — onaylanmadı» olarak görünür ve siz onaylayana kadar modele gönderilmez. Böylece yabancı bir depo ajana talimat veremez.

Ekip belleği

Ekibin paylaşılan belleği, projeyle birlikte sürümlenen .ai/team.json dosyasında bulunur. Genel seçenekler → Ekip bölümünden görüntülenir.

Skill'ler

Bir skill, ajanın yalnızca görev gerektirdiğinde yüklediği bir prosedürdür. Yuli 19 yerleşik skill ile gelir:

Alan Skill'ler
Kod Kodu açıkla, Özellik geliştir, Güvenli yeniden düzenleme, refactor-or-evolve
Testler Birim testleri yaz, Test stratejisi
Kalite ve inceleme Kod incelemesi, Güvenlik incelemesi, Entegrasyon incelemesi
Tanılama Kök nedene kadar hata ayıkla, Derleme hatalarını düzelt, gradle-java-build
Tasarım Gereksinim analizi, Mimari tasarım, ui-ux-design
Veri Veritabanı gezgini
Belgeler document-system (istek üzerine sistemi belgeleme), sdlc-documentation
Git Commit mesajı

Yerleşik skill'ler Salt okunur'dur ve uygulamayla birlikte güncellenir. Birini uyarlamak için Özelleştirmek için çoğalt seçeneğini kullanın.

Kendi skill'leriniz

Kendi skill'lerinizi Skills alt sekmesinde oluşturun ya da Skill, prompt ve hook içe aktar ile içe aktarın. Yuli SKILL.md, PROMPT.md, Claude Code komutları, Copilot .prompt.md dosyaları ve hooks.json kabul eder.

Skill'leriniz, prompt'larınız ve hook'larınız kullanıcı klasörünüzde (Windows'ta %APPDATA%\.yulicode\) saklanır; böylece tüm projelerinizde sizinle birlikte olur.

Nasıl birleşirler

Ajan yapılandırması içinde:

Mod Ne kullanır
Otomatik Yalnızca Yuli'ninkiler.
Özel Yalnızca sizinkiler.
Önerilen + benimkiler (varsayılan) Her ikisi. Bir ad çakışırsa sizinki geçerli olur.

Prompt'lar

Prompt'lar ajanın temel talimatlarıdır: kimlik, büyük görevlerin yaşam döngüsü, ekip lideri, alt ajan… Yuli bunları ayarlanmış olarak getirir. Çoğaltıp uyarlayabilirsiniz.

Dahili prompt'lar daha yüksek doğruluk ve daha az token için İngilizcedir. Yanıt her zaman yazan kişinin dilinde verilir.

Hook'lar

Bir hook, ajanın bir eylemini yakalar: örneğin değiştirileni biçimlendirmek veya bir öneriyi uygulamadan önce doğrulamak. Betikler Node.js'tir, olayı JSON olarak alır ve sıfırdan farklı bir çıkış kodu eylemi engeller. Engelleme nedeni, planını ayarlayabilmesi için ajana iletilir.

Olay Ne zaman
Bir araç kullanılmadan önce Her araçtan önce.
Bir araç kullanıldıktan sonra Her araçtan sonra.
Bir öneri bittiğinde Ajan bir değişikliği önermeyi bitirdiğinde.
Onaylamadan önce Siz onaylamadan önce.
Değişiklikler uygulandıktan sonra Değişiklik diske yazıldığında.

Yuli kullanıma hazır hook'lar içerir: Tehlikeli komutları engelle, Gizli bilgileri okuma, Hassas dosyaları koru, Kodda gizli bilgi yok, Çakışma işareti yok ve Devasa dosyalar yok.

Proje kuralları

Kurallar, ajanın o projede her zaman uyduğu talimatlardır.

Dosya Kapsam
Kökte .agentrules, yuli.md veya .cursorrules Projenin tamamı.
Bir alt klasörde .agentrules O klasör. En yakındaki dosya geçerli olur.
.ai/rules/*.md Ekip kuralları.

Kurallar alt sekmesinde: + .agentrules oluştur, Önerilen kurallar ve Paketi içe aktar (.zip).

Öğrenilen kurallar

Yuli tekrarlanan hatalardan öğrenir. Aynı bulgu 30 gün içinde en az 2 görevde 3 veya daha fazla kez göründüğünde .ai/rules/learned.md içinde bir kurala dönüşür.

Bunları Yönetişim Merkezi → Ajanlar → Öğrenme bölümünde inceleyin. Bir aday kuralı reddedebilirsiniz; yalnızca kanıtı iki katına çıkarsa yeniden önerilir.

Abonelik ajanınız için

Abonelikler kapsamında her ajanın, Yuli'nin ona verdiği kural dosyasını, durumunu ve «Yuli'nin ajana verdikleri»ni içeren bir bölümü vardır: oturum kuralları ve token maliyetiyle birlikte Yuli'nin her skill'i.