cc-viewer 1.6.182 → 1.6.183

package/concepts/tr/Tool-NotebookEdit.md

@@ -1,33 +1,39 @@
 # NotebookEdit
 
-## Tanım
+Bir Jupyter notebook'undaki (`.ipynb`) tek bir hücreyi değiştirir. Notebook yapısının geri kalanını koruyarak bir hücrenin kaynağını değiştirmeyi, yeni bir hücre eklemeyi veya var olan bir hücreyi silmeyi destekler.
 
-Jupyter notebook (.ipynb dosyası) içindeki belirli bir hücreyi değiştirme, ekleme veya silme işlemi yapar.
+## Ne Zaman Kullanılır
+
+- Bir analiz notebook'undaki kod hücresini tüm dosyayı yeniden yazmadan düzeltmek veya güncellemek
+- Anlatıyı iyileştirmek veya belge eklemek için bir markdown hücresini değiştirmek
+- Var olan bir notebook'ta bilinen bir konuma yeni bir kod veya markdown hücresi eklemek
+- Aşağı akış hücreleri artık ona bağımlı olmasın diye eski veya bozuk bir hücreyi kaldırmak
+- Hücreler üzerinde tek tek yineleyerek yeniden üretilebilir bir notebook hazırlamak
 
 ## Parametreler
 
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `notebook_path` | string | Evet | Notebook dosyasının mutlak yolu |
-| `new_source` | string | Evet | Hücrenin yeni içeriği |
-| `cell_id` | string | Hayır | Düzenlenecek hücre ID'si. Ekleme modunda yeni hücre bu ID'den sonra eklenir |
-| `cell_type` | enum | Hayır | Hücre türü: `code` veya `markdown`. Ekleme modunda zorunludur |
-| `edit_mode` | enum | Hayır | Düzenleme modu: `replace` (varsayılan), `insert`, `delete` |
+- `notebook_path` (string, zorunlu): `.ipynb` dosyasının mutlak yolu. Göreceli yollar reddedilir.
+- `new_source` (string, zorunlu): Yeni hücre kaynağı. `replace` ve `insert` için hücre gövdesi olur; `delete` için yok sayılır ancak şema tarafından hala gereklidir.
+- `cell_id` (string, opsiyonel): Hedef hücrenin ID'si. `replace` ve `delete` modlarında, araç bu hücre üzerinde çalışır. `insert` modunda, yeni hücre bu ID'ye sahip hücrenin hemen ardından eklenir; notebook'un başına eklemek için atlayın.
+- `cell_type` (enum, opsiyonel): `code` veya `markdown`. `edit_mode` `insert` olduğunda gereklidir. `replace` sırasında atlandığında, mevcut hücrenin türü korunur.
+- `edit_mode` (enum, opsiyonel): `replace` (varsayılan), `insert` veya `delete`.
 
-## Kullanım Senaryoları
+## Örnekler
 
-**Kullanıma uygun:**
-- Jupyter notebook'taki kod veya markdown hücrelerini değiştirme
-- Notebook'a yeni hücre ekleme
-- Notebook'tan hücre silme
+### Örnek 1: Hatalı bir kod hücresini değiştirmek
+`notebook_path`'i mutlak yola, `cell_id`'i hedef hücrenin ID'sine ve `new_source`'u düzeltilmiş Python kodunu içerecek şekilde ayarlayarak `NotebookEdit`'i çağırın. `edit_mode`'u varsayılan `replace`'te bırakın.
 
-## Dikkat Edilecekler
+### Örnek 2: Markdown açıklaması eklemek
+Var olan bir `setup` hücresinden hemen sonra markdown hücresi eklemek için `edit_mode: "insert"`, `cell_type: "markdown"`, `cell_id`'i setup hücresinin ID'sine ayarlayın ve anlatıyı `new_source`'a koyun.
 
-- `cell_number` 0 indekslidir
-- `insert` modu belirtilen konuma yeni hücre ekler
-- `delete` modu belirtilen konumdaki hücreyi siler
-- Yol mutlak yol olmalıdır
+### Örnek 3: Eski bir hücreyi silmek
+`edit_mode: "delete"` olarak ayarlayın ve kaldırılacak hücrenin `cell_id`'sini sağlayın. `new_source` için herhangi bir string sağlayın; uygulanmaz.
 
-## Orijinal Metin
+## Notlar
 
