İçeriğe geç
ivralo
Bölümler

Dokümantasyon / Skill'ler

Skill kurmak

Skill'ler GitHub'dan local rafa kurulur. Bu sayfada skill kurma, güncelleme, kaldırma ve atama ile hangi skill'in kime ait olduğunu tutan dosya anlatılıyor.

GitHub'dan kurmak

ivralo skills install anthropics/skills/document-skills/xlsx --agent analyst

Kaynak olarak GitHub'daki bir repo'yu verirsiniz; repo'da birden fazla skill varsa içindeki klasörü de belirtirsiniz:

BiçimÖrnek
owner/repoacme/ops-skills
owner/repo/sub/pathacme/ops-skills/skills/deploy-checks
yukarıdakilerden biri, @ref ileacme/ops-skills/skills/deploy-checks@v2
kopyalanmış bir repo URL'sihttps://github.com/acme/ops-skills
doğrudan bir klasörün bağlantısıhttps://github.com/acme/ops-skills/tree/main/skills/deploy-checks

Yalnızca GitHub desteklenir ve git'in PATH üzerinde olması gerekir. Kurulum aracı geçici bir klasöre sığ bir clone alır, tek SKILL.md'yi bulur, doğrular ve lint'ten geçirir. Ardından neyin kurulacağını gösterir: ad, açıklama, dosya listesi, lint bulguları ve skill script içeriyorsa bir uyarı. Ancak bundan sonra onay ister.

Evet demeden önce script'leri okuyun. Ajanlar onları yalnızca Python worker'ında, run_skill_script ile çalıştırır; ama sonuçta başkasının yazdığı koddur.

Şu durumlarda hiçbir şey yazılmadan kurulum reddedilir:

  • skill'in adı shipped bir skill'le aynıysa;
  • repo'da birden fazla skill varsa ve klasör belirtilmemişse;
  • --agent bir preset anahtarı değilse.

Kime gider

--agent verirseniz skill o preset'e atanır; seçeneği birden fazla kez verebilirsiniz. Vermezseniz skill ekibe, kendi adını taşıyan ayrı bir uzman olarak katılır. Sonradan bir preset'e bağlamak için ivralo skills assign kullanılır. Her iki durumda da skill'i her uzman yükleyebilir; sahiplik yalnızca işin kime yönlendirileceğini belirler. İkisi de Skill'ler nasıl çalışır sayfasında anlatılıyor.

Ekip skill'i bir sonraki kurulumunda alır: yeni bir oturumda ya da yeniden başlatmada. Oturumun içinden /skill install <kaynak> kurulumu yapar ve ekibi sizin yerinize yeniden kurar.

Terminal olmadan

Yeni bir kurulumda --yes, onay sorusunun yerine geçer. Terminal de --yes de yoksa hiçbir şey kurulmaz.

ivralo skills install acme/ops-skills/skills/deploy-checks --yes

Güncellemek

ivralo skills update deploy-checks

Bu komut skill'i, kurulurken kaydedilen kaynaktan yeniden çeker; kaynak, skill'in kendi frontmatter'ında metadata.ivralo altında tutulur. Hiçbir şey değişmediyse "Already up to date" yazar ve durur. Değişiklik varsa bir diff gösterir ve onay ister.

Değiştirme işlemi bir yedek alınarak yapılır; taşıma başarısız olursa eski kopya geri getirilir.

Kaldırmak

ivralo skills remove deploy-checks

Bu komut local bir skill'i atamasıyla birlikte siler. Önce onay ister; --yes soruyu atlar, terminal yoksa --yes zorunludur. Shipped skill'ler kaldırılamaz.

Atamak ve atamayı kaldırmak

ivralo skills assign deploy-checks --agent coder --agent investigator
ivralo skills unassign deploy-checks

assign, skill'i mevcut sahiplerine ek olarak bir ya da daha fazla preset'e verir. unassign kaydı siler; başka sahibi kalmayan local skill yeniden kendine ait bir uzmanla çalışır. Her sahip, hiçbir şey yazılmadan önce preset listesiyle karşılaştırılır; anahtarları ivralo agents ile görebilirsiniz.

assignments.json

Atamalar local skill'lerin yanında, skills.local/assignments.json dosyasında tutulur:

{
  "version": 1,
  "skills": {
    "deploy-checks": { "agents": ["coder", "investigator"] }
  }
}

Yukarıdaki komutlar bu dosyayı sizin yerinize, atomik olarak yazar. Elle düzenlerseniz şunları bilin:

  • farklı bir version içeren dosya açık bir hatayla reddedilir;
  • preset anahtarı olmayan bir sahip, ekip kurulurken atlanır ve ivralo doctor bunu bildirir;
  • artık var olmayan bir skill adı, ekibin kurulumunu o skill'in adını vererek durdurur; böylece hiçbir uzman sandığınızdan daha az skill'le kurulmaz.

Komutlar

KomutNe yapar
ivralo skillsiki rafı ve her skill'in doğrulamadan geçip geçmediğini listeler
ivralo skills install <kaynak>GitHub'dan kurar; --agent, --yes
ivralo skills update <ad>kayıtlı kaynaktan yeniden çeker; her zaman onay ister
ivralo skills remove <ad>local bir skill'i atamasıyla birlikte siler; --yes
ivralo skills assign <ad> --agent <anahtar>skill'i bir preset'e verir
ivralo skills unassign <ad>atamayı kaldırır
ivralo skills create <ad>yeni bir skill iskeleti oluşturur, bkz. Skill yazmak
ivralo skills lintskill'leri bilinen hatalara karşı kontrol eder

İki raftan hiçbiri yoksa ivralo skills 1 ile çıkar ve ivralo init --home komutunu önerir.