Yapay zeka kodlama ajanlarını benimsemiş her ekipte, promptları tam da işe yarayan bir geliştirici vardır. İnceleme istekleri ekibin sevdiği şekilde yapılandırılmış olarak geri döner. Test yazma talimatları, ilk denemede ekibin üslubuna uyan testler üretir. Onlara nasıl yaptığını sorun; yanıt genellikle bir karalama dosyası, bir dotfiles deposu ya da her sabah yeni bir oturuma yapıştırdıkları bir paragraftır. Zanaat gerçek. Sorun, onun nerede yaşadığı.
Tek bir kişinin kafasında yaşayan prompt zanaatı ölçeklenmez, tatillerde ayakta kalmaz ve başka kimsenin ajan çalışmalarında görünmez. O geliştirici yokken kalite düşer. Ekip bir ajandan beşe geçtiğinde, bu beşi işin nasıl yapılması gerektiği konusunda anlaşamaz.
Skill'ler Sharkly'nin bu boşluğa yanıtıdır. Bir Skill, Agent çalışmaları için yeniden kullanılabilir talimatları ve destekleyici dosyaları bir sahip, bir kapsam ve açık izinlerle paketler. Önce genel kavramı öğrenmek isterseniz, kodlama ajanı Skill'inin ne olduğu tanımı ve daha geniş ekosistemi ele alır. Bu yazı, Sharkly'nin kendi içindeki iş akışıyla ilgilidir.
TL;DR
Sharkly'de bir Skill, Agent çalışmaları için yeniden kullanılabilir talimatları ve destekleyici dosyaları paketler: inceleme kuralları, teslimat kontrol listeleri, yazma standartları, bir ekip süreci. Sıfırdan bir tane oluşturabilir, desteklenen bir genel kaynaktan yayımlanmış bir Skill yükleyebilir, yerel bir Runtime tarafından keşfedileni içe aktarabilir veya bir SKILL.md, .skill dosyası ya da zip paketi yükleyebilirsiniz. Her Skill'in, oluşturulma anında seçilen ve ömür boyu sabit kalan tam olarak bir kapsamı vardır: Organizasyon, Space veya Agent. Agent'lar uygun Skill'leri Skill ayarları üzerinden bağlar, değişiklikler sonraki çalışmalara uygulanır ve düzenleme hakları oluşturana, Organizasyon Sahiplerine ve Yöneticilere aittir. Sonuç: prompt zanaatı tek bir geliştiricinin dotfiles'ında yaşamayı bırakır ve paylaşılan, izinlerle kontrol edilen ekip altyapısına dönüşür.
Prompt zanaatı bir yuvaya kavuştuğunda neler değişir
İyi bir prompt ile bir Skill arasındaki fark metin değildir. Metnin etrafındaki her şeydir.
Bir karalama dosyasındaki promptun sahibi, hedef kitlesi ve yaşam döngüsü yoktur. Kimse var olduğunu bilmez, Slack'te buldukları kopyanın güncel olup olmadığını kimse söyleyemez ve süreç değiştiğinde onu güncellemekten kimse sorumlu değildir. Bir Skill'de üçü de vardır. Bir organizasyona aittir. Kapsamı, hangi Agent'ların onu kullanabileceğini tam olarak belirtir. Düzenleme izinleri, onu kimin değiştirebileceğini tam olarak belirtir. Süreç değiştiğinde Skill'i bir kez güncellersiniz ve bağlı her Agent'ın sonraki çalışmaları değişikliği alır.
Bu, kaldıraç tezinin minyatür halidir. Ekip kaldıracı daha fazla yapay zeka sohbeti açmaktan gelmez; roller, kurallar, bağlam ve iş akışlarını paylaşmaktan gelir. Agent'lar sonuçlarını Görev'e döndürdüğü için, Skill yönlendirmeli bir çalışmanın çıktısı ekibin inceleyebileceği paylaşılan kayda düşer.
İş akışına geçmeden önce bir sınır çizelim. Bir Skill, Görev gereksinimi değildir. Tek seferlik gereksinimleri Görev açıklamasında veya yorumlarında tutun. Bunu yalnızca bu Görev gerektiriyorsa, o bağlamdır. Gelecek ayki çalışmalar da gerektiriyorsa, o altyapıdır.
Sıfırdan bir Skill oluşturma
Bir Skill üç şeyle başlar: bir ad, bir açıklama ve talimatlar. Bu ayrım göründüğünden daha önemlidir.
Açıklama, Agent'ın Skill'i ne zaman kullanması gerektiğini belirtir. Bu, tetikleme koşuludur; yeteneklerini tarayan bir Agent'a bunun önündeki işe uygun olduğunu söyleyen cümledir. Talimatlar, tekrarlanabilir süreci ve beklenen çıktıyı tanımlar: adımlar, kontroller, sonucun alması gereken biçim. Kullanışlı bir test: Bir Agent'ın bu Skill'e ne zaman başvurması gerektiğini tek cümleyle söyleyebiliyor musunuz? Söyleyemiyorsanız, muhtemelen ya iki Skill'e bakıyorsunuz ya da hiçbirine.
Kaputun altında, birincil talimatlar bir SKILL.md dosyasında bulunur: en üstte YAML name ve description alanları, ardından talimatlar gelir. Destekleyici dosyalar, şablonlar, örnekler veya referans verileri sağlamak için onunla birlikte taşınabilir. Bir teslimat kontrol listesi Skill'i, kontrol listesi şablonunu taşıyabilir; bir migration yazma Skill'i iki açıklamalı örnek içerebilir. Bunları odaklı tutun. Büyük veya ilgisiz dosya koleksiyonları, Agent'ın kararlarını iyileştirmeden bağlam ekler.
Halihazırda sahip olduğunuz zanaatı içe aktarma
Çoğu ekip sıfırdan başlamaz. Prompt zanaatı zaten vardır; yalnızca dağınıktır. Sharkly size üç içe aktarma yolu sunar.
Desteklenen bir genel kaynaktan yükleyin. Sharkly yayımlanmış bir Skill'i getirebilir ve seçtiğiniz kapsamda yönetilen bir kopya oluşturabilir. Yönetilen kopya önemlidir: başkasının dosyasına bağlantı vermiyorsunuz, organizasyonunuzun kontrol ettiği bir anlık görüntü alıyorsunuz. Herhangi bir Agent'a bağlamadan önce kaynağı ve içe aktarılan içeriği inceleyin. Harici talimatları güvenilir organizasyon politikası olarak değil, üçüncü taraf kodu olarak ele alın.
Yerel bir Runtime'dan içe aktarın. Bu yol tam olarak dotfiles sorunu için oluşturulmuştur. Çevrimiçi bir yerel Runtime, yerel Skill dizinlerinde keşfedilen Skill'leri bildirebilir; bu da bir geliştiricinin sessizce biriktirdiği zanaatın organizasyon tarafından görülmesi anlamına gelir. İçe aktarma, Skill'i organizasyona kopyalar; özgün yerel kopya ayrı kalır, böylece o geliştiricinin kurulumunda hiçbir şey bozulmaz. Bir uyarı bunu dürüst tutar: bir Agent'ın Runtime'ına doğrudan sunulan yerel Skill'lerin üründe bağlanmasına hiç gerek yoktur. Yalnızca var olduğu için değil, açık bir kapsama sahip yönetilen, yeniden kullanılabilir bir Skill haline gelmesi gerektiğinde içe aktarın.
Bir paket yükleyin. Skill bir repoda yaşıyorsa veya bir iş arkadaşından geldiyse, bir SKILL.md, bir .skill dosyası veya bir zip paketi yükleyin. Sharkly gelen içeriği doğrular: dosya yolları göreli olmalıdır ve Skill'in dışına çıkamaz; yükleme ve içe aktarma gizli veya hassas yolları, desteklenmeyen ikili içeriği, güvenli olmayan arşiv girdilerini, yinelenen yolları ve hizmet sınırlarını aşan paketleri reddeder. Bir Skill, bir Agent'ın izleyeceği talimatlardır; bir bağımlılıkla aynı düzeyde incelemeyi hak eder.
Kapsam: Bir Skill'i kimlerin kullanabileceğine karar verme
Her Skill bir organizasyona aittir ve oluşturulma anında seçilen tam olarak bir kapsama sahiptir. Kapsam, hangi Agent'ların onu bağlayabileceğine karar verir ve sonradan değiştirilemez.
| Kapsam | Kimler kullanabilir | Ne zaman seçilmeli | Bağlama kuralı |
|---|---|---|---|
| Organizasyon | Organizasyon genelinde uygun Agent'lar | Prosedür gerçekten şirket çapındaysa, örneğin bir inceleme standardı veya güvenlik kontrol listesi | Aynı organizasyondaki herhangi bir Agent tarafından bağlanabilir |
| Space | O Space ile ilişkili Agent'lar | Sürecin sahibi tek bir ekip veya ürün alanıysa | Bir Agent, o Space'e ait değilse bunu bağlayamaz |
| Agent | Yalnızca bir Agent | Yetenek, tek bir uzmanın rolünü tanımlıyorsa | Oluşturulduğunda veya içe aktarıldığında hedef Agent'ına bağlanır |
Dokümanlardaki pratik kural doğrudur: hedeflenen kitleyle eşleşen en dar kapsamı seçin. Kapsam aynı zamanda bir etki alanıdır. Eskiyen Space kapsamlı bir Skill bir ekibin Agent'larını şaşırtır; Organizasyon kapsamlı olan ise hepsini şaşırtır. Bir dotfiles promptunun kalıcı olarak tek kişilik bir hedef kitlesi vardır. Bir Skill'in hedef kitlesi ise sistemde kayıtlı, bilinçli bir karardır.
Skill'leri Agent'lara bağlama
Bir Skill, bir Agent onu taşıyana kadar hiçbir şey yapmaz. Sharkly'de bir Agent, kaydedilmiş bir çalışma yapılandırmasıdır ve bir Skill bağlamak ona bir yetenek ekler.
İşleyiş basittir. Uygun Skill'leri eklemek veya kaldırmak için Agent'ın Skill ayarlarını kullanın ya da Agent'ı oluştururken Skill'leri seçin. Uygunluk, kapsam kurallarına uyar. Değişiklikler sonraki Agent çalışmalarına uygulanır; bu nedenle bugün eklediğiniz bir bağlama, yürüyen hiçbir şeyi bozmadan yarının işini şekillendirir.
Karar vermeniz gereken nokta, bir Agent'ın kaç Skill taşıması gerektiğidir. Dokümanlar açık sözlüdür: birbiriyle örtüşen çok sayıda Skill bağlamaktan kaçının, çünkü çelişkili veya gereksiz talimatlar yürütmeyi daha az öngörülebilir kılar. İki keskin Skill, birbiriyle tartışan altı Skill'den iyidir. Bir Agent'ın Skill listesi ıvır zıvır çekmecesi gibi görünüyorsa, çalışmaları da öyle olur.
Ayrıca Agent'ın kendi talimatları ile Skill'leri arasında bir iş bölümü vardır. Agent talimatları o tek rol için istikrarlı davranışı taşır: kapsam, ne zaman insan girdisi isteneceği, raporlama biçimi. Birkaç Agent'ın paylaşabileceği yeniden kullanılabilir bir prosedür bir Skill'e aittir. Aynı paragrafı üçüncü bir Agent'ın talimatlarına yapıştırdığınızı fark ederseniz, o paragraf bir Skill olmak ister.
Bağlama, platformun geri kalanını bileşik hale getiren şeydir. İnceleme Skill'inizi taşıyan aynı Agent, Otomasyonlar'ınızın bir zamanlamaya veya durum değişikliğine göre tetiklediği Agent'tır; böylece bir kez yakalanan bir standart, kimsenin elle başlatmadığı yinelenen çalışmalarda ortaya çıkar. Skill'ler ayrıca komut dosyasıyla kullanılabilir: CLI, JSON çıktısıyla birlikte sharkly skill list ve sharkly skill view komutlarını sunar.
Yönetişim: kim düzenler, kim siler, kim inceler
Paylaşılan yetenek, paylaşılan kontrol gerektirir ve Skill'lerin prompt dosyalarından en çok ayrıldığı nokta burasıdır.
Bir Skill, oluşturucusu veya bir Organizasyon Sahibi ya da Yöneticisi tarafından düzenlenebilir veya silinebilir. Space kapsamlı bir Skill ayrıca Space'ine yazma erişimi gerektirir. Agent kapsamlı bir Skill oluşturmak veya içe aktarmak ve bir Agent'ın Skill bağlamalarını değiştirmek, hedef Agent'ı yönetme izni gerektirir. Kimse cuma öğleden sonra inceleme standardını sessizce yeniden yazmaz.
Bakım da aynı tek yer ilkesini izler. Bir süreç değiştiğinde, Skill'in talimatlarını ve destekleyici dosyalarını güncelleyin; sonraki çalışmalar yeni sürümü alır. Silme işlemi yavaşlanması gereken işlemdir: Skill'i onu kullanan her Agent'tan kaldırır, bu nedenle önce mevcut bağlamaları kontrol edin.
Güvenlik kuralları kısa ve tartışmasızdır. Parolaları, erişim belirteçlerini, özel anahtarları veya diğer sırları asla Skill talimatlarında veya destekleyici dosyalarında saklamayın. Kullanmadan önce her harici veya yerel olarak içe aktarılmış Skill'i inceleyin. Komutları ve örnekleri en az yetkili tutun. Bir Agent'ın Space ilişkilerini veya bir Skill'in içeriğini değiştirdikten sonra bağlamaları yeniden kontrol edin, çünkü uygunluk bir bağlama altında değişebilir.
Tüm bunlar boyunca insan-Agent sözleşmesi geçerliliğini korur. Agent'lar Skill'leri yükler, süreci izler ve sonuçları Görev'e döndürür. Hangi Skill'lerin ekip yetkisi taşıyacağına insanlar karar verir. Bir Skill tutarlılık tabanını yükseltir. İnceleyeni ortadan kaldırmaz.
Bir Skill ne zaman oluşturulmamalı
Skill'ler altyapıdır ve altyapının bir taşıma maliyeti vardır. Dürüst karar ikilisi: tek seferlik gereksinimleri Görev açıklamasında veya yorumlarında tutun; aynı yeteneğin gelecekteki çalışmalarda da kullanılabilir olması gerektiğinde bir Skill oluşturun.
Doğru yanıtın Skill olmadığı birkaç durum daha. Bir prosedür yerel bir Runtime'ın Skill dizininde yaşıyorsa ve yalnızca o Computer'ın çalışmaları buna ihtiyaç duyuyorsa, onu yerel bırakın. İki aday Skill aynı Agent üzerinde büyük ölçüde örtüşecekse, ikisini bağlamadan önce birleştirin veya keskinleştirin. Ve açıklama cümlesini yazamıyorsanız, süreç henüz yakalanacak kadar istikrarlı değildir.
Tek bir prosedürle başlayın
Ekibinizin tekrarladığı ve sessizce tek bir kişiye bağımlı olduğu bir prosedür seçin. Bunu tek ve dar bir Skill olarak yazın: bir ad, ne zaman geçerli olduğunu belirten bir açıklama, süreci ve beklenen çıktıyı tanımlayan talimatlar. Kapsamını Space'inize ayarlayın. Onu bir Agent'a bağlayın, o Agent'a gerçek bir Görev atayın ve geri döneni okuyun.
Döngünün tamamı budur. Bir geliştiricinin kafasında yaşayan zanaatın artık bir adı, bir kapsamı, bir sahibi ve güncellenecek tek bir yeri var. Platformda yeniyseniz, Sharkly genel bakışı Skill'lerin Görevler, Agent'lar ve Computer'lar ile nasıl bir arada durduğunu açıklar ve Sharkly ile başlarken ilk bağlantıyı baştan sona adım adım anlatır. Skill dokümantasyonu yukarıdaki tüm kuralları ayrıntılı olarak kapsar.
SSS
Bir Skill ile bir Agent'ın talimatları arasındaki fark nedir?
Agent talimatları bir rol için istikrarlı davranışı tanımlar: kapsamı, ne zaman girdi isteneceği, nasıl raporlanacağı. Bir Skill, birkaç Agent'ın paylaşabileceği, kendi destekleyici dosyaları ve izinleriyle paketlenmiş yeniden kullanılabilir bir prosedürdür. Bir paragraf Agent'lar arasında kopyalanıyorsa, o paragraf bir Skill'e aittir.
Bir Skill'in kapsamını oluşturduktan sonra değiştirebilir miyim?
Hayır. Bir Skill'in kapsamı oluşturulma anında sabitlenir. Hedef kitlenin değişmesi gerektiğinde, doğru kapsamda yeni bir Skill oluşturun ve ona ihtiyaç duyan Agent'ları yeniden bağlayın. Dokümanların baştan hedeflenen kitleyle eşleşen en dar kapsamı seçmeyi önermesinin nedeni budur.
İçe aktarılan Skill'ler kaynaklarıyla senkronize kalır mı?
Hayır. Desteklenen bir genel kaynaktan yüklemek, seçtiğiniz kapsamda yönetilen bir kopya oluşturur; yerel bir Runtime'dan içe aktarmak ise Skill'i organizasyona kopyalar ve özgün yerel kopya ayrı kalır. O andan itibaren organizasyonunuz kendi kopyasını kontrol eder.
Yeni bir Skill bağlamak bir Agent'ın halihazırda çalışan Görevlerini etkiler mi?
Hayır. Bir Agent'ın Skill bağlamalarındaki değişiklikler sonraki Agent çalışmalarına uygulanır. Halihazırda yürüyen iş, başladığı yapılandırma altında tamamlanır ve bir sonraki çalışma güncellenmiş Skill kümesini alır.
Skill'leri genel kaynaklardan yüklemek güvenli mi?
İnceleme yapılırsa güvenli olabilirler. Her harici veya yerel olarak içe aktarılmış Skill'i üçüncü taraf kodu veya yapılandırması olarak ele alın: bağlamadan önce talimatları ve destekleyici dosyaları okuyun, komutları en az yetkili tutun ve bir Skill'e asla sır girmesine izin vermeyin. Sharkly'nin yükleme doğrulaması güvenli olmayan yolları ve arşiv girdilerini reddeder, ancak talimatların ekibinizin güvenini hak edip etmediği kararı insanlara aittir.