-<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>
+- Her zaman mutlak bir yol geçirin. `NotebookEdit` göreceli yolları çalışma dizinine göre çözmez.
+- Araç yalnızca hedeflenen hücreyi yeniden yazar; ilgisiz hücrelerin yürütme sayıları, çıktıları ve meta verileri dokunulmamış kalır.
+- `cell_id` olmadan eklemek, yeni hücreyi notebook'un en başına yerleştirir.
+- `cell_type` eklemeler için zorunludur. Değiştirmeler için, bir kod hücresini markdown'a veya tam tersine dönüştürmek istemediğiniz sürece atlayın.
+- Hücreleri incelemek ve ID'lerini almak için önce notebook'ta `Read` aracını kullanın; hücreleri içerikleri ve çıktılarıyla birlikte döndürür.
+- Düz kaynak dosyaları için normal `Edit` kullanın; `NotebookEdit` `.ipynb` JSON'a özgüdür ve hücre yapısını anlar.

package/concepts/tr/Tool-PushNotification.md

@@ -0,0 +1,48 @@
+# PushNotification
+
+Geçerli Claude Code oturumundan masaüstü bildirimi gönderir. Remote Control bağlıysa bildirim kullanıcının telefonuna da iletilir ve ne yapıyor olurlarsa olsunlar dikkatlerini oturuma geri çeker.
+
+## Ne Zaman Kullanılır
+
+- Kullanıcı muhtemelen terminalden uzaktayken uzun süreli bir görev tamamlandığında
+- Bir derleme, test çalıştırması veya dağıtım tamamlandığında ve sonuç incelemeye hazır olduğunda
+- Devam etmeden önce kullanıcı girdisi gerektiren bir karar noktasına ulaşıldığında
+- Özerk olarak çözülemeyen bir hata veya engelleyici ortaya çıktığında
+- Kullanıcı belirli bir görev veya koşul karşılandığında bildirim almak istediğini açıkça belirttiğinde
+
+## Ne Zaman Kullanılmaz
+
+Görev sırasında rutin ilerleme güncellemeleri için ya da kullanıcının açıkça yeni sorduğu ve beklediği bir soruyu cevapladığınızı onaylamak için bildirim göndermeyin. Kısa bir görev tamamlandığında bildirim göndermeyin — kullanıcı görevi yeni göndermiş ve bekliyorsa bildirim bir değer katmaz ve gelecekteki bildirimlere olan güveni zayıflatır. Kesinlikle göndermeme yönünde eğilin.
+
+## Parametreler
+
+- `message` (dize, zorunlu): bildirim gövdesi. 200 karakterin altında tutun; mobil işletim sistemleri daha uzun dizeleri keser. Kullanıcının harekete geçeceği içerikle başlayın: "build failed: 2 auth tests", "task complete" ifadesinden çok daha kullanışlıdır.
+- `status` (dize, zorunlu): her zaman `"proactive"` olarak ayarlayın. Bu sabit bir işaretleyicidir ve değişmez.
+
+## Örnekler
+
+### Örnek 1: Uzun bir analizin tamamlanmasında bildirim gönderme
+
+Depo genelinde bir bağımlılık denetimi talep edildi ve çalışması birkaç dakika sürdü. Kullanıcı uzaklaştı. Rapor hazır olduğunda:
+
+```
+message: "Bağımlılık denetimi tamamlandı: lodash, axios, jsonwebtoken'da 3 yüksek öncelikli CVE bulundu. Rapor: audit-report.txt"
+status: "proactive"
+```
+
+### Örnek 2: Özerk çalışma sırasında karar noktasını işaretleme
+
+Çok adımlı bir yeniden yapılandırma sırasında iki modülün çakışan arayüzlere sahip olduğu ve tasarım kararı alınmadan birleştirilemeyeceği keşfedilir:
+
+```
+message: "Yeniden yapılandırma durduruldu: AuthService ve UserService'in çakışan token arayüzleri var. Devam etmeden önce kararınız gerekiyor."
+status: "proactive"
+```
+
+## Notlar
+
+- Kesinlikle **göndermeme** yönünde eğilin. Bildirim, kullanıcının ne yaptığından bağımsız olarak onları kesintiye uğratır. Bunu, bilginin değeriyle gerekçelendirilmesi gereken bir maliyet olarak değerlendirin.
+- Harekete geçirilebilir içerikle başlayın. İlk kelimeler kullanıcıya ne olduğunu ve varsa ne yapmaları gerektiğini söylemelidir — genel bir durum etiketi değil.
+- `message`'ı 200 karakterin altında tutun. Mobil işletim sistemleri daha uzun dizeleri keser ve en önemli kısım sonda yer alıyorsa onu çıkarabilir.
+- Sonuç, Remote Control bağlı olmadığı için push gönderilmediğini gösteriyorsa bu beklenen bir davranıştır. Yeniden deneme veya ek işlem gerekmez; yerel masaüstü bildirimi yine de tetiklenir.
+- Bildirim israfından kaçının. Küçük olaylar için sık sık bildirim gönderilirse kullanıcı bunları görmezden gelmeye başlar. Bu aracı, kullanıcının uzaklaştığına dair gerçek bir olasılık olduğu ve sonucu şimdi öğrenmek isteyeceği anlara saklayın.

