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/repo | acme/ops-skills |
owner/repo/sub/path | acme/ops-skills/skills/deploy-checks |
yukarıdakilerden biri, @ref ile | acme/ops-skills/skills/deploy-checks@v2 |
| kopyalanmış bir repo URL'si | https://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;
--agentbir 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
versioniçeren dosya açık bir hatayla reddedilir; - preset anahtarı olmayan bir sahip, ekip kurulurken atlanır ve
ivralo doctorbunu 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
| Komut | Ne yapar |
|---|---|
ivralo skills | iki 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 lint | skill'leri bilinen hatalara karşı kontrol eder |
İki raftan hiçbiri yoksa ivralo skills 1 ile çıkar ve ivralo init --home komutunu önerir.