Setiap tim yang telah mengadopsi agen coding AI pasti punya satu developer yang prompt-nya selalu berhasil. Permintaan review mereka kembali dengan struktur yang disukai tim. Instruksi penulisan tes mereka menghasilkan tes yang sesuai gaya internal pada percobaan pertama. Tanya bagaimana caranya, dan jawabannya biasanya berupa file catatan, repo dotfiles, atau paragraf yang mereka tempel ke sesi baru setiap pagi. Keahliannya nyata. Masalahnya ada pada di mana keahlian itu disimpan.
Keahlian prompt yang hanya tersimpan di kepala satu orang tidak bisa diskalakan, tidak bertahan saat cuti, dan tidak muncul di proses agen orang lain. Saat developer itu tidak ada, kualitas menurun. Saat tim berkembang dari satu agen menjadi lima, kelimanya tidak sepakat tentang bagaimana pekerjaan seharusnya dilakukan.
Skills adalah jawaban Sharkly untuk celah tersebut. Skill mengemas instruksi yang dapat digunakan ulang beserta file pendukung untuk pekerjaan Agen, lengkap dengan pemilik, cakupan, dan izin yang eksplisit. Jika Anda ingin memahami konsep umumnya terlebih dahulu, apa itu coding agent Skill membahas definisi dan ekosistem yang lebih luas. Postingan ini membahas alur kerja di dalam Sharkly itu sendiri.
Ringkasan Singkat
Skill di Sharkly mengemas instruksi yang dapat digunakan ulang beserta file pendukung untuk pekerjaan Agen: aturan review, checklist pengiriman, standar penulisan, proses tim. Anda dapat membuatnya dari awal, menginstal Skill yang telah dipublikasikan dari sumber publik yang didukung, mengimpor Skill yang ditemukan oleh Runtime lokal, atau mengunggah file SKILL.md, .skill, atau paket zip. Setiap Skill memiliki tepat satu cakupan, Organization, Space, atau Agent, yang dipilih saat pembuatan dan tidak dapat diubah selamanya. Agen mengikat Skill yang memenuhi syarat melalui pengaturan Skills mereka, perubahan berlaku untuk proses berikutnya, dan hak pengeditan tetap ada pada pembuatnya, Organization Owner, dan Admin. Hasilnya: keahlian prompt tidak lagi hanya tersimpan di dotfiles satu developer dan menjadi infrastruktur tim yang dibagikan serta dikendalikan izinnya.
Apa yang berubah ketika keahlian prompt punya rumah
Perbedaan antara prompt yang baik dan sebuah Skill bukanlah pada teksnya. Melainkan pada segala hal di sekitar teks tersebut.
Prompt di dalam file catatan tidak memiliki pemilik, audiens, maupun siklus hidup. Tidak ada yang tahu keberadaannya, tidak ada yang bisa memastikan apakah salinan yang mereka temukan di Slack masih yang terbaru, dan tidak ada yang bertanggung jawab memperbaruinya saat prosesnya berubah. Skill memiliki ketiganya. Skill dimiliki oleh sebuah organisasi. Cakupannya menyatakan dengan tepat Agen mana yang boleh menggunakannya. Izin pengeditannya menyatakan dengan tepat siapa yang boleh mengubahnya. Ketika prosesnya berubah, Anda memperbarui Skill satu kali saja, dan proses berikutnya dari setiap Agen yang terikat akan mengambil perubahan tersebut.
Itulah tesis leverage dalam bentuk mini. Leverage tim tidak datang dari membuka lebih banyak obrolan AI; melainkan dari berbagi peran, aturan, konteks, dan alur kerja. Dan karena Agen mengembalikan hasilnya ke Task, keluaran dari proses yang dipandu Skill masuk ke catatan bersama tempat tim dapat meninjaunya.
Satu batasan sebelum masuk ke alur kerja. Skill bukanlah persyaratan Task. Simpan kebutuhan sekali pakai di deskripsi atau komentar Task. Jika hanya Task ini yang membutuhkannya, itu adalah konteks. Jika proses bulan depan juga membutuhkannya, itu adalah infrastruktur.
Membuat Skill dari awal
Sebuah Skill dimulai dengan tiga hal: nama, deskripsi, dan instruksi. Pembagian ini lebih penting daripada yang terlihat.
Deskripsi menyatakan kapan Agen harus menggunakan Skill tersebut. Inilah kondisi pemicunya, kalimat yang memberi tahu Agen yang sedang memindai kemampuannya bahwa Skill ini berlaku untuk pekerjaan yang sedang dihadapi. Instruksi mendefinisikan proses yang dapat diulang dan keluaran yang diharapkan: langkah-langkahnya, pemeriksaannya, format hasilnya. Uji yang berguna adalah apakah Anda dapat menyatakan dalam satu kalimat kapan Agen harus menggunakan Skill ini. Jika tidak bisa, kemungkinan besar Anda sedang melihat dua Skill, atau tidak sama sekali.
Di balik layar, instruksi utamanya tersimpan dalam file SKILL.md: field YAML name dan description di bagian atas, diikuti dengan instruksinya. File pendukung dapat menyertainya untuk menyediakan template, contoh, atau data referensi. Skill checklist pengiriman mungkin membawa template checklist-nya; Skill penulisan migrasi mungkin menyertakan dua contoh beranotasi. Jaga agar tetap fokus. Kumpulan file yang besar atau tidak relevan hanya menambah konteks tanpa meningkatkan keputusan Agen.
Mengimpor keahlian yang sudah Anda miliki
Sebagian besar tim tidak memulai dari nol. Keahlian prompt sudah ada; hanya saja tersebar. Sharkly menyediakan tiga jalur impor.
Instal dari sumber publik yang didukung. Sharkly dapat mengambil Skill yang telah dipublikasikan dan membuat salinan terkelola dalam cakupan yang Anda pilih. Salinan terkelola ini penting: Anda tidak menautkan ke file orang lain, melainkan mengambil snapshot yang dikendalikan organisasi Anda. Tinjau sumber dan konten yang diimpor sebelum mengikatnya ke Agen mana pun. Perlakukan instruksi eksternal sebagai kode pihak ketiga, bukan sebagai kebijakan organisasi yang tepercaya.
Impor dari Runtime lokal. Inilah jalur yang dirancang khusus untuk masalah dotfiles. Runtime lokal online dapat melaporkan Skill yang ditemukan di direktori Skill lokalnya, yang berarti keahlian yang selama ini diam-diam dikumpulkan seorang developer menjadi terlihat oleh organisasi. Mengimpor akan menyalin Skill tersebut ke organisasi; salinan lokal aslinya tetap terpisah, sehingga tidak ada bagian dari pengaturan developer tersebut yang rusak. Satu catatan menjaga hal ini tetap jujur: Skill lokal yang tersedia langsung bagi Runtime Agen tidak perlu diikat di produk sama sekali. Impor Skill tersebut ketika ia harus menjadi Skill terkelola yang dapat digunakan ulang dengan cakupan yang eksplisit, bukan sekadar karena keberadaannya.
Unggah paket. Jika Skill tersimpan di repo atau berasal dari kolega, unggah file SKILL.md, file .skill, atau paket zip. Sharkly memvalidasi apa yang masuk: jalur file harus relatif dan tidak boleh keluar dari Skill, serta unggahan dan impor akan menolak jalur tersembunyi atau sensitif, konten biner yang tidak didukung, entri arsip yang tidak aman, jalur duplikat, dan paket yang melebihi batas layanan. Skill adalah instruksi yang akan diikuti Agen; ia layak mendapat pengawasan yang sama seperti dependensi.
Cakupan: menentukan siapa yang dapat menggunakan Skill
Setiap Skill dimiliki oleh sebuah organisasi dan memiliki tepat satu cakupan, yang dipilih saat pembuatan. Cakupan inilah yang menentukan Agen mana yang dapat mengikatnya, dan tidak dapat diubah setelahnya.
| Cakupan | Siapa yang dapat menggunakannya | Pilih ini ketika | Aturan pengikatan |
|---|---|---|---|
| Organization | Agen yang memenuhi syarat di seluruh organisasi | Prosedurnya benar-benar berlaku untuk seluruh perusahaan, seperti standar review atau checklist keamanan | Dapat diikat oleh Agen mana pun di organisasi yang sama |
| Space | Agen yang terkait dengan Space tersebut | Satu tim atau area produk yang memiliki prosesnya | Agen tidak dapat mengikatnya kecuali Agen tersebut termasuk dalam Space itu |
| Agent | Hanya satu Agen | Kemampuan tersebut mendefinisikan peran satu spesialis | Terikat pada Agen targetnya saat dibuat atau diimpor |
Aturan praktis dari dokumentasi adalah yang tepat: pilih cakupan tersempit yang sesuai dengan audiens yang dituju. Cakupan juga merupakan radius dampak. Skill bercakupan Space yang sudah usang membingungkan Agen di satu tim; Skill bercakupan Organization membingungkan semua Agen. Prompt dotfiles memiliki audiens satu orang, selamanya. Audiens sebuah Skill adalah keputusan yang disengaja, tercatat di dalam sistem.
Mengikat Skill ke Agen
Sebuah Skill tidak melakukan apa pun sampai ada Agen yang membawanya. Di Sharkly, sebuah Agent adalah konfigurasi kerja yang tersimpan, dan mengikatkan Skill berarti menambahkan kemampuan padanya.
Mekanismenya sederhana. Gunakan pengaturan Skills pada Agen untuk menambah atau menghapus Skill yang memenuhi syarat, atau pilih Skill saat membuat Agen. Kelayakan mengikuti aturan cakupan. Perubahan berlaku untuk proses Agen berikutnya, jadi pengikatan yang Anda tambahkan hari ini akan membentuk pekerjaan besok tanpa mengganggu apa pun yang sedang berjalan.
Yang perlu dipertimbangkan adalah berapa banyak Skill yang sebaiknya dibawa satu Agen. Dokumentasinya tegas: hindari mengikat banyak Skill yang tumpang tindih, karena instruksi yang bertentangan atau berlebihan membuat eksekusi kurang dapat diprediksi. Dua Skill yang tajam lebih baik daripada enam yang saling berselisih. Jika daftar Skill sebuah Agen terlihat seperti laci serba ada, begitu pula hasil prosesnya.
Ada juga pembagian kerja antara instruksi Agen itu sendiri dengan Skill-nya. Instruksi Agen membawa perilaku stabil untuk satu peran tersebut: cakupan, kapan harus meminta masukan manusia, format pelaporan. Prosedur yang dapat digunakan ulang yang mungkin dibagikan beberapa Agen termasuk dalam Skill. Ketika Anda mendapati diri menempelkan paragraf yang sama ke instruksi Agen ketiga, paragraf itu sebenarnya ingin menjadi Skill.
Pengikatan inilah yang membuat sisa platform menjadi berlipat ganda. Agen yang sama yang membawa Skill review Anda adalah Agen yang dipicu Automations Anda sesuai jadwal atau perubahan status, sehingga standar yang ditangkap sekali akan muncul di proses berulang yang tidak diluncurkan siapa pun secara manual. Skills juga dapat diskripkan: CLI menyediakan sharkly skill list dan sharkly skill view dengan keluaran JSON.
Tata kelola: siapa yang mengedit, menghapus, dan meninjau
Kemampuan bersama membutuhkan kontrol bersama, dan di sinilah Skills paling berbeda dari file prompt.
Sebuah Skill dapat diedit atau dihapus oleh pembuatnya atau Organization Owner maupun Admin. Skill bercakupan Space juga memerlukan akses tulis ke Space tersebut. Membuat atau mengimpor Skill bercakupan Agent, serta mengubah pengikatan Skill pada Agen, memerlukan izin untuk mengelola Agen target. Tidak ada yang diam-diam menulis ulang standar review pada Jumat sore.
Pemeliharaan mengikuti prinsip satu tempat yang sama. Ketika proses berubah, perbarui instruksi dan file pendukung Skill, dan proses berikutnya akan mengambil versi barunya. Penghapusan adalah operasi yang perlu diperlambat: tindakan ini menghapus Skill dari setiap Agen yang menggunakannya, jadi periksa dulu pengikatan yang ada saat ini.
Aturan keamanannya singkat dan tidak bisa ditawar. Jangan pernah menyimpan kata sandi, token akses, kunci privat, atau rahasia lainnya di dalam instruksi atau file pendukung Skill. Tinjau setiap Skill eksternal atau yang diimpor secara lokal sebelum digunakan. Jaga perintah dan contoh tetap dengan hak akses seminimal mungkin. Dan periksa ulang pengikatan setelah mengubah asosiasi Space pada Agen atau isi Skill, karena kelayakan bisa bergeser di bawah suatu pengikatan.
Di sepanjang semua ini, kontrak manusia-agen tetap berlaku. Agen memuat Skill, mengikuti prosesnya, dan mengembalikan hasilnya ke Task. Manusia yang memutuskan Skill mana yang membawa otoritas tim. Sebuah Skill menaikkan standar bawah dalam hal konsistensi. Skill tidak menghilangkan peran peninjau.
Kapan tidak perlu membuat Skill
Skills adalah infrastruktur, dan infrastruktur memiliki biaya pemeliharaan. Pasangan keputusan yang jujur: simpan kebutuhan sekali pakai di deskripsi atau komentar Task; buat Skill ketika kemampuan yang sama harus tersedia di proses-proses berikutnya.
Ada beberapa kasus lain di mana jawaban yang tepat adalah tidak membuat Skill. Jika sebuah prosedur tersimpan di direktori Skill Runtime lokal dan hanya proses di Computer itu yang membutuhkannya, biarkan tetap lokal. Jika dua kandidat Skill akan sangat tumpang tindih pada Agen yang sama, gabungkan atau pertajam keduanya sebelum mengikat salah satunya. Dan jika Anda tidak dapat menulis kalimat deskripsinya, berarti prosesnya belum cukup stabil untuk ditangkap.
Mulai dari satu prosedur
Pilih satu prosedur yang tim Anda ulangi dan diam-diam bergantung pada satu orang. Tuliskan sebagai satu Skill yang sempit: nama, deskripsi yang menyatakan kapan ia berlaku, instruksi yang mendefinisikan proses dan keluaran yang diharapkan. Tetapkan cakupannya ke Space Anda. Ikatkan ke satu Agen, beri Agen itu Task yang nyata, dan baca apa yang kembali.
Itulah keseluruhan siklusnya. Keahlian yang dulu hanya ada di kepala satu developer kini punya nama, cakupan, pemilik, dan satu tempat untuk memperbaruinya. Jika Anda baru mengenal platform ini, ikhtisar Sharkly menjelaskan bagaimana Skills berdampingan dengan Tasks, Agents, dan Computers, dan memulai dengan Sharkly memandu koneksi pertama Anda dari awal hingga akhir. Dokumentasi Skills membahas setiap aturan di atas secara lengkap.
FAQ
Apa perbedaan antara Skill dan instruksi Agen?
Instruksi Agen mendefinisikan perilaku stabil untuk satu peran: cakupannya, kapan harus meminta masukan, bagaimana melaporkan. Skill adalah prosedur yang dapat digunakan ulang yang mungkin dibagikan beberapa Agen, dikemas dengan file pendukung dan izinnya sendiri. Jika sebuah paragraf disalin antar Agen, paragraf itu termasuk dalam sebuah Skill.
Bisakah saya mengubah cakupan Skill setelah membuatnya?
Tidak. Cakupan sebuah Skill ditetapkan saat pembuatan. Ketika audiensnya perlu berubah, buat Skill baru pada cakupan yang tepat dan ikatkan ulang ke Agen yang membutuhkannya. Inilah alasan dokumentasi menyarankan memilih cakupan tersempit yang sesuai dengan audiens yang dituju sejak awal.
Apakah Skill yang diimpor tetap sinkron dengan sumbernya?
Tidak. Menginstal dari sumber publik yang didukung akan membuat salinan terkelola dalam cakupan yang Anda pilih, dan mengimpor dari Runtime lokal akan menyalin Skill ke organisasi sementara salinan lokal aslinya tetap terpisah. Organisasi Anda mengendalikan salinannya sejak saat itu.
Apakah mengikat Skill baru akan memengaruhi Task Agen yang sedang berjalan?
Tidak. Perubahan pada pengikatan Skill sebuah Agen berlaku untuk proses Agen berikutnya. Pekerjaan yang sedang berjalan akan selesai dengan konfigurasi saat ia dimulai, dan proses berikutnya akan mengambil kumpulan Skill yang telah diperbarui.
Apakah Skill aman untuk diinstal dari sumber publik?
Bisa aman, dengan peninjauan. Perlakukan setiap Skill eksternal atau yang diimpor secara lokal sebagai kode atau konfigurasi pihak ketiga: baca instruksi dan file pendukungnya sebelum mengikat, jaga perintah tetap dengan hak akses seminimal mungkin, dan jangan pernah membiarkan rahasia masuk ke dalam Skill. Validasi unggahan Sharkly menolak jalur dan entri arsip yang tidak aman, tetapi penilaian apakah instruksi tersebut layak dipercaya tim Anda tetap berada di tangan manusia.
