Multica Docs

Skill'ler

Tekrarlayan talimatları, adımları ve referans materyalini birden fazla agent'ın yeniden kullanabileceği skill'lere paketleyin.

Bir skill, bir çalışma alanındaki yeniden kullanılabilir bir çalışma yöntemleri kümesidir. Ana dosyası SKILL.md'dir, isteğe bağlı olarak betikler, şablonlar ve referans materyali eşlik eder.

Bir skill'i bir agent'a ekleyin, agent ilgili işi yaparken onun rehberliğini kullansın. Aynı yöntemin artık her agent'ın talimatlarına kopyalanması gerekmez ve güncellemeler tek bir yerde tutulur.

Skill'ler ve agent talimatları

Agent talimatlarıSkill
En uygun olduğu durumBu agent'ın uzun ömürlü sorumlulukları, sınırları ve teslimat gereksinimleriBir tür iş için yeniden kullanılabilir adımlar, materyal ve araçlar
KapsamBir agent'a aittir ve her çalıştırmada sağlanırBirden fazla agent'a eklenebilir ve tek tek etkinleştirilip devre dışı bırakılabilir
Örnek"Yalnızca frontend kodunu incele, asla doğrudan değiştirme"Bir erişilebilirlik kontrol listesi ve rapor şablonu

Bir skill oluşturma veya içe aktarma

Çalışma alanının Skill'ler sayfasında "Yeni skill"i seçin. Dört seçenek vardır:

SeçenekNe zaman uygun
Elle oluşturBoş bir SKILL.md'den yazmaya başlayın.
Yerelden içe aktarSKILL.md içeren bir klasör veya bu bilgisayardaki bir .skill / .zip arşivi seçin.
URL'den içe aktarGitHub, ClawHub veya Skills.sh'ten yayımlanmış bir skill içe aktarın.
Bir runtime'dan kopyalaBağlı bir bilgisayardaki skill'leri tarayın ve seçilenleri çalışma alanına kopyalayın.

Bir runtime'dan kopyalamak, o andaki dosyaların bir anlık görüntüsünü alır. Yerel dosyalardaki sonraki değişiklikler çalışma alanı sürümünü otomatik olarak güncellemez; Multica'da yeniden içe aktarın veya düzenleyin.

Aynı arşiv biçimi CLI'dan da çalışır:

multica skill import --file ./review-helper.skill

Çalışma alanında aynı adda bir skill zaten varsa, içe aktarma durabilir, mevcut içeriğin üzerine yazabilir, yeni bir adla kaydedebilir veya atlayabilir. İçe aktarma yoluyla üzerine yazma yalnızca skill'in oluşturucusuyla sınırlıdır; uygulamada skill'i düzenleyebilen bir çalışma alanı admini bile içe aktarma yoluyla üzerine yazamaz. Çalışma alanında zaten bulunan bir skill'in daha yeni bir sürümünü çekmek için, bunun yerine İçe aktarılmış bir skill'i güncelleme'yi kullanın.

İçe aktarılmış bir skill'i güncelleme

GitHub, ClawHub veya Skills.sh'ten içe aktarılan bir skill, kaynağına bir referans tutar. En son sürümü çekmek için skill sayfasındaki Güncelle'yi (veya listenin satır menüsündeki "Kaynaktan güncelle"yi) ya da CLI'yi kullanın:

multica skill refresh <skill-id>

Skill, kaynağından yeniden indirilir ve yerinde değiştirilir:

  • Korunur: skill'in kimliği — agent atamaları, etiketler, oluşturan ve oluşturulma tarihi. Agent'lar skill'i yeniden eklemeye gerek kalmadan korur.
  • Değiştirilir: ad (kaynak yeniden adlandırdıysa), açıklama, SKILL.md ve tüm destekleyici dosyalar. Skill üzerindeki yerel düzenlemelerin üzerine yazılır.

