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/mobile/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 Mobile 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-mobile-screen 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, mağaza gönderimi 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` | Vazgeçilemez sınırlar: siz daha fazlasını onaylayana kadar yalnızca yerel çalışma, workspaceId kapsamı, yalnızca sunucuda kalan sırlar |
| `.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 altı Mobile becerisi |
| `docs/agent-security.md` | Kabul kontrol listesi — kimlik doğrulama, workspace ve izin kontrolleri, sansürlü günlükler |
| `docs/mobile-store-submission.md` | Mağaza sürümü çalıştırma kitabı — hesaplar, derlemeler, inceleme notları ve gönderim sırası |
| `.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 — sunucu öncelikli veriler, pakette gizli bilgi yok, çevrimdışı yalnızca ağ hatası geri dönüşü.
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-mobile-screen— bir ekranı, veri akışını ve çevrimdışı davranışını ekleyin veya değiştirinadding-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ü uygulamanıza getirinverify-changes— teslimattan önce doğru kontrolleri seçin ve çalıştırınwriting-unit-tests— yeni mantığı Vitest ile kapsayı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/mobile/src/ideas/index.md gibi bir yansıma belgesi, apps/mobile/src/ideas/index.tsnin 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 testleri gerçekten çalıştırdı — sonuç değil, komutu ve çıktısını isteyin.
- Sırlar yalnızca sunucuda kaldı — hiçbir yeni değer
NEXT_PUBLIC_veyaEXPO_PUBLIC_öneki taşımıyor ve hiçbir anahtar bir rapora veya commit'e yazılmadı. - Kullanıcıya ait her okuma ve yazma
workspaceIdile kapsamlandı — hiçbir sorgu tarayıcının gönderdiği bir kimliğe güvenmiyor. - Değişen her dosyanın
.ai/aynası kodla birlikte ilerledi. - Yayınlama, dağıtma ve ücretli sağlayıcı çağrıları sizin onayladığınız ayrı adımlar olarak kaldı — ajan asla kendi kendine birleştirmedi, göndermedi veya dağıtmadı.
- 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 Yerel kimlik doğrulama kılavuzunu okuyun.