For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/desktop/agents.md (or send Accept: text/markdown).
Bir kodlama ajanıyla geliştirin
Kodlama aracısına görevler verin: okuduğu dosyalar, dahil edilen beceriler ve sizi kontrolde tutan inceleme.
Başlangıç seviyesinde izlenecek yol
Ön koşullar: aşağıdaki iki başlangıç kılavuzunu okuyun ve Desktop yerel kurulumunu tamamlayın. Bir kodlama aracısı, projenizi okuyan, dosyaları düzenleyen ve komutları çalıştıran bir AI aracıdır — Cursor, Claude Code, Devin veya benzeri bir asistan. Bu sayfadaki her şey hangi aracı kullanırsanız kullanın geçerlidir.
Kısa terimler: İstem, ajana yapıştırdığınız talimat metnidir. Diff, ajanın önerdiği dosya değişikliklerinin listesidir. Depo kökü, package.json'u içeren en üst klasördür — ajan her zaman oradan başlamalıdır.
1. Depo kökündeki .agents/skills/'i açın ve görevinize en yakın beceriyi kopyalayın — add-a-desktop-capability iyi bir ilk denemdir.
2. Bunu aracınıza yapıştırın ve değişikliğinizi açıklayın, ardından bir satır ekleyin: Koda dokunmadan önce llms.txt, sonra AGENTS.md, sonra .ai/PROJECT_CONTEXT.md'yi okuyun.
3. Ajanın düzenlemeye başlamadan önce değiştireceği dosyaları ve çalıştıracağı kontrolleri listelemesini isteyin. Bittiğinde diff'i gözden geçirin — ürününüzdeki gerçek değişiklikleri onaylıyorsunuz.
4. Yayınlama, kurulum programı sürümleri ve ücretli sağlayıcı çağrıları bir görev isteminin parçası asla olamaz. Açıkça onayladığınız ayrı adımlar olarak tutun.
Ajanınızın okuduğu dosyalar
Depo, yalnızca insanlar için değil ajanlar için de yazılmış küçük bir dosya yığınıyla gelir. Bu bağlamı asla elle yapıştırmazsınız — ajanı llms.txt'ye yönlendirin, gerisini kendisi okur.
Okuma sırası önemlidir: llms.txt haritadır, AGENTS.md sınırları belirler ve .ai/PROJECT_CONTEXT.md önceki oturumların öğrendiklerini taşır. Sınırları atlayan bir ajan, yayınlayamayacağınız kod üretir.
| Dosya | Ajana ne sağlar |
|---|---|
| `llms.txt` | Deponun giriş haritası, bu checkout'un gerçekten neler içerdiğini listelemek için oluşturuldu |
| `AGENTS.md` | Kabul edilemez sınırlar: daha fazlasını onaylayana kadar yalnızca yerel çalışma, kabuk asla ürün UI'sini çatallamaz |
| `.ai/PROJECT_CONTEXT.md` | Oturumlar arası bellek — son zamanlarda ne ve neden değişti; kod değişikliklerinden önce okunur |
| `.ai/` ayna belgeleri | Önemli dosyaların yanında eşleşen bir .ai/<path>.md notu; dosya başına kararları ve açık konuları kaydeder |
| `.agents/skills/` | Araçlar için yazılmış görev çalıştırma kitapları — aşağıda listelenen beş Desktop becerisi |
| `docs/agent-security.md` | Kabul kontrol listesi — kimlik doğrulama, workspace ve izin kontrolleri, sansürlü günlükler |
| `docs/desktop-updates.md` | Güncelleme kanalı çalıştırma kitabı — imza anahtarları, uç noktalar ve sürüm kanalları |
| `.env.example` | Eksiksiz ortam envanteri — ajan bu dosyada bulunmayan bir değişken adını asla uydurmaz |
Dahil edilen beceriler
.agents/skills/ altındaki her dosya tam bir brief'tir: yapıştırın veya aracının okumasına izin verin ve kitin kuralları onunla birlikte taşınır — ürün UI'si web uygulamasında kalır, yalnızca işletim sistemi davranışı Rust'a girer.
Yapıştırılabilir prompts/ kitaplığı yalnızca Web deposunda bulunur; bu checkout bunun yerine beceriler taşır. Gözetimsiz bir kurulum için agent-setup kılavuzundaki hazır istemi kullanın.
add-a-desktop-capability— pencere, tepsi, kısayol, güncelleme veya derleme değişiklikleriadding-a-dependency— bir npm bağımlılığını güvenli bir şekilde ekleyin, yükseltin veya taşıyınreviewing-a-pr— bir farkı doğruluk, workspace izolasyonu ve gizli bilgiler açısından inceleyinupgrading-from-upstream— daha yeni bir kit sürümünü kabuğunuza getirinverify-changes— teslimattan önce doğru kontrolleri seçin ve çalıştırın
Ajan oturumlar arasında nasıl hatırlıyor
Araçların oturumlar arasında belleği yoktur — .ai/ klasörü bellektir. .ai/PROJECT_CONTEXT.md, son zamanlarda neyin değiştiğini ve nedenini kaydeder. Yanında, .ai/apps/desktop/src-tauri/src/lib.md gibi bir yansıma belgesi, apps/desktop/src-tauri/src/lib.rs'nin arkasındaki kararları kodun tek başına gösteremediği şekilde açıklar.
Sözleşme basittir: bir dosyayı düzenlemeden önce aynasını okuyun ve değişiklik yerleştiğinde aynayı güncelleyin. Open Threads girdileri bitmemiş işleri kaydeder, böylece sonraki oturum baştan başlamak yerine kaldığı yerden devam eder. Güncelliğini yitirmiş bir ayna hiç olmamasından daha kötüdür — ajanın diff'ini incelerken, değişen dosyaların aynalarının da onunla birlikte güncellendiğini kontrol edin.
Ajanın işini dürüstçe gözden geçirin
Tamamlanmış bir görev özet değil, kanıttır. Ajanın çalışmasını saklamadan önce, docs/agent-security.md'nin bir dağıtımı denetlediği şekilde denetleyin:
Bir şeyler yanlışsa diff'i geri gönderin — ajan, başarısız kontrolü adlandırdığınızda kendi işini en hızlı şekilde düzeltir. Tek başına asla denememesi gereken bir şey için bunu bir kez açıkça söyleyin; sınır oturumun geri kalanında geçerli kalır.
- İddia ettiği kontrolleri çalıştırdı — cargo test, cargo check veya sürüm ön kontrolü — komut ve çıktısını isteyin, bir sonuç değil.
- Gizli bilgiler yalnızca sunucuda kaldı — hiçbir imza anahtarı veya sertifika bir raporda veya commit'te yazdırılmadı ve kabuk hâlâ sağlayıcı kimlik bilgileri taşımıyor.
- Ürün davranışı web uygulamasında kaldı — fark, Rust'ta paralel UI, kimlik doğrulama veya sohbet mantığı eklemez.
- Değişen her dosyanın
.ai/aynası kodla birlikte ilerledi. - Yayınlama, kurulum programı sürümleri ve ücretli sağlayıcı çağrıları onayladığınız ayrı adımlar olarak kaldı — aracı asla kendisi birleştirme, gönderme veya sürüm yapmadı.
- Bir adım iki kez başarısız olursa, etrafından dolaşmak yerine durup başarısız komutu bildirdi.
Kuruluma devam etmek için Masaüstü yayın hesapları oluşturun kılavuzunu okuyun.