| name | knowledge-auto-update |
| description | Agent-local knowledge dosyalarini gorev sonunda ogrenilenlerle guncelle. Triggers: knowledge update, agent knowledge refresh, ogrendigini kaydet. |
| argument-hint | [agent-id] [--auto] |
/knowledge-auto-update — Per-Agent Knowledge-First Auto-Update
Bir agent non-trivial bir gorevi bitirdikten sonra kendi knowledge/ dizinini (sadece kendisininkini) ogrendikleriyle gunceller. Patterns, trial-and-error dersleri, domain bulgulari — hepsi ekleme (additive patch) seklinde.
Kapsam (zorunlu)
Agent-local only. Bu skill SADECE ~/Projects/claude-config/agents/<agent>/knowledge/*.md altinda yazar.
- Global skill olusturma YASAK (SessionStart sisirir — Video 1 / Video 4 uyarisi)
- Baska agent'in knowledge'ini degistirme
~/.claude/ altina dogrudan yazma — install.sh ile mirror edilecek- CLAUDE.md / charter / harness — dokunma
Manuel muadiller: agent-sharpen (web'den arastir), agent-refine-knowledge (Opus ile kalite review). Bu skill otomatik "gorevden ogrenilen" yakalayici; onlarin yerini tutmaz.
Tetikleme modlari
| Mod | Nasil |
|---|
| Manuel | /knowledge-auto-update <agent-id> — kullanici veya Jarvis cagirir |
| Auto | Agent kendini >10 tool call sonrasi self-trigger — opsiyonel hook wiring (su an devre disi) |
Auto hook wiring bu skill kapsamina dahil degil — ayri karar. Su an sadece manuel + explicit trigger.
Akis
1. Agent tespit
- Argument verildiyse
<agent-id> onu kullan
- Yoksa son dispatch edilen agent'i
/tmp/watchdog/current_dispatch.json'dan oku
- Hic yoksa → kullaniciya sor, dur
2. Gorev ozeti cikar
Son turn'deki (veya son dispatch'teki) tool call'lari ve sonuclari tara:
- Hangi dosyalara dokunuldu?
- Hangi komutlar basarisiz oldu, neden?
- Hangi non-obvious pattern kullanildi?
- Hangi domain gercegi kesfedildi? (API quirk, lib davranisi, repo yapisi)
Max 8 tool call bu adimda.
3. Kategorize et
Bulgulari 3 bucket'a ayir:
| Bucket | Ornek |
|---|
| Patterns | "Bu tur task'ta once X, sonra Y yap" |
| Trial-and-error | "Z denedim, W yuzunden patladi, V ile calisti" |
| Domain facts | "Library A'nin method B'si default'u C degil D" |
Trivial olani at (1 satirlik obvious seyleri kaydetme).
4. Safety guard
Her bulguyu yazmadan once kontrol et — asagidakilerden biri varsa reddet:
rm -rf, sudo rm, dd if= gibi destructive komut orneklericurl ... | bash, wget ... | sh gibi remote-exec patterns- API key, token, password, secret deger (env var adi OK, deger DEGIL)
- Musteri/kisisel veri (email, telefon, kimlik)
- Baska kullanici/agent isimleri + kisisel yorumlar
Reddet = kaydetme + kullaniciya tek satir bildir: [GUARD] rejected N entries (reason: secret|destructive|pii).
5. Additive patch
~/Projects/claude-config/agents/<agent>/knowledge/ altinda:
- Uygun dosya varsa (ornek
patterns.md, lessons.md, domain.md) → dosyanin sonuna ekle, ustune yazma
- Yoksa yeni dosya olustur:
knowledge/<kategori>.md
- Her yeni entry'e tarih + gorev kisa ozeti prefix'i:
<!-- 2026-04-23 — task: {ozet} -->
6. Index guncelle
knowledge/_index.md dosyasini ac:
- Yeni dosya eklendiyse → index'e 1 satir ekle
- Mevcut dosyaya entry eklendiyse → (opsiyonel) entry count guncelle
- 200 satir limitini koru — asarsa kullaniciya
agent-refine-knowledge oner
7. Rapor
## Knowledge Auto-Update — <agent-id>
- Patterns: +N entries → patterns.md
- Lessons: +M entries → lessons.md
- Domain: +K entries → domain.md
- Rejected by guard: R (reasons: ...)
- Index: updated
Next: install.sh gerekirse calistir (runtime mirror icin).
Kurallar
- Max 15 tool call toplam
- ASLA global skill/agent/plugin olusturma
- ASLA baska agent'in klasorune yazma
- Safety guard opt-out edilemez
- Dil: entries Turkce+Ingilizce karisik OK (mevcut knowledge stiline uy)
- Duplicate kontrolu yap — ayni pattern zaten varsa ekleme, skip
When NOT to Use
- Trivial gorev (<10 tool call, cok net yol) — ogrenilecek yeni birsey yok
- Sadece okuma yapan gorev (investigation) — patterns disinda kayit sey yok
- Hatali/yarida kalan gorev — yanlis dersler yazmaktansa atla
Red Flags
- Ayni entry iki iterasyonda tekrar ekleniyor → duplicate check calismiyor, dur
- Guard > actual saves oranı yuksek → prompt secret/dangerous icerikle kirli
- Knowledge dosyasi 500 satiri astı →
agent-refine-knowledge oner, ekleme yapma
Error Handling
- Agent klasoru yok → dur,
agent-setup oner
- Write izni yok → dur, path'i kullaniciya goster
- Guard tetiklendi → entry'yi sessizce at, final raporda say
Verification