Skill'in oluşturucusu ve çalışma alanı ownerları / adminleri kaynaktan güncelleyebilir. Elle oluşturulan, bir arşiv dosyasından içe aktarılan veya bir runtime'dan kopyalanan skill'lerin barındırılan bir kaynağı yoktur ve bu şekilde güncellenemez — bunun yerine yeniden içe aktarın.

Birden fazla skill'i aynı anda güncellemek için, skill listesinde bunları seçin ve seçim araç çubuğunda Güncelle'yi seçin. Barındırılan bir kaynağı olan her seçili skill kaynağından yeniden indirilir; kaynağı olmayanlar atlanır.

Skill içeriği

Her skill bir ana dosya içerir, SKILL.md. Şunları açıkça belirtin:

  • skill'in ne zaman uygulandığı;
  • başlamadan önce neyin kontrol edileceği;
  • yürütülecek adımlar;
  • sonucun hangi biçimde olması gerektiği;
  • ne zaman durup bir üyeyle kontrol edileceği.

Ayrıca destekleyici dosyalar da ekleyebilirsiniz, örneğin:

SKILL.md
references/api-conventions.md
templates/review-report.md
scripts/check.sh

SKILL.md ayrılmış bir yoldur; bir destekleyici dosya bu adı kullanamaz. Destekleyici dosyalar, ana dosyayla birlikte agent'a teslim edilir.

Bir agent'a ekleme

Bir skill oluşturduktan veya içe aktardıktan sonra, hâlâ belirli agent'lara eklenmesi gerekir. Skill sayfasında agent'ları seçin, veya bağları agent'ın Skill'ler sekmesinden yönetin.

  • Bir agent birden fazla skill kullanabilir;
  • bir skill birden fazla agent'a hizmet edebilir;
  • bir skill'e şimdilik ihtiyaç yoksa, skill'i silmek yerine bağı devre dışı bırakın;
  • düzenlemeler sonraki çalıştırmalardan itibaren geçerli olur ve zaten devam eden çalıştırmaları değiştirmez.

Yalnızca agent'ı değiştirebilen üyeler, onun skill'lerini ekleyebilir, kaldırabilir veya devre dışı bırakabilir.

Çalışma alanı skill'leri ve depo skill'leri

Çalışma alanı skill'leri Multica'da saklanır — takımın birlikte sürdürdüğü ve farklı agent'lara eklediği skill'ler için uygundur.

Bazı yapay zekâ kodlama araçları, .claude/skills/ veya .agents/skills/ gibi proje düzeyi skill'leri doğrudan kod deposundan da okur. Bu dosyalar depo tarafından yönetilmeye devam eder; Multica bunları otomatik olarak çalışma alanı skill'i olarak kaydetmez. Destek, kullanılan araca bağlıdır — bkz. Yapay zekâ kodlama araçları karşılaştırması.

Bağlı bir bilgisayarda zaten kurulu runtime-yerel skill'ler (Claude Code ve Codex), agent'ın Skill'ler sekmesinde görünür ve agent başına devre dışı bırakılabilir. Devre dışı bırakmak da agent'ı değiştirme izni gerektirir.

Düzenleme izinleri

Herhangi bir çalışma alanı üyesi bir skill oluşturabilir veya içe aktarabilir. Oluşturucu ve çalışma alanı ownerları ve adminleri onu değiştirebilir veya silebilir; diğer üyeler görüntüleyip kullanabilir, ama içeriğinin üzerine yazamaz.

Silme kalıcıdır ve skill'i aynı anda tüm agent'lardan kaldırır.

Harici kaynaklardan içe aktarılan skill'ler betikler, komutlar veya güvensiz talimatlar içerebilir. Multica bunları sizin için incelemez, imzalamaz veya sanal alana almaz. İçe aktarılan içerik agent'lara olduğu gibi teslim edilir, bu yüzden kaynağın güvenilir olması gerekir.

Sonraki adımlar