Készségek telepítése és kezelése

Ez az útmutató bemutatja, hogyan töltsön fel egy munkaterületet GitHubról származó készségekkel: adjon hozzá egy tárolót forrásként, telepítse belőle a kívánt készségeket, és tartsa őket naprakészen.

A legfontosabb, amit kezdés előtt tudnia kell: a forrástároló nem megbízható. A nevét, a leírását és a csillagszámát az írja, aki birtokolja. Az egyetlen biztonsági jelzés, amelyben a Control Center megbízik, az antivírus-vizsgálat ítélete, amelyen minden telepítés átmegy, mielőtt bármi eljutna a lemezre vagy egy ügynökpromptba. Ha az indoklásra kíváncsi, olvassa el az ügynökmodell készségekről szóló szakaszát; ez az oldal a gyakorlatnál marad.

A készségek a Beállítások → Munkaterület → Készségek helyen találhatók (/workspaces/<id>/settings/workspace/skills). Munkaterület-hatókörűek: az itt telepített készségek csak ehhez a munkaterülethez tartoznak. Az oldalon két lap van: a Telepítve (helyi készségek, köztük az Új készség szerkesztő) és a Források (GitHub-katalógusok). Mindkét írás ugyanazon a vizsgálati kapun megy át.

Készségtároló hozzáadása

Nyissa meg a Beállítások → Munkaterület → Készségek oldalt, és váltson a Források lapra.
Nyomja meg a Tároló hozzáadása gombot.
Illessze be egy GitHub-tároló URL-jét, például https://github.com/anthropics/skills, és erősítse meg.

A szerver ellenőrzi, hogy a tároló létezik, és a hitelesítő adataival látható-e, majd hozzáadja a bal oldali sávhoz. Nincs középen gondozott tár: bármely GitHub-tároló működik, ami azt is jelenti, hogy a hírnevet Önnek kell megítélnie — a csillagszám bizonyíték, soha nem garancia.

Egy tároló készségei azok a könyvtárak, amelyek SKILL.md fájlt tartalmaznak (legfeljebb három szint mélységig, valamint a Claude plugin-piactéri elrendezés plugins/<plugin>/skills/<skill>, a függőségi és vendor-fákat kihagyva). Ha a rács később azt írja, hogy a tárolóban nincsenek készségek, az pontosan ezt jelenti: egyetlen könyvtár sem felel meg benne a készségkonvenciónak.

Készség megvizsgálása telepítés előtt

Válasszon ki egy tárolót a sávban; a készségei rácsként jelennek meg a jobb oldalon, felette egy szűrőmezővel, amely név, leírás vagy slug szerint szűkíti a katalógust. Kattintson egy kártyára a részletes nézet megnyitásához. A részletes nézet három dolgot mutat:

A README, markdownként megjelenítve — a készségkönyvtár README.md fájlja, vagy a SKILL.md törzse, ha nincs README.
A vizsgálati előnézet — az ítélet (pass, warn vagy quarantine), a készség tartalma által bejelentett képességek (shell futtatása, fájlok írása, hálózati hozzáférés…) és a vizsgáló által rögzített összes megállapítás.
A fájlszám — a telepítés a készség teljes könyvtárát kiírja, nem csak a SKILL.md fájlt.

Az előnézet pontosan azokat a bájtokat vizsgálja, amelyeket a telepítés kiírna, így az Ön által látott ítélet az, amelyet a telepítés kap; semmit nem ítélnek újra a háta mögött.

Készség telepítése

Nyissa meg a készség részletes nézetét.
Olvassa el a vizsgálati ítéletet. warn vagy pass ítélet esetén nyomja meg a Telepítés gombot.
quarantine ítélet esetén a telepítés letiltva marad, amíg be nem jelöli a Megértem a kockázatot — telepítés ennek ellenére lehetőséget. Ezt a felülírást rögzítik, nem feltételezik.

A telepítés beírja a készség könyvtárát a munkaterületre, rögzít egy pint a skills-lock.json fájlban (forrástároló, útvonal, a commit, amelyből származik, és egy tartalomhash), és a készség elérhetővé válik a munkaterület ügynökei számára. Ha egy kártyán A név foglalt felirat szerepel, az azt jelenti, hogy helyben már egy másik készség birtokolja ezt a nevet — először távolítsa el azt.

Készségek naprakészen tartása

A telepített készségek kártyái jelvényeket viselnek: Telepítve, vagy Frissítés elérhető, ha a tároló túllépett a rögzített commiten. Nyissa meg a részletes nézetet, és nyomja meg a Frissítés gombot az új commiton való újralekéréshez. A frissítés ugyanazon a vizsgálati kapun megy át, mint a telepítés — egy olyan készséget, amelynek az új verziója karanténba kerül, elutasítanak, és a meglévő verzió a helyén marad. A régi verzió hashét visszaállítási hivatkozásként megőrzik a lockban.

Készség eltávolítása, tároló eltávolítása

Az Eltávolítás (egy telepített készség részletes nézetében, vagy a Telepítve lapon a törlés) a készség könyvtárát és a lockpinjét együtt távolítja el — egy eltávolított készség nem hagy maga után semmit.

Egy tároló eltávolítása a sávból csak a katalógust távolítja el: az abból telepített készségek telepítve maradnak, és továbbra is frissülnek, mert a pin a tárolót név szerint rögzíti, nem a forrásbejegyzésre való hivatkozással. Adja vissza a tárolót, ha újra böngészni szeretné.

Készség meghívása

A készségeket a saját névterük alatt hívja meg, így soha nem ütköznek a beépített slash-parancsokkal (/plan, /goal, /loop, /compact):

/skill:<name> — egy ebben a munkaterületben telepített vagy az ügynökhöz csatolt készség
/skill:<repo>:<name> — egy a térben checkoutolt repó által szállított készség

A csupasz, nem beépített név továbbra is feloldódik, a névtér megjelenése előtt írt üzenetek esetében. A plan nevű készséget a /skill:plan éri el; a /plan mindig a beépített.

Repóhoz kötött készségek

Egy checkoutolt repó saját készségeket is szállíthat, a .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ vagy skills/ könyvtárban. Ezeket nem ezen az oldalon telepíti. Az ügynök csak annak a repónak a készségeit hordozza, amelyben éppen dolgozik; ezek cserélődnek, amikor továbbáll. A beviteli mező viszont nincs így leszűkítve: a /skill:<repo>:<name> a tér bármely repóját eléri.

A repókészségek ugyanazon a hiba esetén elutasító vizsgálaton esnek át (pass / warn / quarantine), mielőtt a frontmatterjük egy promptba kerülne. A warn beengedett; a quarantine visszatartott, ezen az útvonalon operátori felülírás nélkül.

Lásd a Repóhoz kötött készségek és a Slash-parancsok oldalt.

Kapcsolódó útmutatók

Kapcsolódó fogalmak

Az ügynökmodell