Skip to main content
A Skillek utasításokból és opcionális kiegészítő fájlokból álló, újrafelhasználható csomagok. Segítségükkel a csapat egyszer meghatározhatja egy feladat megismételhető elvégzésének módját, majd ezt következetesen alkalmazhatja a Flowglad egészében. Minden Skill rendelkezik névvel, slash-parancs sluggal, leírással és Markdownban írt utasításokkal. A kiegészítő fájlok további kontextust vagy az utasítások követéséhez szükséges erőforrásokat biztosíthatnak.

A Flowglad használata a csapat Skill-könyvtáraként

A Flowglad minden Skillt verziózott csomagként tárol. Egy változtatás közzététele új revíziót hoz létre ahelyett, hogy helyben lecserélné az előző csomagot. A szervezeti adminok megnyithatják egy Skill History nézetét, hogy megvizsgálják a revízióit, összehasonlítsák a változásokat, visszaállítsanak egy korábbi revíziót, vagy elvessenek egy piszkozatot, amikor ezek a műveletek elérhetők. Így a csapat egyetlen, szabályozott helyen tarthatja karban az újrafelhasználható utasításokat, miközben megmarad, hogy adott időpontban melyik verzió volt aktív. A piszkozat és az elutasított revíziók nem cserélik le az aktív verziót.

Skillek kezelése MCP-n keresztül

Miután csatlakoztatta a Flowglad MCP szervert, egy agent az Ön helyett megvizsgálhatja és kezelheti a szervezet Skill-könyvtárát:
  • A skills.list visszaadja a kapcsolat számára látható Skilleket.
  • A skills.get visszaadja egy Skill legutóbbi és aktív revíziójának metaadatait.
  • A skills.create új Skill-csomagot küld be.
  • A skills.create_candidate egy meglévő Skill új revízióját küldi be.
  • A skills.publish_revision ellenőriz és közzétesz egy elhalasztott revíziót.
  • A skills.create_package_upload_session és a skills.finalize_package_upload_session azokat a csomagokat továbbítja, amelyek túl nagyok az inline küldéshez.
  • A skills.get jelenti az elfogadott kérés ellenőrzési és előléptetési eredményét.
A Skillek létrehozásához vagy frissítéséhez a skills:write jogosultság szükséges mind a csapattag szervezeti tagságán, mind az MCP kapcsolat engedélyén. Ha a jogosultságot a szerver csatlakoztatása után adja hozzá, csatlakoztassa újra a Flowglad MCP-t, és engedélyezze a skills:write jogot, hogy az írási eszközök elérhetővé váljanak. Jogosultságok: Az adminok alapértelmezés szerint rendelkeznek Skill-szerkesztési hozzáféréssel. Ha egy Contributornak ugyanezt a hozzáférést szeretné adni, nyissa meg a Settings → Team menüpontot, válassza ki a csapattagot, és kapcsolja be a Skill Authoring beállítást. Ez jogot ad a szervezeti Skillek létrehozására és frissítésére anélkül, hogy a csapattag admin lenne.

Flowglad MCP Skillek betöltése az agentbe

A Flowglad MCP szerver az MCP inicializálás során meghirdeti az io.modelcontextprotocol/skills képességet. Ez jelzi a kompatibilis klienseknek, hogy a szerver implementálja a skills/list és skills/get agent Skill metódusokat. Minden visszaadott Skill tartalmaz skill:// erőforrás-URI-kat és tartalom-digesteket; a kliensek a fájlokat a resources/read segítségével kérhetik le. A szerver csatlakoztatása nem garantálja, hogy a kliens meghívja a skills/list metódust, vagy telepíti a visszaadott csomagokat. A kliensek támogatása eltérő. Adjon hozzá egy indítási utasítást a ChatGPT / Codex vagy a Claude számára, ha azt szeretné, hogy az agent minden munkamenet elején frissítse a Flowglad registryt. MCP elnevezés: A nevek szándékosan eltérnek. A ponttal írt skills.list egy Flowglad eszköz a szervezet verziózott Skill-rekordjaihoz. A perjellel írt skills/list egy MCP protokollbővítési metódus az agentek számára készült Skill-csomagok felderítésére.

Az indítási utasítás hozzáadása

Egy új munkamenet indítása előtt egyszer hozza létre a célkönyvtárat, majd adja hozzá az alábbi megfelelő utasításblokkot.

ChatGPT / Codex

Hozza létre a ChatGPT / Codex célkönyvtárát a mkdir -p ~/.agents/skills paranccsal. Helyezze a következő blokkot a ~/.codex/AGENTS.md fájlba, hogy minden projektre érvényes legyen, vagy egy repository AGENTS.md fájljába, hogy megossza az adott repository csapatával.
AGENTS.md

Claude

