atl learnings

Kalıcı öğrenme kuyruğunu incele ve boşalt — kendi kendini süren öğrenme döngüsünün üstünde çalıştığı taban katman.

Konuşma sırasında yakalanan işaretçiler (Claude'un oturum ortasında düşürdüğü satır içi <!-- learning ... --> notları) kuyruğa tam olarak bir kez aktarılır; içerik özetine (hash) göre yinelenenler ayıklanır. /drain skill'i bekleyen her öğeyi bilgi tabanına (wiki / journal / ajan bilgi tabanı) katlar, ardından onaylar (ack) — böylece işlenen öğe silinir ve bir daha asla yeniden raporlanamaz. Bu işle-sonra-sil tasarımı, v1'in uzun-oturum yeniden-rapor hata sınıfını yapısal olarak ortadan kaldıran şeydir: raporlar kuyruktan gelir, sürekli büyüyen bir transkripti yeniden tarayarak değil.

Kuyruk, ~/.atl/queue.db konumundaki tek bir gömülü bbolt dosyasıdır — sunucu yok, daemon yok. Her projenin kuyruğu o tek dosyada yaşar; çalışma diziniyle anahtarlanan, proje başına ayrı kovalara (bucket) yalıtılmıştır. Üç alt komutun hepsi de mevcut proje üzerinde işler (komutları çalıştırdığın dizin).

Ne zaman kullanılır?

Bunları elle pek nadiren çalıştırırsın — döngü onları kendiliğinden sürer. Şu durumlarda başvur:

• status — bilgi tabanına katlanmak üzere ne kadar öğenin beklediğine bir göz atmak için (bu, SessionStart hook'unun yüzeye çıkardığı sayının aynısıdır).
• peek — bekleyen öğeleri gerçekten görmek ya da makine-okunur listeyi bir betiğe vermek için. Bu, /drain skill'inin tükettiği belirlenimci okuma yüzeyidir.
• ack — döngünün normalde katlayacağı bir şeyi atlamak istiyorsan bir öğeyi elle işlenmiş olarak işaretlemek (silmek) için.

Kullanım

atl learnings status                 # kanal başına bekleyen sayılar
atl learnings peek                   # bekleyen öğeleri listele (insan-okunur)
atl learnings peek --json            # tam makine-okunur liste
atl learnings peek --channel learning  # tek bir kanala filtrele
atl learnings ack <id>               # bir öğeyi işlenmiş işaretle (sil)

Alt komutlar

atl learnings status

Her kanal için bekleyen öğe sayısını yazdırır; doğrudan kuyruktan okur (yapısı gereği doğru, asla çıkarımla bulunmaz). Kanallar learning ve profile-fact'tir. Kuyrukta hiçbir şey yokken şunu yazdırır:

learning queue: empty (nothing pending)

Aksi hâlde:

learning queue — pending by channel:
  learning       3
  profile-fact   1

atl learnings peek

/drain skill'inin işleyip geçtiği bekleyen öğeleri listeler — id, channel ve yükün (payload) ilk satırı. Kuyrukta hiçbir şey yokken no pending items yazdırır.

Bayrak	Tip	Varsayılan	Ne yapar
--channel <name>	string	(tümü)	Tek bir kanala filtreler (ör. learning).
--json	bool	false	Bekleyen listenin tamamını JSON olarak verir (id, channel, payload, enqueued_at) — /drain skill'inin üstünde çalıştığı biçim.

İnsan-okunur çıktı, 12 karaktere kısaltılmış bir id'yi, kanalı ve yükün ilk satırını gösterir:

a1b2c3d4e5f6  learning      BSD sed requires escaped pipes for alternation …

atl learnings ack <id>

İşlenmiş bir öğeyi kuyruktan siler — işle-sonra-sil olduğundan asla yeniden ortaya çıkamaz. Tam olarak bir id alır (peek --json çıktısındaki tam id; 12 karakterlik görüntüleme biçimi değil). Etkisizdir (idempotent): orada olmayan bir id'yi onaylamak zararsız bir işlemsizliktir (no-op). /drain skill'i her öğeyi tümleştirdikten sonra bunu çağırır.

acked a1b2c3d4e5f6...

Örnekler

Neyin beklediğini denetle, sonra ona bak:

atl learnings status
atl learnings peek

Kuyruğu bir betikten sür — JSON'u oku, her öğeyi tümleştir, onayla:

atl learnings peek --channel learning --json
# ... her öğeyi işle ...
atl learnings ack <id>

İlgili

• /drain — peek'i okuyan, her öğeyi bilgi tabanına katlayan ve ack'leyen skill. Kuyruğun her günkü boşaltılma yolu; learnings alt komutları onun belirlenimci tesisatıdır.
• atl setup-hooks — bekleyen sayıyı yüzeye çıkaran ve yakalanan işaretçileri kuyruğa aktaran SessionStart hook'unu kurar.