package/concepts/tr/Tool-Read.md

@@ -1,56 +1,41 @@
 # Read
 
-## Tanım
+Yerel dosya sisteminden tek bir dosyanın içeriğini yükler. Düz metin, kaynak kodu, görüntüler, PDF'ler ve Jupyter notebook'larını destekler ve sonuçları `cat -n` stilinde 1 tabanlı satır numaralarıyla döndürür.
 
-Yerel dosya sisteminden dosya içeriğini okur. Metin dosyaları, resimler, PDF ve Jupyter notebook destekler.
+## Ne Zaman Kullanılır
+
+- Düzenleme veya analiz öncesinde bilinen bir yoldaki bir kaynak dosyasını okumak
+- Yapılandırma dosyalarını, lockfile'ları, günlükleri veya üretilen eserleri incelemek
+- Kullanıcının konuşmaya yapıştırdığı ekran görüntülerini veya diyagramları görüntülemek
+- Uzun bir PDF kılavuzundan belirli bir sayfa aralığını çıkarmak
+- Kod hücrelerini, markdown'u ve hücre çıktılarını birlikte gözden geçirmek için bir `.ipynb` notebook'unu açmak
 
 ## Parametreler
 
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `file_path` | string | Evet | Dosyanın mutlak yolu |
-| `offset` | number | Hayır | Başlangıç satır numarası (büyük dosyalar için parçalı okuma) |
-| `limit` | number | Hayır | Okunacak satır sayısı (büyük dosyalar için parçalı okuma) |
-| `pages` | string | Hayır | PDF sayfa aralığı (örn. "1-5", "3", "10-20"), yalnızca PDF için |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Kod dosyaları, yapılandırma dosyaları gibi metin dosyalarını okuma
-- Resim dosyalarını görüntüleme (Claude çok modlu bir modeldir)
-- PDF belgeleri okuma
-- Jupyter notebook okuma (tüm hücreleri ve çıktıları döndürür)
-- Bağlam elde etmek için birden fazla dosyayı paralel okuma
-
-**Kullanıma uygun değil:**
-- Dizin okuma — Bash'in `ls` komutu kullanılmalıdır
-- Açık uçlu kod tabanı keşfi — Task (Explore türü) kullanılmalıdır
-
-## Dikkat Edilecekler
-
-- Yol mutlak yol olmalıdır, göreli yol kullanılamaz
-- Varsayılan olarak dosyanın ilk 2000 satırını okur
-- 2000 karakteri aşan satırlar kesilir
-- Çıktı `cat -n` formatında, satır numaraları 1'den başlar
-- Büyük PDF'ler (10 sayfadan fazla) için `pages` parametresi belirtilmelidir, her seferinde en fazla 20 sayfa
-- Var olmayan bir dosyayı okumak hata döndürür (çökmez)
-- Tek mesajda birden fazla Read paralel olarak çağrılabilir
-
-## Orijinal Metin
-
-<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
-Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
-
-Usage:
-- The file_path parameter must be an absolute path, not a relative path
-- By default, it reads up to 2000 lines starting from the beginning of the file
-- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
-- Any lines longer than 2000 characters will be truncated
-- Results are returned using cat -n format, with line numbers starting at 1
-- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
-- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
-- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
-- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
-- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
-- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
-- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>
+- `file_path` (string, zorunlu): Hedef dosyanın mutlak yolu. Göreceli yollar reddedilir.
+- `offset` (integer, opsiyonel): Okumaya başlanacak 1 tabanlı satır numarası. `limit` ile eşleştirildiğinde büyük dosyalar için kullanışlıdır.
+- `limit` (integer, opsiyonel): `offset`'ten başlayarak döndürülecek maksimum satır sayısı. Atlandığında dosyanın üstünden varsayılan olarak 2000 satır.
+- `pages` (string, opsiyonel): PDF dosyaları için sayfa aralığı, örneğin `"1-5"`, `"3"` veya `"10-20"`. 10 sayfadan uzun PDF'ler için gereklidir; istek başına maksimum 20 sayfa.
+
+## Örnekler
+
+### Örnek 1: Küçük bir dosyanın tamamını okumak
+`Read`'i yalnızca `file_path` `/Users/me/project/src/index.ts` olarak ayarlanmış şekilde çağırın. Satır numaralarıyla birlikte 2000 satıra kadar döndürülür, bu genellikle düzenleme bağlamı için yeterlidir.
+
+### Örnek 2: Uzun bir günlüğü sayfa sayfa görüntülemek
+Bağlam tokenlarını israf etmeden dar bir pencere almak için birkaç bin satırlık bir günlük dosyasında `offset: 5001` ve `limit: 500` kullanın.
+
+### Örnek 3: Belirli PDF sayfalarını çıkarmak
+`/tmp/spec.pdf`'teki 120 sayfalık bir PDF için, yalnızca ihtiyacınız olan bölümü almak için `pages: "8-15"` ayarlayın. Büyük bir PDF'de `pages`'i atlamak hata üretir.
+
+### Örnek 4: Bir görüntü görüntülemek
+PNG veya JPG ekran görüntüsünün mutlak yolunu geçirin. Görüntü görsel olarak işlenir, böylece Claude Code onun üzerinde doğrudan akıl yürütebilir.
+
+## Notlar
+
+- Her zaman mutlak yolları tercih edin. Kullanıcı bir tane sağlıyorsa, olduğu gibi güvenin.
+- 2000 karakterden uzun satırlar kesilir; aşırı geniş veriler için döndürülen içeriği olası kırpılmış olarak değerlendirin.
+- Birden fazla bağımsız dosya okuyor musunuz? Paralel çalışmaları için aynı yanıtta birkaç `Read` çağrısı yayınlayın.
+- `Read` dizinleri listeleyemez. Bunun yerine `Bash` `ls` çağrısı veya `Glob` aracı kullanın.
+- Var olan ancak boş bir dosyayı okumak dosya baytları yerine bir sistem hatırlatıcısı döndürür, bu yüzden bu sinyali açıkça yönetin.
+- Mevcut oturumda aynı dosyada `Edit` kullanabilmek için önce başarılı bir `Read` gereklidir.

