# Eklentiler ve Beceriler

## Eklentiler

### Eklentiler Nedir?

Eklentiler, Neotask'ın işlevselliğini çalışma zamanında genişleten TypeScript modülleridir. Yeni mesajlaşma kanalları, ajan araçları, RPC yöntemleri, CLI komutları, arka plan hizmetleri ve beceriler ekleyebilirler.

### Resmi Eklentiler

**Mesajlaşma Kanalları:**
- Microsoft Teams, Matrix, Nostr, Zalo, Feishu/Lark, LINE, Nextcloud Talk, Mattermost, Tlon, Twitch

**Özellikler:**
- **Sesli Arama**, Gelen/giden sesli aramalar için SIP telefoni desteği
- **Bellek (LanceDB)**, Vektör benzerlik aramasıyla uzun süreli bellek
- **MCP Native**, Harici araçları köprülemek için Model Context Protocol sunucu entegrasyonu

**Kimlik Doğrulama Sağlayıcıları:**
- Google Antigravity OAuth, Gemini CLI OAuth, Qwen OAuth, Minimax OAuth, VS Code Copilot Proxy

### Eklenti Yetenekleri

Eklentiler şunları kaydedebilir:
- **RPC Yöntemleri**, İstemcilerin çağırabileceği özel WebSocket yöntemleri
- **HTTP İşleyicileri**, Gateway üzerinde özel HTTP uç noktaları
- **Ajan Araçları**, Ajanların çağırabileceği türlendirilmiş şemalara sahip yeni araçlar
- **CLI Komutları**, Ek komut satırı komutları
- **Arka Plan Hizmetleri**, Gateway tarafından yönetilen uzun süreli çalışan süreçler
- **Beceriler**, Eklentiyle birlikte paketlenmiş beceri dizinleri
- **Otomatik Yanıt Komutları**, Yapay zeka ajan katılımı olmadan yürütülen komutlar

### Eklenti Güvenliği

Neotask, eklentileri çalışmadan önce birkaç katmanda denetler:

- **İmzalı ve doğrulanmış.** Herkese açık Construct kataloğundaki paketleri Neotask yayımlar; paketler yayından önce otomatik olarak incelenir ve Neotask'ın yayın anahtarıyla imzalanır. Neotask, bir paketi kurmadan önce imzayı Neotask'a yerleşik anahtarlarla kontrol eder ve indirmenin SHA-256 özetini doğrular.
- **Kurulum betiği yok.** Construct paketleri bağımlılıklarıyla birlikte gelir; bu yüzden kurulum hiçbir zaman paket yöneticisi veya kurulum betiği çalıştırmaz. Başka bir eklenti kurulumu npm kullandığında kurulum betikleri kapalıdır.
- **Kurulumda tarama.** Construct dışından kurulan eklentiler tehlikeli koda karşı taranır ve kritik bulgular kurulumu engeller.
- **Sürüm başına lisans.** Bir Construct eklentisi, yalnızca hesabınızın o sürüm için geçerli bir izni olduğu sürece yüklenir. İptal edilen sürümler yüklenmez.
- **Ajan eylemleri için onay.** Ajanın araç çağrıları, eklentilerin eklediği araçlar dahil, onay politikanıza göre denetlenir ve onayınızı gerektiren eylemler onu bekler. Bir ajanın Neotask ile gelen kurulum tariflerinin dışında kurmak istediği yazılım size her zaman tam komutu gösterir ve onayınızı bekler.
- **İsteğe bağlı sandbox.** Bir ajanın araçlarını doğrudan bilgisayarınızda değil, yalıtılmış bir Docker kapsayıcısında çalıştırabilirsiniz. Sandbox varsayılan olarak kapalıdır; açmak için [Güvenlik](security.md) sayfasına bakın.

Yerel eklentiler Gateway süreci içinde çalışır; bu nedenle Construct dışından kurduğunuz bir eklenti, çalıştırmayı sizin seçtiğiniz koddur. Yüklenebilecek eklentileri belirtmek için `plugins.allow` kullanın.

---

## Beceriler

### Beceriler Nedir?

Beceriler, ajanlara yeni iş akışları öğreten modüler yeteneklerdir. Her beceri, ilgili olduğunda ajanın bağlamına enjekte edilen talimatları içeren bir markdown dosyasıdır (`SKILL.md`).

### Beceri Konumları (Öncelik Sırası)

1. **Çalışma alanı becerileri**, `<workspace>/skills/` (en yüksek öncelik)
2. **Yönetilen beceriler**, `~/.neotask/skills/`
3. **Paketlenmiş beceriler**, Neotask ile birlikte gelir
4. **Eklenti becerileri**, Kurulu eklentilerle paketlenmiş beceriler
5. **Ekstra dizinler**, Yapılandırılmış ek yollar (en düşük öncelik)

Aynı adı paylaşan birden fazla beceri olduğunda, en yüksek öncelikli konum kazanır.

### Beceri Özellikleri

- **Kullanıcı tarafından çağrılabilir**, Becerileri doğrudan eğik çizgi komutlarıyla tetikleyin (ör. `/docker-build`)
- **Model tarafından çağrılabilir**, Ajanın ilgili olduğunda kendi başına çağırabileceği beceriler
- **Komut dağıtımı**, Belirli araçlarla eşleşen beceriler
- **Gereksinimler geçidi**, Beceriler yalnızca gereksinimleri karşılandığında yüklenir (gerekli ikili dosyalar, yapılandırma anahtarları, ortam değişkenleri, eklentiler)

### Beceri Oluşturma

YAML ön maddesiyle birlikte becerinin meta verilerini ve talimatlarını tanımlayan bir `SKILL.md` dosyası oluşturun:

**Ön madde alanları:**
- `name`, Beceri tanımlayıcısı
- `description`, Becerinin ne yaptığı
- `homepage`, Belgelere bağlantı
- `user-invocable`, Kullanıcıların doğrudan tetikleyip tetikleyemeyeceği
- `disable-model-invocation`, Ajanın onu özerk olarak çağırmasını engelle
- `command-dispatch`, Dağıtılacak araç
- `metadata.neotask.requires`, Önkoşullar (ikili dosyalar, yapılandırma, ortam, eklentiler)

**Gövde:** Ajana beceriyi nasıl kullanacağını öğreten, örnekler ve kılavuzlar içeren Markdown talimatları.

### Beceri Kataloğu

Mevcut becerilere [beceri kataloğundan](/skills) göz atın.

### Beceri Kategorileri

Beceriler çok çeşitli yetenekleri kapsar:

| Kategori | Örnekler |
|----------|---------|
| **Üretkenlik** | E-posta yönetimi, takvim, belge oluşturma |
| **Geliştirme** | Git işlemleri, CI/CD, Docker, kod inceleme |
| **İletişim** | Mesajlaşma, bildirimler, duyurular |
| **Medya** | Görüntü işleme, video düzenleme, ses dökümü |
| **Yapay Zeka ve Modeller** | Model değiştirme, istem yönetimi, RAG |
| **Akıllı Ev** | IoT cihaz kontrolü, otomasyon tetikleyicileri |
| **Yardımcı Programlar** | Dosya dönüştürme, veri dönüşümü, web kazıma |