Skip to main content
Skillit ovat uudelleenkäytettäviä ohjepaketteja, joihin voi liittyä valinnaisia tukitiedostoja. Niiden avulla tiimisi voi määrittää toistettavan tavan suorittaa tehtävä kerran ja soveltaa sitä sitten johdonmukaisesti kaikkialla Flowgladissa. Jokaisella Skillillä on nimi, slash-komennon slug, kuvaus ja Markdownilla kirjoitetut ohjeet. Tukitiedostot voivat tarjota lisäkontekstia tai resursseja, joita ohjeiden noudattaminen edellyttää.

​
Käytä Flowgladia tiimisi Skill-kirjastona

Flowglad säilyttää jokaisen Skillin versioituna pakettina. Muutoksen julkaiseminen luo uuden revision sen sijaan, että edellinen paketti korvattaisiin paikallaan. Organisaation adminit voivat avata Skillin History-näkymän tarkastellakseen sen revisioita, vertaillakseen muutoksia, palauttaakseen aiemman revision tai hylätäkseen luonnoksen, kun nämä toiminnot ovat käytettävissä. Näin tiimilläsi on yksi hallittu paikka uudelleenkäytettävien ohjeiden ylläpitoon, ja samalla säilyy tieto siitä, mikä versio oli aktiivinen milläkin hetkellä. Luonnos- ja hylätyt revisiot eivät korvaa aktiivista versiota.

​
Hallitse Skillejä MCP:n kautta

Kun olet yhdistänyt Flowglad MCP -palvelimen, agentti voi tarkastella ja hallita organisaatiosi Skill-kirjastoa puolestasi:
  • skills.list palauttaa yhteydelle näkyvät Skillit.
  • skills.get palauttaa yhden Skillin uusimman ja aktiivisen revision metatiedot.
  • skills.create lähettää uuden Skill-paketin.
  • skills.create_candidate lähettää olemassa olevan Skillin uuden revision.
  • skills.publish_revision varmentaa ja julkaisee lykätyn revision.
  • skills.create_package_upload_session ja skills.finalize_package_upload_session siirtävät paketit, jotka ovat liian suuria lähetettäviksi inline-muodossa.
  • skills.get raportoi hyväksytyn pyynnön varmennuksen ja ylennyksen tuloksen.
Skillien luominen tai päivittäminen edellyttää skills:write-käyttöoikeutta sekä tiimiläisen organisaatiojäsenyydessä että MCP-yhteyden myönnössä. Jos lisäät käyttöoikeuden palvelimen yhdistämisen jälkeen, yhdistä Flowglad MCP uudelleen ja valtuuta skills:write, jotta kirjoitustyökalut tulevat käyttöön. Käyttöoikeudet: Admineilla on oletuksena Skillien laatimisoikeus. Jos haluat antaa Contributorille saman oikeuden, avaa Settings → Team, valitse tiimiläinen ja ota käyttöön Skill Authoring. Tämä antaa oikeuden luoda ja päivittää organisaation Skillejä tekemättä tiimiläisestä adminia.

​
Lataa Flowglad MCP -Skillit agenttiisi

Flowglad MCP -palvelin ilmoittaa io.modelcontextprotocol/skills-ominaisuuden MCP-alustuksen aikana. Tämä kertoo yhteensopiville asiakkaille, että palvelin toteuttaa agentin Skill-metodit skills/list ja skills/get. Jokainen palautettu Skill sisältää skill://-resurssien URI:t ja sisältötiivisteet; asiakkaat voivat noutaa tiedostot metodilla resources/read. Palvelimen yhdistäminen ei takaa, että asiakas kutsuu skills/list-metodia tai asentaa palautetut paketit. Asiakastuki vaihtelee. Lisää käynnistysohje ChatGPT:lle / Codexille tai Claudelle, kun haluat agentin päivittävän Flowglad-rekisterin jokaisen istunnon alussa. MCP-nimeäminen: Nimet ovat tarkoituksella erilaiset. Pisteellinen skills.list on Flowgladin työkalu organisaatiosi versioiduille Skill-tietueille. Kauttaviivallinen skills/list on MCP-protokollan laajennusmetodi agenteille tarkoitettujen Skill-pakettien löytämiseen.

​
Lisää käynnistysohje

Luo kohdehakemisto kerran ennen uuden istunnon aloittamista ja lisää sitten alla oleva vastaava ohjelohko.

​
ChatGPT / Codex

Luo ChatGPT:n / Codexin kohdehakemisto komennolla mkdir -p ~/.agents/skills. Lisää seuraava lohko tiedostoon ~/.codex/AGENTS.md, jotta se koskee jokaista projektia, tai repositorion tiedostoon AGENTS.md, jotta se jaetaan kyseisen repositorion tiimin kanssa.
AGENTS.md

​
Claude