package/concepts/tr/Tool-RemoteTrigger.md

@@ -0,0 +1,73 @@
+# RemoteTrigger
+
+Zamanlanmış görevleri ve isteğe bağlı tetikleyici yürütmelerini yönetmek için claude.ai uzak tetikleyici API'sini çağırır. OAuth jetonu araç tarafından dahili olarak işlenir ve modele veya kabuğa hiçbir zaman açık değildir.
+
+## Ne Zaman Kullanılır
+
+- Mevcut tetikleyicileri listeleme, inceleme ve güncelleme dahil olmak üzere claude.ai'daki uzak ajanları (tetikleyicileri) yönetme
+- Tekrarlayan bir takvime göre Claude ajanını çalıştıran yeni bir cron tabanlı otomatik görev oluşturma
+- Mevcut bir tetikleyiciyi bir sonraki zamanlanmış çalıştırmasını beklemeden isteğe bağlı olarak tetikleme
+- Yapılandırmalarını ve durumlarını incelemek için mevcut tüm tetikleyicileri listeleme veya denetleme
+- Tetikleyiciyi yeniden oluşturmak zorunda kalmadan zamanlama, yük veya açıklama gibi tetikleyici ayarlarını güncelleme
+
+## Parametreler
+
+- `action` (string, zorunlu): gerçekleştirilecek işlem — `list`, `get`, `create`, `update` veya `run` değerlerinden biri
+- `trigger_id` (string, `get`, `update` ve `run` için zorunlu): işlem yapılacak tetikleyicinin tanımlayıcısı; `^[\w-]+$` desenine uymalıdır (yalnızca sözcük karakterleri ve tire işaretleri)
+- `body` (object, `create` ve `update` için zorunlu; `run` için isteğe bağlı): API'ye gönderilen istek yükü
+
+## Örnekler
+
+### Örnek 1: tüm tetikleyicileri listele
+
+```json
+{
+  "action": "list"
+}
+```
+
+`GET /v1/code/triggers` çağrısını yapar ve kimliği doğrulanmış hesapla ilişkili tüm tetikleyicilerin JSON dizisini döndürür.
+
+### Örnek 2: her hafta içi sabahı çalışan yeni bir tetikleyici oluştur
+
+```json
+{
+  "action": "create",
+  "body": {
+    "name": "weekday-morning-report",
+    "schedule": "0 8 * * 1-5",
+    "description": "Her hafta içi UTC 08:00'de günlük özet oluştur"
+  }
+}
+```
+
+Sağlanan gövdeyle `POST /v1/code/triggers` çağrısını yapar ve atanan `trigger_id` dahil yeni oluşturulan tetikleyici nesnesini döndürür.
+
+### Örnek 3: bir tetikleyiciyi isteğe bağlı olarak çalıştır
+
+```json
+{
+  "action": "run",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Zamanlanmış saati atlayarak `POST /v1/code/triggers/my-report-trigger/run` çağrısını hemen yapar.
+
+### Örnek 4: tek bir tetikleyici getir
+
+```json
+{
+  "action": "get",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+`GET /v1/code/triggers/my-report-trigger` çağrısını yapar ve tam tetikleyici yapılandırmasını döndürür.
+
+## Notlar
+
+- OAuth jetonu araç tarafından işlem içinde enjekte edilir — jetonları hiçbir zaman manuel olarak kopyalamayın, yapıştırmayın veya kaydetmeyin; bunu yapmak güvenlik riski oluşturur ve bu aracı kullanırken gereksizdir.
+- Tüm tetikleyici API çağrıları için ham `curl` veya diğer HTTP istemcileri yerine bu aracı tercih edin; doğrudan HTTP kullanımı güvenli jeton enjeksiyonunu atlar ve kimlik bilgilerini açığa çıkarabilir.
+- Araç, API'den ham JSON yanıtını döndürür; çağıran taraf yanıtı ayrıştırmaktan ve hata durum kodlarını işlemekten sorumludur.
+- `trigger_id` değeri `^[\w-]+$` deseniyle eşleşmelidir — yalnızca alfanümerik karakterlere, alt çizgilere ve tirelere izin verilir; boşluklar veya özel karakterler isteğin başarısız olmasına neden olur.

package/concepts/tr/Tool-ScheduleWakeup.md

@@ -0,0 +1,56 @@
+# ScheduleWakeup
+
+`/loop` dinamik modunda çalışmanın ne zaman devam edeceğini zamanlar. Bu araç, Claude'un seçilen aralık boyunca uyuyarak ve ardından aynı döngü istemiyle yeniden tetiklenerek görev yinelemelerinin temposunu özerk biçimde yönetmesine olanak tanır.
+
+## Ne Zaman Kullanılır
+
+- Yineleme aralığının sabit bir saate değil, çalışma durumuna bağlı olduğu `/loop` dinamik görevlerinde tempoyu özerk biçimde yönetmek için
+- Sonuçları kontrol etmeden önce uzun bir derleme, dağıtım veya test çalıştırmasının tamamlanmasını beklemek için
+- Şu anda izlenecek belirli bir sinyal olmadığında yinelemeler arasına boşta tik eklemek için
+- Kullanıcı istemi olmadan özerk bir döngü çalıştırmak için — `prompt` olarak değişmez sentinel `<<autonomous-loop-dynamic>>` geçirin
+- Durumu yakında değişecek bir süreci yoklamak için (önbelleği sıcak tutmak üzere kısa bir gecikme kullanın)
+
+## Parametreler
+
+- `delaySeconds` (sayı, gerekli): Devam edene kadar geçecek saniye sayısı. Çalışma zamanı değeri otomatik olarak `[60, 3600]` ile sınırlandırır; bu nedenle manuel sınırlandırma gerekmez.
+- `reason` (dize, gerekli): Seçilen gecikmeyi açıklayan kısa bir cümle. Kullanıcıya gösterilir ve telemetride kaydedilir. Somut olun — "uzun bun derlemesi kontrol ediliyor" "bekleniyor" ifadesinden daha kullanışlıdır.
+- `prompt` (dize, gerekli): Uyanışta tetiklenecek `/loop` girdisi. Sonraki tetiklemenin görevi tekrarlaması için her turda aynı dizeyi geçirin. Kullanıcı istemi olmayan özerk bir döngü için değişmez sentinel `<<autonomous-loop-dynamic>>` geçirin.
+
+## Örnekler
+
+### Örnek 1: hızla değişen bir sinyali yeniden kontrol etmek için kısa gecikme (önbelleği sıcak tutun)
+
+Derleme yeni başlatıldı ve genellikle iki ila üç dakikada tamamlanıyor.
+
+```json
+{
+  "delaySeconds": 120,
+  "reason": "~2 dakikada tamamlanması beklenen bun derlemesi kontrol ediliyor",
+  "prompt": "derleme durumunu kontrol et ve hataları raporla"
+}
+```
+
+120 saniye, konuşma bağlamını Anthropic istem önbelleğinde tutar (TTL 5 dk), bu nedenle sonraki uyanış daha hızlı ve daha ucuzdur.
+
+### Örnek 2: uzun boşta tik (önbellek kaçırmasını kabul et, daha uzun bekleme süresine yay)
+
+Bir veritabanı geçişi çalışıyor ve genellikle 20–40 dakika sürüyor.
+
+```json
+{
+  "delaySeconds": 1200,
+  "reason": "geçiş genellikle 20–40 dk sürer; 20 dk sonra tekrar kontrol",
+  "prompt": "geçiş durumunu kontrol et ve tamamlandıysa devam et"
+}
+```
+
+Uyanışta önbellek soğuk olacak, ancak 20 dakikalık bekleme tek bir önbellek kaçırmasının maliyetini fazlasıyla karşılar. Her 5 dakikada bir yoklama yapmak, hiçbir fayda sağlamadan aynı kaçırma maliyetini 4 kez ödeyecektir.
+
+## Notlar
+
+- **5 dakikalık önbellek TTL'si**: Anthropic istem önbelleği 300 saniye sonra sona erer. 300 saniyenin altındaki gecikmeler bağlamı sıcak tutar; 300 saniyenin üzerindeki gecikmeler sonraki uyanışta önbellek kaçırmasına neden olur.
+- **Tam olarak 300 saniyeden kaçının**: Bu her iki dünyanın da en kötüsüdür — anlamlı biçimde daha uzun bir bekleme süresi elde etmeden önbellek kaçırması maliyetini ödersiniz. Ya 270 saniyeye düşürün (önbelleği sıcak tutun) ya da 1200 saniye veya daha fazlasına commit yapın (tek bir kaçırma çok daha uzun bir bekleme süresi satın alır).
+- **Boşta tikler için varsayılan**: İzlenecek belirli bir sinyal olmadığında **1200–1800 saniye** (20–30 dk) kullanın. Bu, döngünün periyodik olarak kontrol etmesini sağlarken önbelleği hiçbir neden olmaksızın saatte 12 kez yakmaz.
+- **Otomatik sınırlandırma**: Çalışma zamanı `delaySeconds` değerini `[60, 3600]` ile sınırlandırır. 60'ın altındaki değerler 60 olur; 3600'ün üzerindeki değerler 3600 olur. Bu sınırları kendiniz yönetmeniz gerekmez.
+- **Döngüyü sonlandırmak için çağrıyı atlayın**: Yinelemeleri durdurmak istiyorsanız ScheduleWakeup'ı çağırmayın. Çağrıyı atlamak döngüyü sonlandırır.
+- **Her turda aynı `prompt`'u geçin**: `prompt` alanı, sonraki uyanışın hangi göreve devam edeceğini bilmesi için her çağrıda orijinal `/loop` talimatını taşımalıdır.

package/concepts/tr/Tool-SendMessage.md

@@ -1,41 +1,68 @@
 # SendMessage
 
-## Tanım
+Aktif bir ekip içinde bir ekip üyesinden diğerine bir mesaj iletir veya aynı anda tüm ekip arkadaşlarına yayın yapar. Ekip arkadaşlarının duyabildiği tek kanal budur — normal metin çıktısına yazılanlar onlara görünmez.
 
-Bir takım içindeki agent'lar arasında mesaj gönderir. Doğrudan iletişim, yayın ve protokol mesajları (kapatma istekleri/yanıtları, plan onayı) için kullanılır.
+## Ne Zaman Kullanılır
+
+- Ekip iş birliği sırasında bir görevi atamak veya bir alt problemi isimlendirilmiş bir ekip arkadaşına devretmek.
+- Başka bir ajandan durum, ara bulgular veya bir kod incelemesi talep etmek.
+- Tüm ekibe `*` aracılığıyla bir karar, paylaşılan kısıt veya kapatma duyurusu yayınlamak.
+- Ekip lideri tarafından gelen bir kapatma isteği veya plan onay isteği gibi bir protokol istemine yanıt vermek.
+- Devredilmiş bir görevin sonunda döngüyü kapatmak, böylece lider öğeyi tamamlanmış olarak işaretleyebilir.
 
 ## Parametreler
 
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `to` | string | Evet | Alıcı: takım üyesinin adı veya `"*"` ile herkese yayın |
-| `message` | string / object | Evet | Düz metin mesajı veya yapılandırılmış protokol nesnesi |
-| `summary` | string | Hayır | Arayüzde gösterilen 5-10 kelimelik önizleme |
+- `to` (string, zorunlu): Ekipte kayıtlı hedef ekip arkadaşının `name`'i veya aynı anda tüm ekip arkadaşlarına yayın yapmak için `*`.
+- `message` (string veya nesne, zorunlu): Normal iletişim için düz metin veya `shutdown_response` ve `plan_approval_response` gibi protokol yanıtları için yapılandırılmış bir nesne.
+- `summary` (string, opsiyonel): Düz metin mesajları için ekip etkinlik günlüğünde gösterilen 5-10 kelimelik bir önizleme. Uzun string mesajlar için gereklidir; `message` bir protokol nesnesi olduğunda yok sayılır.
+
+## Örnekler
+
+### Örnek 1: Doğrudan görev devri
+
+```
+SendMessage(
+  to="db-lead",
+  message="Please audit prisma/schema.prisma and list any model missing createdAt/updatedAt timestamps. Reply when done.",
+  summary="Audit schema for missing timestamps"
+)
+```
 
-## Mesaj Türleri
+### Örnek 2: Paylaşılan bir kısıtı yayınlama
 
-### Düz Metin
-Takım üyeleri arasında koordinasyon, durum güncellemeleri ve görev tartışmaları için doğrudan mesajlar.
+```
+SendMessage(
+  to="*",
+  message="Reminder: do not touch files under legacy/ — that subtree is frozen until the migration PR lands.",
+  summary="Freeze legacy/ during migration"
+)
+```
 
-### Kapatma İsteği
-Bir takım üyesinden düzenli şekilde kapanmasını ister: `{ type: "shutdown_request", reason: "..." }`
+### Örnek 3: Protokol yanıtı
 
-### Kapatma Yanıtı
-Takım üyesi kapatmayı onaylar veya reddeder: `{ type: "shutdown_response", approve: true/false }`
+Liderden gelen bir kapatma isteğine yapılandırılmış bir mesajla yanıt verin:
 
-### Plan Onay Yanıtı
-Bir takım üyesinin planını onaylar veya reddeder: `{ type: "plan_approval_response", approve: true/false }`
+```
+SendMessage(
+  to="leader",
+  message={ "type": "shutdown_response", "ready": true, "final_report": "All assigned diff chunks committed on branch refactor-crew/db-lead." }
+)
+```
 
-## Yayın vs. Doğrudan
+### Örnek 4: Plan onay yanıtı
 
-- **Doğrudan** (`to: "üye-adı"`): Belirli bir takım üyesine gönder — çoğu iletişim için tercih edilir
-- **Yayın** (`to: "*"`): Tüm takım üyelerine gönder — dikkatli kullanın, yalnızca kritik takım çapında duyurular için
+```
+SendMessage(
+  to="leader",
+  message={ "type": "plan_approval_response", "approved": true, "notes": "LGTM, but please split step 4 into migration + backfill." }
+)
+```
 
-## İlgili Araçlar
+## Notlar
 
-| Araç | Amaç |
-|------|------|
-| `TeamCreate` | Yeni bir takım oluştur |
-| `TeamDelete` | Tamamlandığında takımı kaldır |
-| `Agent` | Takıma katılan takım üyelerini başlat |
-| `TaskCreate` / `TaskUpdate` / `TaskList` | Paylaşılan görev listesini yönet |
+- Normal asistan metin çıktınız ekip arkadaşlarına iletilMEZ. Başka bir ajanın bir şeyi görmesini istiyorsanız, `SendMessage` üzerinden geçmelidir. Bu, ekip iş akışlarındaki en yaygın hatadır.
+- Yayın (`to: "*"`) pahalıdır — tüm ekip arkadaşlarını uyandırır ve bağlamlarını tüketir. Bunu gerçekten herkesi etkileyen duyurular için saklayın. Hedefli göndermeleri tercih edin.
+- Mesajları özlü ve eyleme yönelik tutun. Alıcının ihtiyaç duyduğu dosya yollarını, kısıtları ve beklenen yanıt formatını dahil edin; sizinle paylaşılan bellekleri olmadığını unutmayın.
+- Protokol mesaj nesnelerinin (`shutdown_response`, `plan_approval_response`) sabit şekilleri vardır. Protokol alanlarını düz metin mesajlarıyla veya tersini karıştırmayın.
+- Mesajlar eş zamansızdır. Alıcı sizinkini bir sonraki turunda alacaktır; onların yanıt verene kadar sizinkini okuduklarını veya buna göre hareket ettiklerini varsaymayın.
+- İyi yazılmış bir `summary` ekip etkinlik günlüğünü lider için taranabilir kılar — onu bir commit konu satırı gibi ele alın.

package/concepts/tr/Tool-Skill.md

@@ -1,56 +1,47 @@
 # Skill
 
-## Tanım
+Mevcut konuşmanın içinde isimlendirilmiş bir skill çağırır. Skill'ler, harness'in sistem hatırlatıcıları aracılığıyla asistana sunduğu önceden paketlenmiş yetenek paketleridir — alan bilgisi, iş akışları ve bazen araç erişimi.
 
-Ana konuşmada bir beceri (skill) çalıştırır. Beceriler, kullanıcının slash command (örn. `/commit`, `/review-pr`) aracılığıyla çağırabileceği özel yeteneklerdir.
+## Ne Zaman Kullanılır
 
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `skill` | string | Evet | Beceri adı (örn. "commit", "review-pr", "pdf") |
-| `args` | string | Hayır | Beceri parametreleri |
+- Kullanıcı `/review` veya `/init` gibi bir slash komutu yazar — slash komutları skill'lerdir ve bu araç üzerinden yürütülmelidir.
+- Kullanıcı, reklamı yapılan bir skill'in tetik koşullarıyla eşleşen bir görevi tanımlar (örneğin, tekrarlanan izin istemleri için transkriptleri taramayı istemek `fewer-permission-prompts` ile eşleşir).
+- Bir skill'in belirtilen amacı, mevcut dosya, istek veya konuşma bağlamıyla doğrudan eşleşir.
+- Özelleşmiş, tekrarlanabilir iş akışları skill olarak mevcuttur ve standart prosedür ad-hoc bir yaklaşıma tercih edilir.
+- Kullanıcı "hangi skill'ler mevcut" diye sorar — reklamı yapılan adları listeleyin ve yalnızca onaylarlarsa çağırın.
 
-## Kullanım Senaryoları
+## Parametreler
 
-**Kullanıma uygun:**
-- Kullanıcı `/<skill-name>` formatında slash command girdiğinde
-- Kullanıcının isteği kayıtlı bir becerinin işlevselliğiyle eşleştiğinde
+- `skill` (string, zorunlu): Mevcut available-skills sistem hatırlatıcısında listelenen bir skill'in tam adı. Eklenti-namespace'li skill'ler için tam nitelikli `plugin:skill` formunu kullanın (örneğin `skill-creator:skill-creator`). Başına slash koymayın.
+- `args` (string, opsiyonel): Skill'e geçirilen serbest biçimli argümanlar. Format ve anlam her skill'in kendi dokümantasyonu tarafından tanımlanır.
 
-**Kullanıma uygun değil:**
-- Yerleşik CLI komutları (örn. `/help`, `/clear`)
-- Zaten çalışmakta olan bir beceri
-- Kullanılabilir beceri listesinde olmayan beceri adları
+## Örnekler
 
-## Dikkat Edilecekler
+### Örnek 1: Mevcut dalda bir inceleme skill'i çalıştırmak
 
-- Beceri çağrıldıktan sonra tam bir prompt'a genişletilir
-- Tam nitelikli adları destekler (örn. `ms-office-suite:pdf`)
-- Kullanılabilir beceri listesi system-reminder mesajlarında sağlanır
-- `<command-name>` etiketi görüldüğünde beceri zaten yüklenmiş demektir, bu aracı tekrar çağırmak yerine doğrudan çalıştırılmalıdır
-- Aracı gerçekten çağırmadan bir beceriden bahsetmeyin
+```
+Skill(skill="review")
+```
 
-## Orijinal Metin
+`review` skill'i, mevcut base dala karşı bir pull request'i incelemek için adımları paketler. Çağırmak, harness tarafından tanımlanan inceleme prosedürünü tura yükler.
 
-<textarea readonly>Execute a skill within the main conversation
+### Örnek 2: Eklenti-namespace'li bir skill'i argümanlarla çağırmak
 
-When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+```
+Skill(
+  skill="skill-creator:skill-creator",
+  args="create a skill that summarizes git log for a given date range"
+)
+```
 
-When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
+Yazım iş akışının devreye girmesi için isteği `skill-creator` eklentisinin giriş noktası aracılığıyla yönlendirir.
 
-How to invoke:
-- Use this tool with the skill name and optional arguments
-- Examples:
-  - `skill: "pdf"` - invoke the pdf skill
-  - `skill: "commit", args: "-m 'Fix bug'"` - invoke with arguments
-  - `skill: "review-pr", args: "123"` - invoke with arguments
-  - `skill: "ms-office-suite:pdf"` - invoke using fully qualified name
+## Notlar
 
-Important:
-- Available skills are listed in system-reminder messages in the conversation
-- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
-- NEVER mention a skill without actually calling this tool
-- Do not invoke a skill that is already running
-- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
-- If you see a <command-name> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
-</textarea>
+- Yalnızca adları available-skills sistem hatırlatıcısında aynen görünen veya kullanıcının mesajında doğrudan `/name` olarak yazdığı skill'leri çağırın. Bellekten veya eğitim verilerinden asla skill adları tahmin etmeyin veya uydurmayın — skill reklamı yapılmamışsa, bu aracı çağırmayın.
+- Bir kullanıcının isteği reklamı yapılan bir skill ile eşleştiğinde, `Skill` çağırmak bloklayıcı bir önkoşuldur: görev hakkında başka herhangi bir yanıt üretmeden önce onu çağırın. Skill'in ne yapacağını tarif etmeyin — çalıştırın.
+- Aslında çağırmadan bir skill'den asla adıyla bahsetmeyin. Aracı çağırmadan bir skill'i duyurmak yanıltıcıdır.
+- `/help`, `/clear`, `/model` veya `/exit` gibi yerleşik CLI komutları için `Skill` kullanmayın. Bunlar harness tarafından doğrudan ele alınır.
+- Mevcut turda zaten çalışan bir skill'i yeniden çağırmayın. Mevcut turda bir `<command-name>` etiketi görürseniz, skill zaten yüklenmiştir — aracı tekrar çağırmak yerine talimatlarını yerinde izleyin.
+- Birkaç skill uygulanabilirse, en spesifik olanı seçin. İzinler veya kancalar eklemek gibi yapılandırma değişiklikleri için, genel bir ayarlar yaklaşımı yerine `update-config`'i tercih edin.
+- Skill yürütme, turun geri kalanı için yeni sistem hatırlatıcıları, araçlar veya kısıtlar tanıtabilir. Bir skill tamamlandıktan sonra devam etmeden önce konuşma durumunu yeniden okuyun.