CSC:n laskentaympäristön käyttö LLM-koodausagenttien kanssa

LLM-koodausagentit, kuten Claude Code, Codex ja GitHub Copilot CLI, tuntevat yleiset työkalut kuten Slurm, S3 ja Kubernetes hyvin, mutta eivät CSC:n isäntänimiä, kiintiöitä, laskutusyksiköitä tai paikallisia sääntöjä. Ilman tätä kontekstia ne usein arvaavat uskottavia mutta vääriä arvoja. csc-skills on kokoelma agenttitaitoja, joka antaa agenteille tämän CSC-kohtaisen tiedon tämän käyttöoppaan pohjalta.

Vastuu

Olet aina vastuussa siitä, mitä agenttisi tekee. Jokainen komento, jonka se suorittaa, ajetaan omalla käyttäjätililläsi ja CSC-projektissasi. Lue CSC:n AI-agenttikäytäntö ennen agenttien käyttöä CSC:n järjestelmissä.

Saatavilla olevat taidot

Skill	Palvelu
`csc-roihu`	Roihu -supertietokone: eräajot, SSH-varmenteet, levyalueet, laskutus
`csc-allas`	Allas -objektitallennus
`csc-pouta`	Pouta IaaS-pilvi
`csc-rahti`	Rahti konttipilvi
`csc-satama`	Satama konttikuvarekisteri

Agentti lataa taidon vain silloin, kun pyyntösi koskee kyseistä palvelua, joten niiden kaikkien asentamisesta ei aiheudu mitään kustannusta niiden osalta, joita et käytä.

Mitä taidot antavat agentin tehdä

Taidot auttavat agenttia pääasiassa kirjoittamaan sinulle koodia ja komentoja tarkistettavaksi ja ajettavaksi. Oletusarvoisesti:

Vain luku -tarkastelu (resurssien listaus, kiintiöiden ja käytön tarkistus) tehdään pyynnöstä.
Uusien resurssien, kuten virtuaalikoneen tai eräajon, luominen tehdään vasta sen jälkeen, kun agentti kertoo kustannuksen laskutusyksiköissä (BUs) ja mahdollisen verkkoaltistuksen.
Olemassa olevien resurssien tai datan muuttamista tai poistamista ei koskaan tehdä agentin omasta aloitteesta. Agentti kirjoittaa skriptin ja selittää, mitä se tekee, ja suorittaa sen vasta, kun vahvistat sen nimenomaisesti. Muista, että CSC-projekti on jaettu, joten virheet voivat vaikuttaa kaikkiin sen jäseniin.
Tunnistetietoja ei koskaan kirjoiteta koodiin, lokeihin tai committeihin.

Asentaminen

Repositorio on liitännäisten markkinapaikka, joka sisältää yhden liitännäisen, csc-skills. Asennuksen jälkeen käynnistä uusi agentti-istunto, jotta taidot latautuvat.

Claude Code ja GitHub Copilot CLI

Lisää agentti-istunnon sisällä markkinapaikka ja asenna liitännäinen:

/plugin marketplace add CSCfi/csc-skills
/plugin install csc-skills@csc-skills

Copilot CLI:ssä voit myös suorittaa samat komennot komentotulkista muodossa copilot plugin marketplace add … ja copilot plugin install ….

Codex

Lisää markkinapaikka komentotulkista:

codex plugin marketplace add CSCfi/csc-skills

Avaa sitten liitännäisselain komennolla /plugins Codexissa ja asenna csc-skills.

OpenCode ja muut agentit

Agentit, joissa ei ole liitännäistukea, voivat ladata taidot hakemistosta. Kloonaa repositorio ja linkitä taidot hakemistoon ~/.agents/skills, jota OpenCode ja monet muut agentit käyttävät haussa:

git clone https://github.com/CSCfi/csc-skills.git
mkdir -p ~/.agents/skills
ln -s "$PWD"/csc-skills/skills/csc-* ~/.agents/skills/

Päivitä taidot komennolla git pull kloonatussa repositoriossa.

Roihussa

Roihun agenttiympäristö tarjoaa Claude Coden, Codexin ja OpenCoden valmiiksi määritettyinä HPC-kohtaisilla taidoilla. Voit lisätä siihen csc-skillsin kuten kohdassa Omien taitojen lisääminen kuvataan.

Taitojen käyttö

Kysy agentilta tehtävästä omin sanoin, esimerkiksi "kirjoita eräajo, joka ajaa tämän skriptin yhdellä GPU:lla Roihussa" tai "lataa tulokseni Allas-ämpäriin". Agentti valitsee sopivan taidon automaattisesti.

Kysymyksissä, joita taidot eivät kata, CSC Documentation MCP -palvelin antaa agentin hakea tietoa suoraan tästä käyttöoppaasta.

Palaute ja kontribuutiot ovat tervetulleita GitHub-repositoriossa.