Pasang dan urus kemahiran

Panduan ini menunjukkan cara mengisi ruang kerja dengan kemahiran daripada GitHub: tambah repositori sebagai sumber, pasang kemahiran yang anda mahu daripadanya, dan pastikan semuanya terkini dari semasa ke semasa.

Perkara penting yang perlu anda tahu sebelum bermula: repositori sumber tidak dipercayai. Nama, penerangan dan bilangan bintangnya ditulis oleh sesiapa sahaja yang memilikinya. Satu-satunya isyarat keselamatan yang dipercayai oleh Control Center ialah keputusan imbasan antivirus, yang dilalui oleh setiap pemasangan sebelum apa-apa pun sampai ke cakera atau prompt ejen. Jika anda mahukan alasannya, baca bahagian kemahiran dalam model ejen; halaman ini kekal pada praktiknya.

Kemahiran berada di Tetapan → Ruang kerja → Kemahiran (/workspaces/<id>/settings/workspace/skills). Ia berskop ruang kerja: kemahiran yang anda pasang di sini hanya milik ruang kerja ini. Halaman ini mempunyai dua tab: Dipasang (kemahiran setempat, termasuk penyunting Kemahiran baharu) dan Sumber (katalog GitHub). Kedua-dua operasi tulis melalui pintu imbasan yang sama.

Tambah repositori kemahiran

Buka Tetapan → Ruang kerja → Kemahiran dan tukar ke tab Sumber.
Tekan Tambah repositori.
Tampal URL repositori GitHub, contohnya https://github.com/anthropics/skills, dan sahkan.

Pelayan menyemak bahawa repositori itu wujud dan kelihatan dengan kelayakannya, kemudian menambahkannya ke rel kiri. Tiada kedai yang dikurasi di tengah-tengahnya: mana-mana repositori GitHub boleh digunakan, yang juga bermakna reputasinya terpulang kepada anda untuk menilai — bilangan bintang hanyalah bukti, bukan jaminan.

Kemahiran sesuatu repositori ialah direktori yang mengandungi SKILL.md (sehingga tiga peringkat dalam, ditambah susun atur pasaran plugin Claude plugins/<plugin>/skills/<skill>, dengan pokok kebergantungan dan vendor dilangkau). Jika grid kemudian menyatakan repositori itu tiada kemahiran, itulah maksudnya: tiada direktori di dalamnya yang sepadan dengan konvensyen kemahiran.

Periksa kemahiran sebelum memasang

Pilih repositori dalam rel; kemahirannya muncul sebagai grid di sebelah kanan, dengan medan penapis di atasnya yang menyempitkan katalog mengikut nama, penerangan atau slug. Klik kad untuk membuka paparan butiran. Ia menunjukkan tiga perkara:

README, dipaparkan sebagai markdown — README.md direktori kemahiran itu, atau isi SKILL.md apabila tiada README.
Pratonton imbasan — keputusan (pass, warn atau quarantine), keupayaan yang diisytiharkan oleh kandungan kemahiran itu (menjalankan shell, menulis fail, akses rangkaian…) dan setiap penemuan yang direkodkan oleh pengimbas.
Bilangan fail — pemasangan menulis keseluruhan direktori kemahiran itu, bukan hanya SKILL.md-nya.

Pratonton mengimbas bait-bait tepat yang akan ditulis oleh pemasangan, jadi keputusan yang anda lihat ialah keputusan yang akan diterima oleh pemasangan; tiada apa-apa dinilai semula di belakang anda.

Pasang kemahiran

Buka paparan butiran kemahiran itu.
Baca keputusan imbasan. Untuk keputusan warn atau pass, tekan Pasang.
Untuk keputusan quarantine, butang pasang kekal dilumpuhkan sehingga anda tandakan Saya faham risikonya — pasang juga. Pengatasan itu direkodkan, bukan diandaikan.

Pemasangan menulis direktori kemahiran itu ke dalam ruang kerja, merekodkan sematan dalam skills-lock.json (repositori sumber, laluan, commit asalnya dan hash kandungan), lalu kemahiran itu menjadi tersedia kepada ejen dalam ruang kerja tersebut. Kad bertanda Nama sedang digunakan bermakna kemahiran lain sudah memiliki nama itu secara setempat — nyahpasang kemahiran itu dahulu.

Kemas kini kemahiran dari semasa ke semasa

Kad untuk kemahiran yang dipasang membawa lencana: Dipasang, atau Kemas kini tersedia apabila repositori itu sudah melepasi commit yang anda sematkan. Buka paparan butiran dan tekan Kemas kini untuk mengambil semula pada commit baharu. Kemas kini melalui pintu imbasan yang sama seperti pemasangan — kemahiran yang versi baharunya dikuarantin akan ditolak dan versi yang anda miliki kekal tidak berubah. Hash versi lama disimpan sebagai rujukan rollback dalam fail lock itu.

Nyahpasang kemahiran, buang repositori

Nyahpasang (pada paparan butiran kemahiran yang dipasang, atau padam dalam tab Dipasang) membuang direktori kemahiran itu berserta sematannya dalam fail lock sekali gus — kemahiran yang dinyahpasang tidak meninggalkan apa-apa pun.

Membuang repositori dari rel hanya membuang katalognya: kemahiran yang anda pasang daripadanya kekal dipasang dan masih dikemas kini, kerana sematan merekodkan repositori itu mengikut nama dan bukan mengikut rujukan kepada entri sumbernya. Tambah semula repositori itu jika anda mahu melayarinya lagi.

Panggil kemahiran

Kemahiran dipanggil di bawah namespace-nya sendiri, jadi ia tidak pernah bercanggah dengan perintah slash terbina (/plan, /goal, /loop, /compact):

/skill:<name> — kemahiran yang dipasang dalam ruang kerja ini, atau yang dilampirkan pada ejen
/skill:<repo>:<name> — kemahiran yang disertakan oleh repo yang di-checkout dalam ruang ini

Nama bukan terbina tanpa awalan masih tetap dikenali, untuk mesej yang ditulis sebelum namespace itu wujud. /skill:plan itulah yang sampai kepada kemahiran bernama plan; /plan sentiasa terbina.

Kemahiran berskop repositori

Repo yang di-checkout boleh menyertakan kemahirannya sendiri, dalam .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ atau skills/. Semua itu tidak dipasang melalui halaman ini. Ejen hanya membawa kemahiran repo tempat ia sedang bekerja; kemahiran itu bertukar apabila ia berpindah. Penggubah mesej tidak diskop begitu: /skill:<repo>:<name> sampai kepada mana-mana repo dalam ruang itu.

Kemahiran repo melalui imbasan menolak secara lalai yang sama (pass / warn / quarantine) sebelum frontmatter-nya sampai ke prompt. warn diterima; quarantine ditahan, tanpa pengatasan operator pada laluan itu.

Lihat Kemahiran berskop repositori dan Perintah slash.

Panduan berkaitan

Konsep berkaitan

Model ejen