Hozza létre a Claude célkönyvtárát a mkdir -p ~/.claude/skills paranccsal. Helyezze a következő blokkot a ~/.claude/CLAUDE.md fájlba, hogy minden projektre érvényes legyen, vagy egy repository CLAUDE.md fájljába, hogy megossza az adott repository csapatával.
CLAUDE.md
Megkérheti a ChatGPT / Codex vagy a Claude agentet, hogy a megfelelő blokkot adja hozzá a saját felhasználói szintű utasításfájljához. Elfogadás előtt tekintse át a javasolt módosítást, mert ez a fájl a jövőbeli munkamenetekre is hatással van. Az utasítás egy legjobb szándékú agent bootstrap; ha a környezetének determinisztikusan kell frissítenie a Skilleket, implementálja ugyanezt a szinkronizálást egy megbízható SessionStart hookban vagy az MCP kliens integrációjában.

Hol használják a Skilleket

A Skilleknek jelenleg két felhasználója van:
  • A kompatibilis külső agentek a Flowglad MCP-n keresztül felderítik és szinkronizálják az engedélyezett csomagokat, majd automatikusan illesztik vagy név szerint hívják meg őket.
  • Az Automationök egy pontos, közzétett Skill-revíziót rögzítenek OWS skill-revision kód-erőforrásként. Az Automation kiválaszt egy csomagútvonalat és belépési pontot; az agent lépések csak a lezárt futási képességkészlet által engedélyezett Skilleket kapják meg.
Az első útvonal újrafelhasználható utasításokat ad egy külső agentnek. A második megváltoztathatatlan kódot és kiegészítő fájlokat ad egy megismételhető Automation-futtatáshoz. A közzétett Skillek az egész szervezetre érvényesek, így egy jogosult Automation bármely Space-ben kiválaszthatja ugyanazt a Skill-revíziót. A felhasználó Automation és a futtatásai továbbra is a saját Space-ükhöz tartoznak; egy Skill kiválasztása nem változtat ezen a határon.

Skillek létrehozása és karbantartása

Nyissa meg az organization menu → Skills → New Skill menüpontot. A Skill lapon adja meg a Name, a Slug, az opcionális Description mezőt, valamint az újrafelhasználható utasításokat a Markdown mezőben. A kiegészítő csomagfájlokhoz használja a Files lapot, majd válassza a Create Skill lehetőséget. A Slug kisbetűket, számokat és kötőjeleket tartalmaz, betűvel vagy számmal kezdődik, és ezt írják be a felhasználók a / után. Egy Skill létrehozása vagy szerkesztése piszkozatot hoz létre. A Skill részletes oldalán a módosítások automatikusan mentésre kerülnek; a piszkozat ellenőrzéséhez és közzétételéhez válassza a Publish Draft lehetőséget. Ha az ellenőrzés sikertelen, a megjelenített diagnosztika alapján javítsa a piszkozatot, és tegye közzé újra. A History segítségével megvizsgálhatja a revíziókat, visszaállíthat egy felülírt revíziót, vagy elvethet egy módosítható piszkozatot, amikor ezek a műveletek elérhetők. A Disable Skill eltávolítja a Skillt a külső agentek felderítéséből és az Automation-feloldásból a revízióelőzmények törlése nélkül; az Enable Skill ismét elérhetővé teszi.

Skill létrehozása vagy szerkesztése MCP-vel

A csomagközpontú szerkesztéshez használjon egy csatlakoztatott külső MCP klienst. Egy meglévő Skill szerkesztése előtt hívja meg a skills.get eszközt. Új csomaghoz használja a skills.create, a jelenlegi aktív revízión alapuló revízióhoz pedig a skills.create_candidate eszközt. A kis csomagok inline is megadhatók. Nagyobb csomagok esetén hívja meg a skills.create_package_upload_session eszközt, töltse fel a kért objektumokat, és fejezze be a skills.finalize_package_upload_session hívással. Ha az ellenőrzés el lett halasztva, hívja meg a skills.publish_revision eszközt. Az elfogadott életciklus-kérést és annak ellenőrzési vagy előléptetési eredményét a skills.get lekérdezésével követheti. Egy Skill közzététele nem hoz létre, nem módosít és nem aktivál Automationt; ha szükség van rá, kifejezetten használja az Automation MCP életciklust.

Kiindulás Skill-sablonból

A Skills oldal tartalmazza a Skill Templates részt. Keressen vagy szűrjön a katalógusban, tekintsen meg előnézetben egy sablont, és válassza a Copy Skill lehetőséget. A másolat szervezeti Skill lesz, amely bármely más Skillhez hasonlóan szerkeszthető és közzétehető.

Skillek és Automationök

Egy Skill azt határozza meg, hogyan kell elvégezni egy újrafelhasználható munkát. Azt nem dönti el, mikor fut az adott munka. Használjon Automationt, ha a munkának manuálisan, ütemezetten vagy egy eseményre reagálva kell futnia. Egy Automation egy vagy több Skill-revíziót rögzíthet, így ugyanaz az implementáció újrahasznosul a futtatások között.