Luo Clauden kohdehakemisto komennolla mkdir -p ~/.claude/skills. Lisää seuraava lohko tiedostoon ~/.claude/CLAUDE.md, jotta se koskee jokaista projektia, tai repositorion tiedostoon CLAUDE.md, jotta se jaetaan kyseisen repositorion tiimin kanssa.
CLAUDE.md
Voit pyytää ChatGPT:tä / Codexia tai Claudea lisäämään sopivan lohkon omaan käyttäjätason ohjetiedostoonsa. Tarkista ehdotettu muokkaus ennen sen hyväksymistä, koska tiedosto vaikuttaa tuleviin istuntoihin. Ohje on parhaan yrityksen periaatteella toimiva agentin bootstrap; jos ympäristösi on päivitettävä Skillit deterministisesti, toteuta sama synkronointi luotetussa SessionStart-hookissa tai MCP-asiakasintegraatiossasi.

​
Missä Skillejä käytetään

Skilleillä on tällä hetkellä kaksi käyttäjää:
  • Yhteensopivat ulkoiset agentit löytävät ja synkronoivat käytössä olevat paketit Flowglad MCP:n kautta ja joko yhdistävät ne automaattisesti tai kutsuvat niitä nimellä.
  • Automaatiot kiinnittävät tarkan julkaistun Skill-revision OWS:n skill-revision-koodiresurssina. Automaatio valitsee paketin polun ja aloituspisteen; agenttivaiheet saavat vain ne Skillit, jotka sinetöity ajon capability-joukko valtuuttaa.
Ensimmäinen polku tarjoaa uudelleenkäytettäviä ohjeita ulkoiselle agentille. Toinen tarjoaa muuttumatonta koodia ja tukitiedostoja toistettavalle Automaation ajolle. Julkaistut Skillit ovat organisaation laajuisia, joten valtuutettu Automaatio voi valita saman Skill-revision missä tahansa Spacessa. Skilliä käyttävä Automaatio ja sen ajot pysyvät oman Spacensa omistamina; Skillin valitseminen ei muuta tätä rajaa.

​
Skillien luominen ja ylläpito

Avaa organisaatiovalikko → Skills → New Skill. Syötä Skill-välilehdellä Name, Slug, valinnainen Description sekä uudelleenkäytettävät ohjeet kenttään Markdown. Käytä Files-välilehteä paketin tukitiedostoille ja valitse sitten Create Skill. Slug koostuu pienistä kirjaimista, numeroista ja yhdysmerkeistä, alkaa kirjaimella tai numerolla, ja käyttäjät kirjoittavat sen merkin / jälkeen. Skillin luominen tai muokkaaminen tuottaa luonnoksen. Skillin tietosivulla muokkaukset tallentuvat automaattisesti; valitse Publish Draft varmentaaksesi ja julkaistaksesi luonnoksen. Jos varmennus epäonnistuu, korjaa luonnos näytetyn diagnostiikan avulla ja julkaise uudelleen. Käytä History-näkymää revisioiden tarkasteluun, korvatun revision palauttamiseen tai muokattavan luonnoksen hylkäämiseen, kun nämä toiminnot ovat käytettävissä. Disable Skill poistaa Skillin ulkoisten agenttien löydettävistä ja Automaatioiden resoluutiosta poistamatta revisiohistoriaa; Enable Skill ottaa sen jälleen käyttöön.

​
Luo tai muokkaa Skilliä MCP:llä

Käytä yhdistettyä ulkoista MCP-asiakasta pakettilähtöiseen laatimiseen. Kutsu skills.get ennen olemassa olevan Skillin muokkaamista. Käytä skills.create-kutsua uudelle paketille tai skills.create_candidate-kutsua revisiolle, joka perustuu nykyiseen aktiiviseen revisioon. Pienet paketit voi toimittaa inline-muodossa. Suuremmille paketeille kutsu skills.create_package_upload_session, lataa pyydetyt objektit ja viimeistele kutsulla skills.finalize_package_upload_session. Jos varmennusta lykättiin, kutsu skills.publish_revision. Kysele skills.get-kutsulla hyväksytyn elinkaaripyynnön tilaa sekä sen varmennuksen tai ylennyksen tulosta. Skillin julkaiseminen ei luo, muokkaa tai aktivoi Automaatiota; käytä Automaation MCP-elinkaarta eksplisiittisesti, kun sellaista tarvitaan.

​
Aloita Skill-mallipohjasta

Skills-sivulla on Skill Templates. Hae tai suodata katalogia, esikatsele mallipohjaa ja valitse Copy Skill. Kopiosta tulee organisaation Skill, jota voi muokata ja julkaista kuten mitä tahansa muuta Skilliä.

​
Skillit ja Automaatiot

Skill määrittää, miten uudelleenkäytettävä työ tehdään. Se ei päätä, milloin työ suoritetaan. Käytä Automaatiota, kun työ on suoritettava manuaalisesti, aikataulun mukaan tai vastauksena tapahtumaan. Automaatio voi kiinnittää yhden tai useamman Skill-revision, jotta samaa toteutusta käytetään uudelleen ajosta toiseen.