Yapay zekâ ile geliştirme
Claude Code ve diğer kod ajanlarına Adanotch eklentisi yazmayı öğreten skill'i kur.
Adanotch eklentilerini bir kod ajanına (Claude Code, Codex, Cursor…) yazdırabilirsin. Ajan AdanotchKit'i bilmediği için uydurmaya meyillidir: DOM kullanmaya, olmayan bir düğüm eklemeye ya da izin istemeyi unutmaya. Adanotch skill'i bunun önüne geçer. Ajana API'yi, sınırları, izinleri ve çalışma düzenini anlatan tek bir SKILL.md dosyasıdır.
Skill ajana şunları söyler:
- API'nin kaynağı eklenti klasöründeki
adanotch/adanotch.d.ts; orada olmayan bir şeyi kullanmamalı. - Görünüm yalnız
ui.*düğümlerinden oluşur; kompakt alana neyin sığdığı, renklerin yalnız ton olduğu. - Her API'nin hangi izni gerektirdiği,
fetchkuralları, gizli değerlerin Keychain'de tutulması. - 200 ms, bellek ve paket sınırları; olmayan web ve Node API'leri.
- Her değişiklikten sonra
typecheck,test,buildvelintçalıştırması, eklediği her davranış için test yazması.
Kurulum
Tüm projelerinde kullanmak için kişisel skill olarak kur:
mkdir -p ~/.claude/skills/adanotch-extension
curl -fsSL https://www.adanotch.com/skills/adanotch-extension/SKILL.md \
-o ~/.claude/skills/adanotch-extension/SKILL.mdYalnız bir eklentide kullanmak için eklenti klasöründe:
mkdir -p .claude/skills/adanotch-extension
curl -fsSL https://www.adanotch.com/skills/adanotch-extension/SKILL.md \
-o .claude/skills/adanotch-extension/SKILL.mdClaude Code, klasörde adanotch/ ya da adanotchVersion içeren bir manifest.json gördüğünde veya sen bir Adanotch eklentisi istediğinde skill'i kendisi yükler.
Dosyayı önce okumak istersen: SKILL.md.
Kullanım
Önce adanotch init ile bir eklenti oluştur ve npm install çalıştır, sonra ajandan istediğini anlat:
Bu eklentiyi açık GitHub PR'larımı gösterecek şekilde değiştir. Token ayarlardan
girilsin, kompakt alanda sayı görünsün, karta tıklanabilir bir liste koy.
Testlerini de yaz.Ajan manifest.json'a izinleri ve secret ayarını ekler, src/index.ts'i yazar, testleri ekler ve komutları çalıştırır. Sonucu adada görmek için npm run watch ile adanotch dev'i sen çalıştır.
Ajanın kodunu sen onayla
Ajan yazdığı eklentiyi kurmaz, ama yazdığı kod onayladığın izinlerle çalışacak. Kurmadan önce manifest.json'daki izinlere ve network: alan adlarına bak.
Güncel tutmak
Adanotch'u güncellediğinde skill'i aynı komutla yeniden indir. Eklenti klasöründeki adanotch/ için adanotch init --types çalıştır; skill ajanı bu dosyalara yönlendirdiği için ikisinin aynı sürümde olması en iyisi. Adanotch güncellendiğinde